Freigeben über


az cosmosdb sql database

Note

Diese Befehlsgruppe verfügt über Befehle, die sowohl in Azure CLI als auch in mindestens einer Erweiterung definiert sind. Installieren Sie jede Erweiterung, um von ihren erweiterten Funktionen zu profitieren. Erfahren Sie mehr über Erweiterungen.

Verwalten von Azure Cosmos DB SQL-Datenbanken.

Befehle

Name Beschreibung Typ Status
az cosmosdb sql database create

Erstellen Sie eine SQL-Datenbank unter einem Azure Cosmos DB-Konto.

Core GA
az cosmosdb sql database delete

Löschen Sie die SQL-Datenbank unter einem Azure Cosmos DB-Konto.

Core GA
az cosmosdb sql database exists

Überprüft, ob eine Azure Cosmos DB SQL-Datenbank vorhanden ist.

Core GA
az cosmosdb sql database list

Auflisten der SQL-Datenbanken unter einem Azure Cosmos DB-Konto.

Core GA
az cosmosdb sql database merge

Verbinden Sie die Partitionen einer SQL-Datenbank.

Extension Preview
az cosmosdb sql database restore

Wiederherstellen einer gelöschten SQL-Datenbank innerhalb desselben Kontos.

Core GA
az cosmosdb sql database restore (cosmosdb-preview Erweiterung)

Wiederherstellen einer gelöschten SQL-Datenbank innerhalb desselben Kontos.

Extension Preview
az cosmosdb sql database show

Zeigen Sie die Details einer SQL-Datenbank unter einem Azure Cosmos DB-Konto an.

Core GA
az cosmosdb sql database throughput

Verwalten Des Durchsatzes der SQL-Datenbank unter einem Azure Cosmos DB-Konto.

Core GA
az cosmosdb sql database throughput migrate

Migrieren Sie den Durchsatz der SQL-Datenbank zwischen autoskaliert und manuell bereitgestellt.

Core GA
az cosmosdb sql database throughput show

Rufen Sie den Durchsatz der SQL-Datenbank unter einem Azure Cosmos DB-Konto ab.

Core GA
az cosmosdb sql database throughput update

Aktualisieren Sie den Durchsatz der SQL-Datenbank unter einem Azure Cosmos DB-Konto.

Core GA

az cosmosdb sql database create

Erstellen Sie eine SQL-Datenbank unter einem Azure Cosmos DB-Konto.

az cosmosdb sql database create --account-name
                                --name
                                --resource-group
                                [--max-throughput]
                                [--throughput]

Erforderliche Parameter

--account-name -a

Cosmosdb-Kontoname.

--name -n

Datenbankname.

--resource-group -g

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--max-throughput

Die maximale Durchsatzressource kann auf (RU/s) skaliert werden. Wird bereitgestellt, wenn die Ressource automatisch skaliert ist. Der Mindestwert kann 4000 (RU/s) sein.

--throughput

Der Durchsatz der SQL-Datenbank (RU/s). Der Standardwert ist 400.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az cosmosdb sql database delete

Löschen Sie die SQL-Datenbank unter einem Azure Cosmos DB-Konto.

az cosmosdb sql database delete --account-name
                                --name
                                --resource-group
                                [--yes]

Erforderliche Parameter

--account-name -a

Cosmosdb-Kontoname.

--name -n

Datenbankname.

--resource-group -g

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--yes -y

Zur Bestätigung nicht auffordern.

Eigenschaft Wert
Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az cosmosdb sql database exists

Überprüft, ob eine Azure Cosmos DB SQL-Datenbank vorhanden ist.

az cosmosdb sql database exists --account-name
                                --name
                                --resource-group

Erforderliche Parameter

--account-name -a

Cosmosdb-Kontoname.

--name -n

Datenbankname.

--resource-group -g

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az cosmosdb sql database list

Auflisten der SQL-Datenbanken unter einem Azure Cosmos DB-Konto.

az cosmosdb sql database list --account-name
                              --resource-group

Beispiele

Auflisten der SQL-Datenbanken unter einem Azure Cosmos DB-Konto (automatisch generiert)

az cosmosdb sql database list --account-name MyAccount --resource-group MyResourceGroup

Erforderliche Parameter

--account-name -a

Cosmosdb-Kontoname.

--resource-group -g

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az cosmosdb sql database merge

Vorschau

Dieser Befehl befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Verbinden Sie die Partitionen einer SQL-Datenbank.

az cosmosdb sql database merge --account-name
                               --name
                               --resource-group

Beispiele

Zusammenführen von Partitionen der Datenbank "Datenbank my-database"

az cosmosdb sql database merge -g my-resource-group -a my-account --name my-database

Erforderliche Parameter

--account-name -a

Name des CosmosDB-Datenbankkontos.

--name -n

Name des CosmosDB-Datenbanknamens.

--resource-group -g

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az cosmosdb sql database restore

Wiederherstellen einer gelöschten SQL-Datenbank innerhalb desselben Kontos.

az cosmosdb sql database restore --account-name
                                 --name
                                 --resource-group
                                 [--disable-ttl]
                                 [--restore-timestamp]

Beispiele

Wiederherstellen einer gelöschten SQL-Datenbank innerhalb desselben Kontos.

az cosmosdb sql database restore --resource-group resource_group --account-name database_account_name --name name_of_database_needs_to_be_restored --restore-timestamp 2020-07-13T16:03:41+0000

Erforderliche Parameter

--account-name -a

Cosmosdb-Kontoname.

--name -n

Datenbankname.

--resource-group -g

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--disable-ttl

Flag zum Wiederherstellen mit deaktivierter TTL.

Verwendung: --disable-ttl True Default: false.

--restore-timestamp -t

Der Zeitstempel, in den die Datenbank wiederhergestellt werden muss.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az cosmosdb sql database restore (cosmosdb-preview Erweiterung)

Vorschau

Dieser Befehl befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Wiederherstellen einer gelöschten SQL-Datenbank innerhalb desselben Kontos.

az cosmosdb sql database restore --account-name
                                 --name
                                 --resource-group
                                 [--disable-ttl {false, true}]
                                 [--restore-timestamp]

Beispiele

Wiederherstellen einer gelöschten SQL-Datenbank innerhalb desselben Kontos.

az cosmosdb sql database restore --resource-group resource_group --account-name database_account_name --name name_of_database_needs_to_be_restored --restore-timestamp 2020-07-13T16:03:41+0000

Erforderliche Parameter

--account-name -a

Cosmosdb-Kontoname.

--name -n

Datenbankname.

--resource-group -g

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--disable-ttl
Vorschau

Aktivieren oder deaktivieren Sie die Wiederherstellung mit deaktivierter ttl.

Eigenschaft Wert
Zulässige Werte: false, true
--restore-timestamp -t

Der Zeitstempel, in den die Datenbank wiederhergestellt werden muss.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az cosmosdb sql database show

Zeigen Sie die Details einer SQL-Datenbank unter einem Azure Cosmos DB-Konto an.

az cosmosdb sql database show --account-name
                              --name
                              --resource-group

Erforderliche Parameter

--account-name -a

Cosmosdb-Kontoname.

--name -n

Datenbankname.

--resource-group -g

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False