az kusto script

Hinweis

Diese Referenz ist Teil der Kusto-Erweiterung für die Azure CLI (Version 2.15.0 oder höher). Die Erweiterung installiert automatisch beim ersten Ausführen eines Az kusto-Skriptbefehls . Weitere Informationen zu Erweiterungen

Verwalten von Skripts mit kusto.

Befehle

az kusto script create

Erstellt ein Kusto-Datenbankskript.

az kusto script delete

Löscht ein Kusto principalAssignment.

az kusto script list

Gibt die Liste der Datenbankskripts für die angegebene Datenbank zurück.

az kusto script show

Ruft ein Kusto-Clusterdatenbankskript ab.

az kusto script update

Aktualisierungen ein Datenbankskript.

az kusto script wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung des Kusto-Skripts erfüllt ist.

az kusto script create

Erstellt ein Kusto-Datenbankskript.

az kusto script create --cluster-name
                       --database-name
                       --name
                       --resource-group
                       [--continue-on-errors {false, true}]
                       [--force-update-tag]
                       [--no-wait]
                       [--script-content]
                       [--script-url]
                       [--script-url-sas-token]

Beispiele

KustoScriptsCreateOrUpdate

az kusto script create --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --continue-on-errors true --force-update-tag "2bcf3c21-ffd1-4444-b9dd-e52e00ee53fe" --script-url "https://mysa.blob.core.windows.net/container/script.txt" --script-url-sas-token "?sv=2019-02-02&st=2019-04-29T22%3A18%3A26Z&se=2019-04-30T02%3A23%3A26Z&sr=b&sp=rw&sip=168.1.5.60-168.1.5.70&spr=https&sig=********************************" --resource-group "kustorptest" --name "kustoScript1"

Erforderliche Parameter

--cluster-name

Der Name des Kusto-Clusters.

--database-name

Der Name der Datenbank im Kusto-Cluster.

--name --script-name -n

Der Name des Kusto-Datenbankskripts.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--continue-on-errors

Flag, das angibt, ob ein Befehl fehlschlägt.

Zulässige Werte: false, true
--force-update-tag

Eine eindeutige Zeichenfolge. Wenn das Skript geändert wird, wird das Skript erneut angewendet.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--script-content

Der Skriptinhalt. Diese Eigenschaft sollte verwendet werden, wenn das Skript inline und nicht über die Datei in einer SA bereitgestellt wird. Darf nicht zusammen mit scriptUrl- und scriptUrlSasToken-Eigenschaften verwendet werden.

--script-url

Die URL zur KQL-Skript-Blobdatei. Darf nicht zusammen mit der scriptContent-Eigenschaft verwendet werden.

--script-url-sas-token

Das SaS-Token, das Lesezugriff auf die Datei bereitstellt, die das Skript enthält. Muss angegeben werden, wenn die ScriptUrl-Eigenschaft verwendet wird.

az kusto script delete

Löscht ein Kusto principalAssignment.

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

Beispiele

KustoScriptsDelete

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

Erforderliche Parameter

--cluster-name

Der Name des Kusto-Clusters.

--database-name

Der Name der Datenbank im Kusto-Cluster.

--name --script-name -n

Der Name des Kusto-Datenbankskripts.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--yes -y

Nicht zur Bestätigung auffordern

az kusto script list

Gibt die Liste der Datenbankskripts für die angegebene Datenbank zurück.

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

Beispiele

KustoScriptsList

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

Erforderliche Parameter

--cluster-name

Der Name des Kusto-Clusters.

--database-name

Der Name der Datenbank im Kusto-Cluster.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az kusto script show

Ruft ein Kusto-Clusterdatenbankskript ab.

az kusto script show --cluster-name
                     --database-name
                     --name
                     --resource-group

Beispiele

KustoScriptsGet

az kusto script show --cluster-name "kustoclusterrptest4" --database-name "Kustodatabase8" --resource-group "kustorptest" --name "kustoScript1"

Erforderliche Parameter

--cluster-name

Der Name des Kusto-Clusters.

--database-name

Der Name der Datenbank im Kusto-Cluster.

--name --script-name -n

Der Name des Kusto-Datenbankskripts.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az kusto script update

Aktualisierungen ein Datenbankskript.

az kusto script update --cluster-name
                       --database-name
                       --name
                       --resource-group
                       [--continue-on-errors {false, true}]
                       [--force-update-tag]
                       [--no-wait]
                       [--script-content]
                       [--script-url]
                       [--script-url-sas-token]

Beispiele

KustoScriptsUpdate

az kusto script update --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --continue-on-errors true --force-update-tag "2bcf3c21-ffd1-4444-b9dd-e52e00ee53fe" --script-url "https://mysa.blob.core.windows.net/container/script.txt" --script-url-sas-token "?sv=2019-02-02&st=2019-04-29T22%3A18%3A26Z&se=2019-04-30T02%3A23%3A26Z&sr=b&sp=rw&sip=168.1.5.60-168.1.5.70&spr=https&sig=********************************" --resource-group "kustorptest" --name "kustoScript1"

Erforderliche Parameter

--cluster-name

Der Name des Kusto-Clusters.

--database-name

Der Name der Datenbank im Kusto-Cluster.

--name --script-name -n

Der Name des Kusto-Datenbankskripts.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--continue-on-errors

Flag, das angibt, ob ein Befehl fehlschlägt.

Zulässige Werte: false, true
--force-update-tag

Eine eindeutige Zeichenfolge. Wenn das Skript geändert wird, wird das Skript erneut angewendet.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--script-content

Der Skriptinhalt. Diese Eigenschaft sollte verwendet werden, wenn das Skript inline und nicht über die Datei in einer SA bereitgestellt wird. Darf nicht zusammen mit scriptUrl- und scriptUrlSasToken-Eigenschaften verwendet werden.

--script-url

Die URL zur KQL-Skript-Blobdatei. Darf nicht zusammen mit der scriptContent-Eigenschaft verwendet werden.

--script-url-sas-token

Das SaS-Token, das Lesezugriff auf die Datei bereitstellt, die das Skript enthält. Muss angegeben werden, wenn die ScriptUrl-Eigenschaft verwendet wird.

az kusto script wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung des Kusto-Skripts erfüllt ist.

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

Beispiele

Anhalten der Ausführung der nächsten Zeile des CLI-Skripts, bis das Kusto-Skript erfolgreich erstellt wurde.

az kusto script wait --cluster-name "kustoclusterrptest4" --database-name "Kustodatabase8" --resource-group "kustorptest" --name "kustoScript1" --created

Anhalten der Ausführung der nächsten Zeile des CLI-Skripts, bis das Kusto-Skript erfolgreich aktualisiert wird.

az kusto script wait --cluster-name "kustoclusterrptest4" --database-name "Kustodatabase8" --resource-group "kustorptest" --name "kustoScript1" --updated

Anhalten der Ausführung der nächsten Zeile des CLI-Skripts, bis das Kusto-Skript erfolgreich gelöscht wird.

az kusto script wait --cluster-name "kustoclusterrptest4" --database-name "Kustodatabase8" --resource-group "kustorptest" --name "kustoScript1" --deleted

Erforderliche Parameter

--cluster-name

Der Name des Kusto-Clusters.

--database-name

Der Name der Datenbank im Kusto-Cluster.

--name --script-name -n

Der Name des Kusto-Datenbankskripts.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--created

Warten Sie, bis Sie mit "provisioningState" unter "Erfolgreich" erstellt wurden.

--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Warten Sie, bis sie gelöscht wurde.

--exists

Warten Sie, bis die Ressource vorhanden ist.

--interval

Abfrageintervall in Sekunden.

Standardwert: 30
--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

Warten Sie, bis die Aktualisierung mit provisioningState unter "Erfolgreich" ausgeführt wurde.