Condividi tramite

az kusto database

  • Sperimentale
  • Riferimento

Nota

Questo riferimento fa parte dell'estensione kusto per l'interfaccia della riga di comando di Azure (versione 2.15.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az kusto database. Altre informazioni sulle estensioni.

Il gruppo di comandi 'kusto' è sperimentale e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Gestire il database con kusto.

Comandi

Nome Descrizione Tipo Status
az kusto database add-principal

Aggiungere autorizzazioni per le entità di database.

 Estensione Sperimentale
az kusto database create

Creare un database.

 Estensione Sperimentale
az kusto database delete

Elimina il database con il nome specificato.

 Estensione Sperimentale
az kusto database list

Restituisce l'elenco dei database del cluster Kusto specificato.

 Estensione Sperimentale
az kusto database list-principal

Restituisce un elenco di entità di database del cluster e del database Kusto specificati.

 Estensione Sperimentale
az kusto database remove-principal

Rimuovere le autorizzazioni delle entità di database.

 Estensione Sperimentale
az kusto database show

Restituisce un database.

 Estensione Sperimentale
az kusto database update

Aggiorna un database.

 Estensione Sperimentale
az kusto database wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione del database kusto.

 Estensione Sperimentale

az kusto database add-principal

Sperimentale

Il gruppo di comandi 'kusto' è sperimentale e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Aggiungere autorizzazioni per le entità di database.

az kusto database add-principal [--cluster-name]
                                [--database-name]
                                [--ids]
                                [--resource-group]
                                [--subscription]
                                [--value]

Esempio

KustoDatabaseAddPrincipals

az kusto database add-principal --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --value name="Some User" type="User" app-id="" email="user@microsoft.com" fqn="aaduser=some_guid" role="Admin" --value name="Kusto" type="Group" app-id="" email="kusto@microsoft.com" fqn="aadgroup=some_guid" role="Viewer" --value name="SomeApp" type="App" app-id="some_guid_app_id" email="" fqn="aadapp=some_guid_app_id" role="Admin" --resource-group "kustorptest"

Parametri facoltativi

--cluster-name

Nome del cluster Kusto.

--database-name

Nome del database nel cluster Kusto.

--ids

Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--value

Elenco di entità di database Kusto.

Utilizzo: --value role=XX name=XX type=XX fqn=XX email=XX app-id=XX

role: obbligatorio. Ruolo dell'entità di database. name: obbligatorio. Nome dell'entità di database. type: obbligatorio. Tipo di entità di database. fqn: nome completo dell'entità di database. email: messaggio di posta elettronica dell'entità di database, se esistente. app-id: ID applicazione pertinente solo per il tipo di entità applicazione.

È possibile specificare più azioni usando più di un argomento --value.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az kusto database create

Sperimentale

Il gruppo di comandi 'kusto' è sperimentale e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Creare un database.

az kusto database create --cluster-name
                         --database-name
                         --resource-group
                         [--no-wait]
                         [--read-only-following-database]
                         [--read-write-database]

Esempio

Creazione o aggiornamento del database Kusto ReadWrite

az kusto database create --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --read-write-database location="westus" soft-delete-period="P1D" --resource-group "kustorptest"

Parametri necessari

--cluster-name

Nome del cluster Kusto.

--database-name

Nome del database nel cluster Kusto.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

Parametri facoltativi

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Valore predefinito: False
--read-only-following-database

Classe che rappresenta un database di sola lettura seguente.

Utilizzo: --read-only-following-database hot-cache-period=XX location=XX kind=XX

hot-cache-period: l'ora in cui i dati devono essere mantenuti nella cache per le query veloci in TimeSpan. location: località della risorsa. kind: Obbligatorio. Tipo di database.

--read-write-database

Classe che rappresenta un database di lettura in scrittura.

Utilizzo: --read-write-database soft-delete-period=XX hot-cache-period=XX location=XX kind=XX

periodo di eliminazione temporanea: l'ora in cui i dati devono essere mantenuti prima dell'interruzione dell'accesso alle query in TimeSpan. hot-cache-period: l'ora in cui i dati devono essere mantenuti nella cache per le query veloci in TimeSpan. location: località della risorsa. kind: Obbligatorio. Tipo di database.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az kusto database delete

Sperimentale

Il gruppo di comandi 'kusto' è sperimentale e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Elimina il database con il nome specificato.

az kusto database delete [--cluster-name]
                         [--database-name]
                         [--ids]
                         [--no-wait]
                         [--resource-group]
                         [--subscription]
                         [--yes]

Esempio

KustoDatabasesDelete

az kusto database delete --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --resource-group "kustorptest"

Parametri facoltativi

--cluster-name

Nome del cluster Kusto.

--database-name

Nome del database nel cluster Kusto.

--ids

Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Valore predefinito: False
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--yes -y

Non richiedere conferma.

Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az kusto database list

Sperimentale

Il gruppo di comandi 'kusto' è sperimentale e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Restituisce l'elenco dei database del cluster Kusto specificato.

az kusto database list --cluster-name
                       --resource-group

Esempio

KustoDatabasesListByCluster

az kusto database list --cluster-name "kustoclusterrptest4" --resource-group "kustorptest"

Parametri necessari

--cluster-name

Nome del cluster Kusto.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az kusto database list-principal

Sperimentale

Il gruppo di comandi 'kusto' è sperimentale e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Restituisce un elenco di entità di database del cluster e del database Kusto specificati.

az kusto database list-principal --cluster-name
                                 --database-name
                                 --resource-group

Esempio

KustoDatabaseListPrincipals

az kusto database list-principal --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --resource-group "kustorptest"

Parametri necessari

--cluster-name

Nome del cluster Kusto.

--database-name

Nome del database nel cluster Kusto.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az kusto database remove-principal

Sperimentale

Il gruppo di comandi 'kusto' è sperimentale e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Rimuovere le autorizzazioni delle entità di database.

az kusto database remove-principal [--cluster-name]
                                   [--database-name]
                                   [--ids]
                                   [--resource-group]
                                   [--subscription]
                                   [--value]

Esempio

KustoDatabaseRemovePrincipals

az kusto database remove-principal --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --value name="Some User" type="User" app-id="" email="user@microsoft.com" fqn="aaduser=some_guid" role="Admin" --value name="Kusto" type="Group" app-id="" email="kusto@microsoft.com" fqn="aadgroup=some_guid" role="Viewer" --value name="SomeApp" type="App" app-id="some_guid_app_id" email="" fqn="aadapp=some_guid_app_id" role="Admin" --resource-group "kustorptest"

Parametri facoltativi

--cluster-name

Nome del cluster Kusto.

--database-name

Nome del database nel cluster Kusto.

--ids

Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--value

Elenco di entità di database Kusto.

Utilizzo: --value role=XX name=XX type=XX fqn=XX email=XX app-id=XX

role: obbligatorio. Ruolo dell'entità di database. name: obbligatorio. Nome dell'entità di database. type: obbligatorio. Tipo di entità di database. fqn: nome completo dell'entità di database. email: messaggio di posta elettronica dell'entità di database, se esistente. app-id: ID applicazione pertinente solo per il tipo di entità applicazione.

È possibile specificare più azioni usando più di un argomento --value.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az kusto database show

Sperimentale

Il gruppo di comandi 'kusto' è sperimentale e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Restituisce un database.

az kusto database show [--cluster-name]
                       [--database-name]
                       [--ids]
                       [--resource-group]
                       [--subscription]

Esempio

KustoDatabasesGet

az kusto database show --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --resource-group "kustorptest"

Parametri facoltativi

--cluster-name

Nome del cluster Kusto.

--database-name

Nome del database nel cluster Kusto.

--ids

Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az kusto database update

Sperimentale

Il gruppo di comandi 'kusto' è sperimentale e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Aggiorna un database.

az kusto database update [--cluster-name]
                         [--database-name]
                         [--ids]
                         [--no-wait]
                         [--read-only-following-database]
                         [--read-write-database]
                         [--resource-group]
                         [--subscription]

Esempio

Creazione o aggiornamento del database Kusto ReadWrite

az kusto database update --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --read-write-database location="westus" soft-delete-period="P1D" --resource-group "kustorptest"

Parametri facoltativi

--cluster-name

Nome del cluster Kusto.

--database-name

Nome del database nel cluster Kusto.

--ids

Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Valore predefinito: False
--read-only-following-database

Classe che rappresenta un database di sola lettura seguente.

Utilizzo: --read-only-following-database hot-cache-period=XX location=XX kind=XX

hot-cache-period: l'ora in cui i dati devono essere mantenuti nella cache per le query veloci in TimeSpan. location: località della risorsa. kind: Obbligatorio. Tipo di database.

--read-write-database

Classe che rappresenta un database di lettura in scrittura.

Utilizzo: --read-write-database soft-delete-period=XX hot-cache-period=XX location=XX kind=XX

periodo di eliminazione temporanea: l'ora in cui i dati devono essere mantenuti prima dell'interruzione dell'accesso alle query in TimeSpan. hot-cache-period: l'ora in cui i dati devono essere mantenuti nella cache per le query veloci in TimeSpan. location: località della risorsa. kind: Obbligatorio. Tipo di database.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az kusto database wait

Sperimentale

Il gruppo di comandi 'kusto' è sperimentale e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione del database kusto.

az kusto database wait [--cluster-name]
                       [--created]
                       [--custom]
                       [--database-name]
                       [--deleted]
                       [--exists]
                       [--ids]
                       [--interval]
                       [--resource-group]
                       [--subscription]
                       [--timeout]
                       [--updated]

Esempio

Sospendere l'esecuzione della riga successiva dello script dell'interfaccia della riga di comando fino a quando il database kusto non viene creato correttamente.

az kusto database wait --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --resource-group "kustorptest" --created

Sospendere l'esecuzione della riga successiva dello script dell'interfaccia della riga di comando fino a quando il database kusto non viene aggiornato correttamente.

az kusto database wait --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --resource-group "kustorptest" --updated

Sospendere l'esecuzione della riga successiva dello script dell'interfaccia della riga di comando fino a quando il database kusto non viene eliminato correttamente.

az kusto database wait --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --resource-group "kustorptest" --deleted

Parametri facoltativi

--cluster-name

Nome del cluster Kusto.

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

Valore predefinito: False
--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--database-name

Nome del database nel cluster Kusto.

--deleted

Attendere l'eliminazione.

Valore predefinito: False
--exists

Attendere che la risorsa esista.

Valore predefinito: False
--ids

Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--interval

Intervallo di polling in secondi.

Valore predefinito: 30
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--timeout

Attesa massima in secondi.

Valore predefinito: 3600
--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.