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
Der Name des Kusto-Clusters.
Der Name der Datenbank im Kusto-Cluster.
Der Name des Kusto-Datenbankskripts.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Optionale Parameter
Flag, das angibt, ob ein Befehl fehlschlägt.
Eine eindeutige Zeichenfolge. Wenn das Skript geändert wird, wird das Skript erneut angewendet.
Nicht auf den Abschluss lang andauernder Vorgänge warten
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.
Die URL zur KQL-Skript-Blobdatei. Darf nicht zusammen mit der scriptContent-Eigenschaft verwendet werden.
Das SaS-Token, das Lesezugriff auf die Datei bereitstellt, die das Skript enthält. Muss angegeben werden, wenn die ScriptUrl-Eigenschaft verwendet wird.
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
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
Der Name des Kusto-Clusters.
Der Name der Datenbank im Kusto-Cluster.
Der Name des Kusto-Datenbankskripts.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Optionale Parameter
Nicht auf den Abschluss lang andauernder Vorgänge warten
Nicht zur Bestätigung auffordern
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
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
Der Name des Kusto-Clusters.
Der Name der Datenbank im Kusto-Cluster.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
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
Der Name des Kusto-Clusters.
Der Name der Datenbank im Kusto-Cluster.
Der Name des Kusto-Datenbankskripts.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
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
Der Name des Kusto-Clusters.
Der Name der Datenbank im Kusto-Cluster.
Der Name des Kusto-Datenbankskripts.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Optionale Parameter
Flag, das angibt, ob ein Befehl fehlschlägt.
Eine eindeutige Zeichenfolge. Wenn das Skript geändert wird, wird das Skript erneut angewendet.
Nicht auf den Abschluss lang andauernder Vorgänge warten
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.
Die URL zur KQL-Skript-Blobdatei. Darf nicht zusammen mit der scriptContent-Eigenschaft verwendet werden.
Das SaS-Token, das Lesezugriff auf die Datei bereitstellt, die das Skript enthält. Muss angegeben werden, wenn die ScriptUrl-Eigenschaft verwendet wird.
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
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
Der Name des Kusto-Clusters.
Der Name der Datenbank im Kusto-Cluster.
Der Name des Kusto-Datenbankskripts.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Optionale Parameter
Warten Sie, bis Sie mit "provisioningState" unter "Erfolgreich" erstellt wurden.
Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Warten Sie, bis sie gelöscht wurde.
Warten Sie, bis die Ressource vorhanden ist.
Abfrageintervall in Sekunden.
Maximale Wartezeit in Sekunden.
Warten Sie, bis die Aktualisierung mit provisioningState unter "Erfolgreich" ausgeführt wurde.
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
Feedback
Feedback senden und anzeigen für