az sql elastic-pool

  • Référence

Gérer des pools élastiques.

Commandes

Nom Description Type Statut
az sql elastic-pool create

Créer un pool élastique.

 Core GA
az sql elastic-pool delete

Supprime un pool élastique.

 Core GA
az sql elastic-pool list

Obtient tous les pools élastiques dans un serveur.

 Core GA
az sql elastic-pool list-dbs

Obtient une liste de bases de données dans un pool élastique.

 Core GA
az sql elastic-pool list-editions

Répertorier les éditions de pool élastique disponibles pour l’abonnement actif.

 Core GA
az sql elastic-pool op

Gérer les opérations sur un pool élastique.

 Core GA
az sql elastic-pool op cancel

Annule l’opération asynchrone sur le pool élastique.

 Core GA
az sql elastic-pool op list

Obtient une liste des opérations effectuées sur le pool élastique.

 Core GA
az sql elastic-pool show

Obtenir un pool élastique.

 Core GA
az sql elastic-pool update

Mettez à jour un pool élastique.

 Core GA

az sql elastic-pool create

Modifier

Créer un pool élastique.

az sql elastic-pool create --name
                           --resource-group
                           --server
                           [--capacity]
                           [--db-dtu-max]
                           [--db-dtu-min]
                           [--edition]
                           [--family]
                           [--ha-replicas]
                           [--license-type {BasePrice, LicenseIncluded}]
                           [--maint-config-id]
                           [--max-size]
                           [--no-wait]
                           [--preferred-enclave-type {Default, VBS}]
                           [--tags]
                           [--zone-redundant {false, true}]

Exemples

Créer un pool élastique avec redondance de zone activée

az sql elastic-pool create -g mygroup -s myserver -n mypool -z

Créer un pool élastique avec redondance de zone explicitement désactivée

az sql elastic-pool create -g mygroup -s myserver -n mypool -z false

Créez un pool élastique DTU Standard 100.

az sql elastic-pool create -g mygroup -s myserver -n mydb -e Standard -c 100

Créez un pool élastique avec l’édition GeneralPurpose, le matériel Gen4 et 1 vcore.

az sql elastic-pool create -g mygroup -s myserver -n mydb -e GeneralPurpose -f Gen4 -c 1

Créez un pool élastique avec l’édition Hyperscale, le matériel Gen5, 4 vcores et 2 réplicas à haute disponibilité.

az sql elastic-pool create -g mygroup -s myserver -n mydb -e Hyperscale -f Gen5 -c 4 --ha-replicas 2

Créez un pool élastique avec enclave VBS.

az sql elastic-pool create -g mygroup -s myserver -n mydb --preferred-enclave-type VBS

Paramètres obligatoires

--name -n

Nom du pool élastique.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--server -s

Nom d’Azure SQL Server. Vous pouvez configurer la valeur par défaut à l’aide az configure --defaults sql-server=<name>de .

Paramètres facultatifs

--capacity --dtu -c

Composant de capacité de la référence SKU en nombre entier de DTU ou de vcores.

--db-dtu-max --db-max-capacity --db-max-dtu

Capacité maximale (en DTU ou vcores) qu’une base de données peut consommer.

--db-dtu-min --db-min-capacity --db-min-dtu

La capacité minimale (en DTU ou vcores) de chaque base de données est garantie.

--edition --tier -e

Composant d’édition de la référence SKU. Les valeurs autorisées sont les suivantes : De base, Standard, Premium, GeneralPurpose, BusinessCritical.

--family -f

Composant de génération de calcul de la référence SKU (pour les références SKU vcore uniquement). Les valeurs autorisées sont les suivantes : Gen4, Gen5.

--ha-replicas --read-replicas

Nombre de réplicas à haute disponibilité à approvisionner pour la base de données. Uniquement settable pour l’édition Hyperscale.

--license-type

Type de licence à appliquer pour ce pool élastique.

valeurs acceptées: BasePrice, LicenseIncluded
--maint-config-id -m

ID ou nom de configuration de maintenance spécifié pour cette ressource.

--max-size --storage

Taille de stockage maximale. Si aucune unité n’est spécifiée, la valeur par défaut est bytes (B).

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False
--preferred-enclave-type

Type d’enclave préféré pour le pool élastique Azure SQL. Les valeurs autorisées sont les suivantes : Par défaut, VBS.

valeurs acceptées: Default, VBS
--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--zone-redundant -z

Spécifie s’il faut activer la redondance de zone. La valeur par défaut est true si aucune valeur n’est spécifiée.

valeurs acceptées: false, true
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az sql elastic-pool delete

Modifier

Supprime un pool élastique.

az sql elastic-pool delete [--ids]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--server]
                           [--subscription]

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom du pool élastique.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--server -s

Nom d’Azure SQL Server. Vous pouvez configurer la valeur par défaut à l’aide az configure --defaults sql-server=<name>de .

--subscription

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

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az sql elastic-pool list

Modifier

Obtient tous les pools élastiques dans un serveur.

az sql elastic-pool list [--ids]
                         [--resource-group]
                         [--server]
                         [--skip]
                         [--subscription]

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--server -s

Nom d’Azure SQL Server. Vous pouvez configurer la valeur par défaut à l’aide az configure --defaults sql-server=<name>de .

--skip

Nombre d’éléments de la collection à ignorer. La valeur par défaut est None.

--subscription

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

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az sql elastic-pool list-dbs

Modifier

Obtient une liste de bases de données dans un pool élastique.

az sql elastic-pool list-dbs [--ids]
                             [--name]
                             [--resource-group]
                             [--server]
                             [--subscription]

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom du pool élastique.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--server -s

Nom d’Azure SQL Server. Vous pouvez configurer la valeur par défaut à l’aide az configure --defaults sql-server=<name>de .

--subscription

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

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az sql elastic-pool list-editions

Modifier

Répertorier les éditions de pool élastique disponibles pour l’abonnement actif.

Inclut également les paramètres DTU de pool, les limites de stockage et les paramètres par base de données disponibles. Pour réduire les détails, les limites de stockage supplémentaires et les paramètres par base de données sont masqués par défaut.

az sql elastic-pool list-editions --location
                                  [--available]
                                  [--dtu]
                                  [--edition]
                                  [--show-details {db-max-dtu, db-max-size, db-min-dtu, max-size}]
                                  [--vcores]

Exemples

Afficher toutes les éditions de pool élastique et les limites DTU du pool dans la région USA Ouest.

az sql elastic-pool list-editions -l westus -o table

Afficher toutes les limites de DTU du pool pour l’édition Standard dans la région USA Ouest.

az sql elastic-pool list-editions -l westus --edition Standard -o table

Afficher les tailles maximales disponibles pour les pools élastiques avec au moins 100 DTU dans la région USA Ouest.

az sql elastic-pool list-editions -l westus --dtu 100 --show-details max-size -o table

Afficher les paramètres de base de données disponibles pour les pools élastiques DTU Standard 100 dans la région USA Ouest.

az sql elastic-pool list-editions -l westus --edition Standard --dtu 100 -o table --show-details db-min-dtu db-max-dtu db-max-size

Paramètres obligatoires

--location -l

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

Paramètres facultatifs

--available -a

Si elle est spécifiée, affichez uniquement les résultats disponibles dans la région spécifiée.

valeur par défaut: False
--dtu

Nombre de DTU à rechercher. Si elles ne sont pas spécifiées, toutes les tailles DTU sont affichées.

--edition --tier -e

Édition à rechercher. S’il n’est pas spécifié, toutes les éditions sont affichées.

--show-details -d

Liste des détails supplémentaires à inclure dans la sortie.

valeurs acceptées: db-max-dtu, db-max-size, db-min-dtu, max-size
--vcores

Nombre de vcores à rechercher. Si elles ne sont pas spécifiées, toutes les tailles de vcore sont affichées.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az sql elastic-pool show

Modifier

Obtenir un pool élastique.

az sql elastic-pool show [--ids]
                         [--name]
                         [--resource-group]
                         [--server]
                         [--subscription]

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom du pool élastique.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--server -s

Nom d’Azure SQL Server. Vous pouvez configurer la valeur par défaut à l’aide az configure --defaults sql-server=<name>de .

--subscription

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

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az sql elastic-pool update

Modifier

Mettez à jour un pool élastique.

az sql elastic-pool update [--add]
                           [--capacity]
                           [--db-dtu-max]
                           [--db-dtu-min]
                           [--edition]
                           [--family]
                           [--force-string]
                           [--ha-replicas]
                           [--ids]
                           [--maint-config-id]
                           [--max-size]
                           [--name]
                           [--no-wait]
                           [--preferred-enclave-type {Default, VBS}]
                           [--remove]
                           [--resource-group]
                           [--server]
                           [--set]
                           [--subscription]
                           [--zone-redundant {false, true}]

Exemples

Mettre à jour un pool élastique avec redondance de zone activée

az sql elastic-pool update -g mygroup -s myserver -n mypool -z

Mettre à jour un pool élastique avec redondance de zone explicitement désactivée

az sql elastic-pool update -g mygroup -s myserver -n mypool -z false

Mettre à jour un pool élastique avec 2 réplicas à haute disponibilité

az sql elastic-pool update -g mygroup -s myserver -n mypool --ha-replicas 2

Mettre à jour un pool élastique avec enclave VBS

az sql elastic-pool update -g mygroup -s myserver -n mypool --preferred-enclave-type VBS

Paramètres facultatifs

--add

Ajoutez un objet à une liste d’objets en spécifiant un chemin d’accès et des paires clé-valeur. Exemple : --add property.listProperty <key=value, string or JSON string>.

valeur par défaut: []
--capacity --dtu -c

Composant de capacité de la référence SKU en nombre entier de DTU ou de vcores.

--db-dtu-max --db-max-capacity --db-max-dtu

Capacité maximale (en DTU ou vcores) qu’une base de données peut consommer.

--db-dtu-min --db-min-capacity --db-min-dtu

La capacité minimale (en DTU ou vcores) de chaque base de données est garantie.

--edition --tier -e

Composant d’édition de la référence SKU. Les valeurs autorisées sont les suivantes : De base, Standard, Premium, GeneralPurpose, BusinessCritical.

--family -f

Composant de génération de calcul de la référence SKU (pour les références SKU vcore uniquement). Les valeurs autorisées sont les suivantes : Gen4, Gen5.

--force-string

Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.

valeur par défaut: False
--ha-replicas --read-replicas

Nombre de réplicas à haute disponibilité à approvisionner pour la base de données. Uniquement settable pour l’édition Hyperscale.

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--maint-config-id -m

ID ou nom de configuration de maintenance spécifié pour cette ressource.

--max-size --storage

Taille de stockage maximale. Si aucune unité n’est spécifiée, la valeur par défaut est bytes (B).

--name -n

Nom du pool élastique.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False
--preferred-enclave-type

Type d’enclave à configurer pour le pool élastique.

valeurs acceptées: Default, VBS
--remove

Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list <indexToRemove> OR --remove propertyToRemove.

valeur par défaut: []
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--server -s

Nom d’Azure SQL Server. Vous pouvez configurer la valeur par défaut à l’aide az configure --defaults sql-server=<name>de .

--set

Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=<value>.

valeur par défaut: []
--subscription

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

--zone-redundant -z

Spécifie s’il faut activer la redondance de zone. La valeur par défaut est true si aucune valeur n’est spécifiée.

valeurs acceptées: false, true
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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