Partager via


az sql elastic-pool

Gérer des pools élastiques.

Commandes

Nom Description Type État
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 la liste des opérations effectuées sur le pool élastique.

Core GA
az sql elastic-pool show

Obtient un pool élastique.

Core GA
az sql elastic-pool update

Mettez à jour un pool élastique.

Core GA

az sql elastic-pool create

Créer un pool élastique.

az sql elastic-pool create --name
                           --resource-group
                           --server
                           [--capacity --dtu]
                           [--db-dtu-max --db-max-capacity --db-max-dtu]
                           [--db-dtu-min --db-min-capacity --db-min-dtu]
                           [--edition --tier]
                           [--family]
                           [--ha-replicas --read-replicas]
                           [--license-type {BasePrice, LicenseIncluded}]
                           [--maint-config-id]
                           [--max-size --storage]
                           [--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 à l’aide de 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

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.

--capacity --dtu -c

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

Propriété Valeur
Groupe de paramètres: Performance Level (components) Arguments
--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.

Propriété Valeur
Groupe de paramètres: Performance Level (components) Arguments
--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.

Propriété Valeur
Groupe de paramètres: Performance Level (components) Arguments
--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.

Propriété Valeur
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.

Propriété Valeur
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.

Propriété Valeur
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.

Propriété Valeur
Valeurs acceptées: false, true
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 sql elastic-pool delete

Supprime un pool élastique.

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

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.

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). 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 ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--name -n

Nom du pool élastique.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--no-wait

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

Propriété Valeur
Valeur par défaut: False
--resource-group -g

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

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--server -s

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

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--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.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
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/.

--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 sql elastic-pool list

Obtient tous les pools élastiques dans un serveur.

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

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.

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). 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 ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--resource-group -g

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

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--server -s

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

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--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 à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
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/.

--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 sql elastic-pool list-dbs

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

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.

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). 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 ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--name -n

Nom du pool élastique.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--resource-group -g

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

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--server -s

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

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--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.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
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/.

--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 sql elastic-pool list-editions

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 --tier]
                                  [--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

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

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.

--available -a

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

Propriété Valeur
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.

Propriété Valeur
Groupe de paramètres: Search Arguments
--edition --tier -e

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

Propriété Valeur
Groupe de paramètres: Search Arguments
--show-details -d

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

Propriété Valeur
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.

Propriété Valeur
Groupe de paramètres: Search Arguments
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 sql elastic-pool show

Obtient un pool élastique.

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

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.

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). 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 ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--name -n

Nom du pool élastique.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--resource-group -g

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

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--server -s

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

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--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.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
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/.

--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 sql elastic-pool update

Mettez à jour un pool élastique.

az sql elastic-pool update [--add]
                           [--capacity --dtu]
                           [--db-dtu-max --db-max-capacity --db-max-dtu]
                           [--db-dtu-min --db-min-capacity --db-min-dtu]
                           [--edition --tier]
                           [--family]
                           [--force-string]
                           [--ha-replicas --read-replicas]
                           [--ids]
                           [--maint-config-id]
                           [--max-size --storage]
                           [--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

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.

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

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
Valeur par défaut: []
--capacity --dtu -c

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

Propriété Valeur
Groupe de paramètres: Performance Level (components) Arguments
--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.

Propriété Valeur
Groupe de paramètres: Performance Level (components) Arguments
--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.

Propriété Valeur
Groupe de paramètres: Performance Level (components) Arguments
--force-string

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

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
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 l’espace). 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 ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--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.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--no-wait

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

Propriété Valeur
Valeur par défaut: False
--preferred-enclave-type

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

Propriété Valeur
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.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
Valeur par défaut: []
--resource-group -g

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

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--server -s

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

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--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>.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
Valeur par défaut: []
--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.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--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.

Propriété Valeur
Valeurs acceptées: false, true
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/.

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