Partager via

az cosmosdb sql database

Note

Ce groupe de commandes a des commandes définies dans Azure CLI et au moins une extension. Installez chaque extension pour bénéficier de ses fonctionnalités étendues. Apprenez-en davantage sur les extensions.

Gérer les bases de données SQL Azure Cosmos DB.

Commandes

Nom Description Type État
az cosmosdb sql database create

Créez une base de données SQL sous un compte Azure Cosmos DB.

 Core GA
az cosmosdb sql database delete

Supprimez la base de données SQL sous un compte Azure Cosmos DB.

 Core GA
az cosmosdb sql database exists

Vérifie si une base de données SQL Azure Cosmos DB existe.

 Core GA
az cosmosdb sql database list

Répertoriez les bases de données SQL sous un compte Azure Cosmos DB.

 Core GA
az cosmosdb sql database merge

Fusionnez les partitions d’une base de données sql.

 Extension Preview
az cosmosdb sql database restore

Restaurez une base de données sql supprimée dans le même compte.

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

Restaurez une base de données sql supprimée dans le même compte.

 Extension Preview
az cosmosdb sql database show

Affichez les détails d’une base de données SQL sous un compte Azure Cosmos DB.

 Core GA
az cosmosdb sql database throughput

Gérer le débit de base de données SQL sous un compte Azure Cosmos DB.

 Core GA
az cosmosdb sql database throughput migrate

Migrez le débit de la base de données SQL entre la mise à l’échelle automatique et l’approvisionnement manuel.

 Core GA
az cosmosdb sql database throughput show

Obtenez le débit de la base de données SQL sous un compte Azure Cosmos DB.

 Core GA
az cosmosdb sql database throughput update

Mettez à jour le débit de la base de données SQL sous un compte Azure Cosmos DB.

 Core GA

az cosmosdb sql database create

Modifier

Créez une base de données SQL sous un compte Azure Cosmos DB.

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

Paramètres obligatoires

--account-name -a

Nom du compte Cosmosdb.

--name -n

Nom de la base de données.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--max-throughput

La ressource de débit maximale peut être mise à l’échelle vers (RU/s). Fourni lorsque la ressource est activée automatiquement. La valeur minimale peut être 4 000 (RU/s).

--throughput

Débit de la base de données SQL (RU/s). La valeur par défaut est 400.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az cosmosdb sql database delete

Modifier

Supprimez la base de données SQL sous un compte Azure Cosmos DB.

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

Paramètres obligatoires

--account-name -a

Nom du compte Cosmosdb.

--name -n

Nom de la base de données.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--yes -y

N’invitez pas à confirmer.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az cosmosdb sql database exists

Modifier

Vérifie si une base de données SQL Azure Cosmos DB existe.

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

Paramètres obligatoires

--account-name -a

Nom du compte Cosmosdb.

--name -n

Nom de la base de données.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az cosmosdb sql database list

Modifier

Répertoriez les bases de données SQL sous un compte Azure Cosmos DB.

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

Exemples

Répertorier les bases de données SQL sous un compte Azure Cosmos DB (généré automatiquement)

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

Paramètres obligatoires

--account-name -a

Nom du compte Cosmosdb.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az cosmosdb sql database merge

Préversion

Cette commande est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Fusionnez les partitions d’une base de données sql.

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

Exemples

Fusionner des partitions de base de données my-database

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

Paramètres obligatoires

--account-name -a

Nom du compte de base de données CosmosDB.

--name -n

Nom de la base de données CosmosDB.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az cosmosdb sql database restore

Modifier

Restaurez une base de données sql supprimée dans le même compte.

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

Exemples

Restaurez une base de données sql supprimée dans le même compte.

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

Paramètres obligatoires

--account-name -a

Nom du compte Cosmosdb.

--name -n

Nom de la base de données.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--disable-ttl

Indicateur de restauration avec la durée de vie désactivée.

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

--restore-timestamp -t

Horodatage dans lequel la base de données doit être restaurée.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az cosmosdb sql database restore (cosmosdb-preview extension)

Préversion

Cette commande est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Restaurez une base de données sql supprimée dans le même compte.

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

Exemples

Restaurez une base de données sql supprimée dans le même compte.

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

Paramètres obligatoires

--account-name -a

Nom du compte Cosmosdb.

--name -n

Nom de la base de données.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--disable-ttl
Préversion

Activez ou désactivez la restauration avec la durée de vie désactivée.

Propriété Valeur
Valeurs acceptées: false, true
--restore-timestamp -t

Horodatage dans lequel la base de données doit être restaurée.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az cosmosdb sql database show

Modifier

Affichez les détails d’une base de données SQL sous un compte Azure Cosmos DB.

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

Paramètres obligatoires

--account-name -a

Nom du compte Cosmosdb.

--name -n

Nom de la base de données.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False