Feedback

az kusto database

  • Referenz

Verwalten von Azure Kusto-Datenbanken

Azure CLI-Befehle für Kusto sind jetzt eine Erweiterung. Führen Sie "az extension add -n kusto" aus, um die Erweiterung zu installieren. Das ursprüngliche Kernmodul für Kusto wird nicht mehr unterstützt.

Befehle

az kusto database add-principal

Hinzufügen von Datenbankprinzipalberechtigungen
az kusto database create

Erstellen Sie eine Kusto-Datenbank.
az kusto database delete

Löschen einer Kusto-Datenbank.
az kusto database list

Listet eine Kusto-Datenbank auf.
az kusto database list-principal

Gibt eine Liste der Datenbankprinzipale des angegebenen Kusto-Clusters und der Datenbank zurück.
az kusto database remove-principal

Entfernen von Datenbankprinzipalberechtigungen.
az kusto database show

Rufen Sie eine Kusto-Datenbank ab.
az kusto database update

Aktualisieren einer Kusto-Datenbank.
az kusto database wait

Warten Sie, bis eine verwaltete Kusto-Datenbank einen gewünschten Zustand erreicht.

az kusto database add-principal

Hinzufügen von Datenbankprinzipalberechtigungen

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

Beispiele

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"

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.

Optionale Parameter

--value

Die Liste der Kusto-Datenbankprinzipale.

az kusto database create

Bearbeiten

Erstellen Sie eine Kusto-Datenbank.

az kusto database create --cluster-name
                         --name
                         --resource-group
                         [--hot-cache-period]
                         [--no-wait]
                         [--soft-delete-period]

Beispiele

erstellen Sie eine Kusto-Datenbank.

az kusto database create --cluster-name myclustername -g myrgname -n mydbname  --soft-delete-period P365D --hot-cache-period P31D

Erforderliche Parameter

--cluster-name

Der Name des Clusters.

--name -n

Der Name der Datenbank.

--resource-group -g

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

Optionale Parameter

--hot-cache-period

Die Zeit, zu der Daten im Cache aufbewahrt werden sollen. Dauer im ISO8601-Format (z. B. 100 Tage wäre P100D).

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--soft-delete-period

Der Zeitraum, in dem die Daten beibehalten werden sollen, damit sie für Abfragen verfügbar sind. Dauer im ISO8601-Format (z. B. 100 Tage wäre P100D).

az kusto database delete

Bearbeiten

Löschen einer Kusto-Datenbank.

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

Optionale Parameter

--cluster-name

Der Name des Clusters.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Der Name der Datenbank.

--resource-group -g

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

--yes -y

Nicht zur Bestätigung auffordern

az kusto database list

Bearbeiten

Listet eine Kusto-Datenbank auf.

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

Beispiele

Listet eine Kusto-Datenbank auf. (automatisch generiert)

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

Erforderliche Parameter

--cluster-name

Der Name des Clusters.

--resource-group -g

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

az kusto database list-principal

Gibt eine Liste der Datenbankprinzipale des angegebenen Kusto-Clusters und der Datenbank zurück.

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

Beispiele

KustoDatabaseListPrincipals

az kusto database list-principal --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 database remove-principal

Entfernen von Datenbankprinzipalberechtigungen.

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

Beispiele

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"

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.

Optionale Parameter

--value

Die Liste der Kusto-Datenbankprinzipale.

az kusto database show

Bearbeiten

Rufen Sie eine Kusto-Datenbank ab.

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

Beispiele

Rufen Sie eine Kusto-Datenbank ab. (automatisch generiert)

az kusto database show --cluster-name MyCluster --name MyDatabase --resource-group MyResourceGroup

Optionale Parameter

--cluster-name

Der Name des Clusters.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Der Name der Datenbank.

--resource-group -g

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

az kusto database update

Bearbeiten

Aktualisieren einer Kusto-Datenbank.

az kusto database update --soft-delete-period
                         [--add]
                         [--cluster-name]
                         [--force-string]
                         [--hot-cache-period]
                         [--ids]
                         [--name]
                         [--no-wait]
                         [--remove]
                         [--resource-group]
                         [--set]

Beispiele

erstellen Sie eine Kusto-Datenbank.

az kusto database update --cluster-name myclustername -g myrgname -n mydbname  --soft-delete-period P365D --hot-cache-period P30D

Erforderliche Parameter

--soft-delete-period

Der Zeitraum, in dem die Daten beibehalten werden sollen, damit sie für Abfragen verfügbar sind. Dauer im ISO8601-Format (z. B. 100 Tage wäre P100D).

Optionale Parameter

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

--cluster-name

Der Name des Clusters.

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

--hot-cache-period

Die Zeit, zu der Daten im Cache aufbewahrt werden sollen. Dauer im ISO8601-Format (z. B. 100 Tage wäre P100D).

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Der Name der Datenbank.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--remove

Entfernen einer Eigenschaft oder eines Elements aus einer Liste. Beispiel: --remove property.list OR --remove propertyToRemove.

--resource-group -g

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

--set

Aktualisieren Sie ein Objekt, indem Sie einen Eigenschaftspfad und einen festzulegenden Wert angeben. Beispiel: --set property1.property2=.

az kusto database wait

Bearbeiten

Warten Sie, bis eine verwaltete Kusto-Datenbank einen gewünschten Zustand erreicht.

Wenn ein Vorgang in einer Datenbank unterbrochen oder mit --no-waitgestartet wurde, verwenden Sie diesen Befehl, um auf den Abschluss zu warten.

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

Optionale Parameter

--cluster-name

Der Name des Clusters.

--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.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--interval

Abfrageintervall in Sekunden.

Standardwert: 30
--name -n

Der Name der Datenbank.

--resource-group -g

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

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

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