az sql db

  • Référence

Gérez les bases de données.

Commandes

Nom Description Type État
az sql db advanced-threat-protection-setting

Gérez le paramètre de protection avancée contre les menaces d’une base de données.

 Core GA
az sql db advanced-threat-protection-setting show

Obtient un paramètre de protection avancée contre les menaces.

 Core GA
az sql db advanced-threat-protection-setting update

Mettez à jour le paramètre de protection avancée contre les menaces d’une base de données.

 Core GA
az sql db audit-policy

Gérer la stratégie d’audit d’une base de données.

 Core GA
az sql db audit-policy show

Afficher la stratégie d’audit de base de données.

 Core GA
az sql db audit-policy update

Mettez à jour la stratégie d’audit d’une base de données.

 Core GA
az sql db audit-policy wait

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de la stratégie d’audit de la base de données soit remplie.

 Core GA
az sql db classification

Gérer les classifications de confidentialité.

 Core GA
az sql db classification delete

Supprimez la classification de confidentialité d’une colonne donnée.

 Core GA
az sql db classification list

Obtenez les classifications de confidentialité d’une base de données donnée.

 Core GA
az sql db classification recommendation

Gérer les recommandations de classification de confidentialité.

 Core GA
az sql db classification recommendation disable

Désactivez les recommandations de confidentialité pour une colonne donnée (les recommandations sont activées par défaut sur toutes les colonnes).

 Core GA
az sql db classification recommendation enable

Activez les recommandations de confidentialité pour une colonne donnée (les recommandations sont activées par défaut sur toutes les colonnes).

 Core GA
az sql db classification recommendation list

Répertoriez les classifications de confidentialité recommandées d’une base de données donnée.

 Core GA
az sql db classification show

Obtenez la classification de confidentialité d’une colonne donnée.

 Core GA
az sql db classification update

Mettez à jour la classification de confidentialité d’une colonne.

 Core GA
az sql db copy

Créez une copie d’une base de données.

 Core GA
az sql db create

Créer une base de données.

 Core GA
az sql db delete

Supprimer une base de données.

 Core GA
az sql db export

Exportez une base de données vers un bacpac.

 Core GA
az sql db geo-backup

Gérer les sauvegardes géoredondantes de base de données SQL.

 Core Aperçu
az sql db geo-backup list

Obtient une liste de bases de données récupérables.

 Core Aperçu
az sql db geo-backup restore

Restaurez une sauvegarde géoredondante dans une nouvelle base de données.

 Core Aperçu
az sql db geo-backup show

Obtient une base de données récupérable, qui est une ressource représentant la géo-sauvegarde d’une base de données.

 Core Aperçu
az sql db import

Importe un bacpac dans une nouvelle base de données ou une base de données vide existante.

 Core GA
az sql db ledger-digest-uploads

Gérer les paramètres de chargement de digest du registre.

 Core GA
az sql db ledger-digest-uploads disable

Désactivez le chargement des synthèses de registre.

 Core GA
az sql db ledger-digest-uploads enable

Activez le chargement des synthèses de registre dans un compte Stockage Azure ou dans le registre confidentiel Azure. Si le chargement des synthèses de registre est déjà activé, l’applet de commande réinitialise le point de terminaison de stockage digest à une nouvelle valeur.

 Core GA
az sql db ledger-digest-uploads show

Afficher les paramètres de synthèse de registre actuels.

 Core GA
az sql db list

Répertorier les bases de données sur un serveur ou un pool élastique.

 Core GA
az sql db list-deleted

Obtient une liste de bases de données supprimées pouvant être restaurées.

 Core GA
az sql db list-editions

Afficher les éditions de base de données disponibles pour l’abonnement actif.

 Core GA
az sql db list-usages

Obtient les utilisations de base de données.

 Core GA
az sql db ltr-backup

Gérer les sauvegardes de rétention à long terme de la base de données SQL.

 Core Aperçu
az sql db ltr-backup delete

Supprimez une sauvegarde de rétention à long terme.

 Core Aperçu
az sql db ltr-backup list

Répertoriez les sauvegardes de rétention à long terme pour un emplacement, un serveur ou une base de données.

 Core Aperçu
az sql db ltr-backup restore

Restaurez une sauvegarde de rétention à long terme sur une nouvelle base de données.

 Core Aperçu
az sql db ltr-backup show

Obtenir une sauvegarde de rétention à long terme pour une base de données.

 Core Aperçu
az sql db ltr-backup wait

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de la base de données soit remplie.

 Core Aperçu
az sql db ltr-policy

Gérer la stratégie de rétention à long terme de la base de données SQL.

 Core Aperçu
az sql db ltr-policy set

Mettez à jour les paramètres de rétention à long terme d’une base de données.

 Core Aperçu
az sql db ltr-policy show

Afficher la stratégie de rétention à long terme pour une base de données.

 Core Aperçu
az sql db op

Gérer les opérations sur une base de données.

 Core GA
az sql db op cancel

Annule l’opération asynchrone sur la base de données.

 Core GA
az sql db op list

Obtient une liste des opérations effectuées sur la base de données.

 Core GA
az sql db rename

Renommez une base de données.

 Core GA
az sql db replica

Gérer la réplication entre les bases de données.

 Core GA
az sql db replica create

Créez une base de données en tant que réplica secondaire lisible d’une base de données existante.

 Core GA
az sql db replica delete-link

Arrêtez définitivement la réplication des données entre deux réplicas de base de données.

 Core GA
az sql db replica list-links

Répertoriez les réplicas d’une base de données et leur état de réplication.

 Core GA
az sql db replica set-primary

Définissez la base de données du réplica principal en basculant à partir de la base de données réplica principale actuelle.

 Core GA
az sql db restore

Créez une base de données en restaurant à partir d’une sauvegarde.

 Core GA
az sql db show

Obtenez les détails d’une base de données.

 Core GA
az sql db show-connection-string

Génère une chaîne de connexion à une base de données.

 Core GA
az sql db show-deleted

Obtenez les détails d’une base de données supprimée.

 Core GA
az sql db str-policy

Gérer la stratégie de rétention à court terme de base de données SQL.

 Core Aperçu
az sql db str-policy set

Mettez à jour les paramètres de rétention à court terme pour une base de données dynamique.

 Core Aperçu
az sql db str-policy show

Affichez la stratégie de rétention à court terme pour une base de données dynamique.

 Core Aperçu
az sql db str-policy wait

Placez l’interface CLI dans un état d’attente jusqu’à ce que la stratégie soit définie.

 Core Aperçu
az sql db tde

Gérer le chiffrement transparent des données d’une base de données.

 Core GA
az sql db tde key

Gérer le protecteur de chiffrement d’une base de données.

 Core GA
az sql db tde key revalidate

Revalide la clé de protecteur de chiffrement d’une base de données.

 Core GA
az sql db tde key revert

Rétablit la clé de protecteur de chiffrement d’une base de données au niveau du serveur.

 Core GA
az sql db tde set

Définit la configuration transparente du chiffrement des données d’une base de données.

 Core GA
az sql db tde show

Affiche un chiffrement transparent des données.

 Core GA
az sql db threat-policy

Gérer les stratégies de détection des menaces d’une base de données.

 Core Déprécié
az sql db threat-policy show

Obtient une stratégie de détection des menaces.

 Core Déprécié
az sql db threat-policy update

Mettez à jour la stratégie de détection des menaces d’une base de données.

 Core Déprécié
az sql db update

Mettez à jour une base de données.

 Core GA

az sql db copy

Modifier

Créez une copie d’une base de données.

Une liste complète des options de niveau de performance est visible en exécutant az sql db list-editions -a -o table -l LOCATION. La base de données de destination de copie doit avoir la même édition que la base de données source, mais vous pouvez modifier l’édition une fois la copie terminée.

az sql db copy --dest-name
               [--assign-identity {false, true}]
               [--auto-pause-delay]
               [--availability-zone]
               [--backup-storage-redundancy]
               [--capacity]
               [--compute-model {Provisioned, Serverless}]
               [--dest-resource-group]
               [--dest-server]
               [--elastic-pool]
               [--encryption-protector]
               [--encryption-protector-auto-rotation {false, true}]
               [--family]
               [--federated-client-id]
               [--ha-replicas]
               [--ids]
               [--keys]
               [--license-type {BasePrice, LicenseIncluded}]
               [--min-capacity]
               [--name]
               [--no-wait]
               [--preferred-enclave-type {Default, VBS}]
               [--read-scale {Disabled, Enabled}]
               [--resource-group]
               [--server]
               [--service-level-objective]
               [--subscription]
               [--tags]
               [--umi]
               [--zone-redundant {false, true}]

Exemples

Créez une base de données avec le niveau de performance S0 comme copie d’une base de données Standard existante.

az sql db copy -g mygroup -s myserver -n originalDb --dest-name newDb --service-objective S0

Créez une base de données avec l’édition GeneralPurpose, le matériel Gen4 et 1 vcore comme copie d’une base de données GeneralPurpose existante.

az sql db copy -g mygroup -s myserver -n originalDb --dest-name newDb -f Gen4 -c 1

Créer une base de données avec redondance de stockage de sauvegarde locale en tant que copie d’une base de données existante

az sql db copy -g mygroup -s myserver -n originalDb --dest-name newDb --backup-storage-redundancy Local

Paramètres obligatoires

--dest-name

Nom de la base de données qui sera créée en tant que destination de copie.

Paramètres facultatifs

--assign-identity -i

Attribuer une identité pour la base de données.

Valeurs acceptées: false, true
--auto-pause-delay

Durée en minutes après laquelle la base de données est automatiquement suspendue. La valeur -1 signifie que la pause automatique est désactivée.

--availability-zone

Zone de disponibilité

--backup-storage-redundancy --bsr

Redondance du stockage de sauvegarde utilisée pour stocker les sauvegardes. Les valeurs autorisées sont les suivantes : Local, Zone, Geo, GeoZone.

--capacity -c

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

--compute-model

Modèle de calcul de la base de données.

Valeurs acceptées: Provisioned, Serverless
--dest-resource-group

Nom du groupe de ressources dans lequel créer la copie. S’il n’est pas spécifié, la valeur par défaut est le groupe de ressources d’origine.

--dest-server

Nom du serveur dans lequel créer la copie. S’il n’est pas spécifié, la valeur par défaut est le serveur d’origine.

--elastic-pool

Nom ou ID de ressource du pool élastique dans lequel créer la base de données.

--encryption-protector

Spécifie la clé du coffre de clés Azure à utiliser comme clé de protecteur de chiffrement de base de données.

--encryption-protector-auto-rotation --epauto

Spécifie l’indicateur de rotation automatique de la clé de protection du chiffrement de base de données. Peut être true, false ou null.

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

--federated-client-id

ID client fédéré pour la base de données SQL. Il est utilisé pour le scénario CMK interlocataire.

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

--keys

Liste des clés AKV pour la base de données SQL.

--license-type

Type de licence à appliquer pour cette base de données.LicenseIncluded si vous avez besoin d’une licence, ou BasePricesi vous disposez d’une licence et que vous êtes éligible à Azure HybridBenefit.

Valeurs acceptées: BasePrice, LicenseIncluded
--min-capacity

Capacité minimale que la base de données aura toujours allouée, si elle n’est pas suspendue.

--name -n

Nom d’Azure SQL Database.

--no-wait

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

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

Spécifie le type d’enclave pour cette ressource.

Valeurs acceptées: Default, VBS
--read-scale

Si cette option est activée, les connexions dont l’intention d’application est définie en lecture seule dans leur chaîne de connexion peuvent être routées vers un réplica secondaire en lecture seule. Cette propriété est uniquement paramétrable pour les bases de données Premium et Critique pour l’entreprise.

Valeurs acceptées: Disabled, Enabled
--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 .

--service-level-objective --service-objective

Objectif de service pour la nouvelle base de données. Par exemple : Basic, S0, P1, GP_Gen4_1, GP_S_Gen5_8, BC_Gen5_2, HS_Gen5_32.

--subscription

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

--tags

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

--umi --user-assigned-identity-id

Liste des identités affectées par l’utilisateur pour la base de données SQL.

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

Modifier

Créer une base de données.

Une liste complète des options de niveau de performance est visible en exécutant az sql db list-editions -a -o table -l LOCATION.

az sql db create --name
                 --resource-group
                 --server
                 [--assign-identity {false, true}]
                 [--auto-pause-delay]
                 [--availability-zone]
                 [--backup-storage-redundancy]
                 [--capacity]
                 [--catalog-collation {DATABASE_DEFAULT, SQL_Latin1_General_CP1_CI_AS}]
                 [--collation]
                 [--compute-model {Provisioned, Serverless}]
                 [--edition]
                 [--elastic-pool]
                 [--encryption-protector]
                 [--encryption-protector-auto-rotation {false, true}]
                 [--exhaustion-behavior {AutoPause, BillOverUsage}]
                 [--family]
                 [--federated-client-id]
                 [--free-limit {false, true}]
                 [--ha-replicas]
                 [--keys]
                 [--ledger-on {Disabled, Enabled}]
                 [--license-type {BasePrice, LicenseIncluded}]
                 [--maint-config-id]
                 [--max-size]
                 [--min-capacity]
                 [--no-wait]
                 [--preferred-enclave-type {Default, VBS}]
                 [--read-scale {Disabled, Enabled}]
                 [--sample-name {AdventureWorksLT}]
                 [--service-level-objective]
                 [--tags]
                 [--umi]
                 [--yes]
                 [--zone-redundant {false, true}]

Exemples

Créez une base de données S0 standard.

az sql db create -g mygroup -s myserver -n mydb --service-objective S0

Créer une base de données avec l’édition GeneralPurpose, le matériel Gen4 et 1 vcore

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

Créer une base de données avec redondance de zone activée

az sql db create -g mygroup -s myserver -n mydb -z

Créer une base de données avec redondance de zone explicitement désactivée

az sql db create -g mygroup -s myserver -n mydb -z false

Créer une base de données serverless GeneralPurpose Gen5 2 vcore avec un délai de pause automatique de 120 minutes

az sql db create -g mygroup -s myserver -n mydb -e GeneralPurpose -f Gen5 -c 2 --compute-model Serverless --auto-pause-delay 120

Créer une base de données vcore Hyperscale Gen5 2 avec 2 réplicas en lecture

az sql db create -g mygroup -s myserver -n mydb -e Hyperscale -f Gen5 -c 2 --read-replicas 2

Créer une base de données GeneralPurpose avec stockage de sauvegarde localement redondant

az sql db create -g mygroup -s myserver -n mydb -e GeneralPurpose --backup-storage-redundancy Local

Créez une base de données avec l’enclave VBS activée.

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

Créer une base de données avec une limite gratuite appliquée

az sql db create -g mygroup -s myserver -n mydb -e GeneralPurpose -f Gen5 -c 2 --compute-model Serverless --use-free-limit --free-limit-exhaustion-behavior AutoPause

Paramètres obligatoires

--name -n

Nom d’Azure SQL Database.

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

--assign-identity -i

Attribuer une identité pour la base de données.

Valeurs acceptées: false, true
--auto-pause-delay

Durée en minutes après laquelle la base de données est automatiquement suspendue. La valeur -1 signifie que la pause automatique est désactivée.

--availability-zone

Zone de disponibilité

--backup-storage-redundancy --bsr

Redondance du stockage de sauvegarde utilisée pour stocker les sauvegardes. Les valeurs autorisées sont les suivantes : Local, Zone, Geo, GeoZone.

--capacity -c

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

--catalog-collation

Classement du catalogue de métadonnées.

Valeurs acceptées: DATABASE_DEFAULT, SQL_Latin1_General_CP1_CI_AS
--collation

Classement de la base de données.

--compute-model

Modèle de calcul de la base de données.

Valeurs acceptées: Provisioned, Serverless
--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, Hyperscale.

--elastic-pool

Nom ou ID de ressource du pool élastique dans lequel créer la base de données.

--encryption-protector

Spécifie la clé du coffre de clés Azure à utiliser comme clé de protecteur de chiffrement de base de données.

--encryption-protector-auto-rotation --epauto

Spécifie l’indicateur de rotation automatique de la clé de protection du chiffrement de base de données. Peut être true, false ou null.

Valeurs acceptées: false, true
--exhaustion-behavior --fleb --free-limit-exhaustion-behavior

Spécifie le comportement lorsque les limites gratuites mensuelles sont épuisées pour la base de données gratuite. AutoPause : la base de données sera automatiquement suspendue lors de l’épuisement des limites gratuites pour le reste du mois. BillForUsage : La base de données continuera d’être en ligne en cas d’épuisement des limites gratuites et toute dépassement sera facturée.

Valeurs acceptées: AutoPause, BillOverUsage
--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.

--federated-client-id

ID client fédéré pour la base de données SQL. Il est utilisé pour le scénario CMK interlocataire.

--free-limit --use-free-limit

Indique si la base de données utilise des limites mensuelles gratuites ou non. Autorisé sur une base de données dans un abonnement.

Valeurs acceptées: false, true
--ha-replicas --read-replicas

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

--keys

Liste des clés AKV pour la base de données SQL.

--ledger-on

Créez une base de données de registre dans laquelle l’intégrité de toutes les données est protégée par la fonctionnalité de registre. Toutes les tables de la base de données de registre doivent être des tables de registre. Remarque : la valeur de cette propriété ne peut pas être modifiée une fois la base de données créée.

Valeurs acceptées: Disabled, Enabled
--license-type

Type de licence à appliquer pour cette base de données.LicenseIncluded si vous avez besoin d’une licence, ou BasePricesi vous disposez d’une licence et que vous êtes éligible à Azure HybridBenefit.

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

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

--max-size

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

--min-capacity

Capacité minimale que la base de données aura toujours allouée, si elle n’est pas suspendue.

--no-wait

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

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

Spécifie le type d’enclave pour cette ressource.

Valeurs acceptées: Default, VBS
--read-scale

Si cette option est activée, les connexions dont l’intention d’application est définie en lecture seule dans leur chaîne de connexion peuvent être routées vers un réplica secondaire en lecture seule. Cette propriété est uniquement paramétrable pour les bases de données Premium et Critique pour l’entreprise.

Valeurs acceptées: Disabled, Enabled
--sample-name

Nom de l’exemple de schéma à appliquer lors de la création de thisdatabase.

Valeurs acceptées: AdventureWorksLT
--service-level-objective --service-objective

Objectif de service pour la nouvelle base de données. Par exemple : Basic, S0, P1, GP_Gen4_1, GP_S_Gen5_8, BC_Gen5_2, HS_Gen5_32.

--tags

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

--umi --user-assigned-identity-id

Liste des identités affectées par l’utilisateur pour la base de données SQL.

--yes -y

Ne pas demander de confirmation.

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

Modifier

Supprimer une base de données.

az sql db delete [--ids]
                 [--name]
                 [--no-wait]
                 [--resource-group]
                 [--server]
                 [--subscription]
                 [--yes]

Exemples

Supprimer une base de données. (généré automatiquement)

az sql db delete --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver

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 d’Azure SQL Database.

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

--yes -y

Ne pas demander de confirmation.

Valeur par défaut: False
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 db export

Modifier

Exportez une base de données vers un bacpac.

az sql db export --admin-password
                 --admin-user
                 --storage-key
                 --storage-key-type {SharedAccessKey, StorageAccessKey}
                 --storage-uri
                 [--auth-type {ADPassword, SQL}]
                 [--ids]
                 [--name]
                 [--no-wait]
                 [--resource-group]
                 [--server]
                 [--subscription]

Exemples

Obtenez une clé SAP à utiliser dans l’opération d’exportation.

az storage blob generate-sas --account-name myAccountName -c myContainer -n myBacpac.bacpac \
    --permissions rw --expiry 2018-01-01T00:00:00Z

Exportez bacpac à l’aide d’une clé SAP.

az sql db export -s myserver -n mydatabase -g mygroup -p password -u login \
    --storage-key "?sr=b&sp=rw&se=2018-01-01T00%3A00%3A00Z&sig=mysignature&sv=2015-07-08" \
    --storage-key-type SharedAccessKey \
    --storage-uri https://myAccountName.blob.core.windows.net/myContainer/myBacpac.bacpac

Exportez bacpac à l’aide d’une clé de compte de stockage.

az sql db export -s myserver -n mydatabase -g mygroup -p password -u login \
    --storage-key MYKEY== --storage-key-type StorageAccessKey \
    --storage-uri https://myAccountName.blob.core.windows.net/myContainer/myBacpac.bacpac

Paramètres obligatoires

--admin-password -p

Obligatoire. Mot de passe de connexion administrateur.

--admin-user -u

Obligatoire. Nom de connexion administrateur.

--storage-key

Obligatoire. Clé de stockage.

--storage-key-type

Obligatoire. Type de clé de stockage.

Valeurs acceptées: SharedAccessKey, StorageAccessKey
--storage-uri

Obligatoire. URI de stockage.

Paramètres facultatifs

--auth-type -a

Type d’authentification.

Valeurs acceptées: ADPassword, SQL
--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 d’Azure SQL Database.

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

Modifier

Importe un bacpac dans une nouvelle base de données ou une base de données vide existante.

az sql db import --admin-password
                 --admin-user
                 --storage-key
                 --storage-key-type {SharedAccessKey, StorageAccessKey}
                 --storage-uri
                 [--auth-type {ADPassword, SQL}]
                 [--ids]
                 [--name]
                 [--no-wait]
                 [--resource-group]
                 [--server]
                 [--subscription]

Exemples

Obtenez une clé SAP à utiliser dans l’opération d’importation.

az storage blob generate-sas --account-name myAccountName -c myContainer -n myBacpac.bacpac \
    --permissions rw --expiry 2018-01-01T00:00:00Z

Importez bacpac dans une base de données existante à l’aide d’une clé SAP.

az sql db import -s myserver -n mydatabase -g mygroup -p password -u login \
    --storage-key "?sr=b&sp=rw&se=2018-01-01T00%3A00%3A00Z&sig=mysignature&sv=2015-07-08" \
    --storage-key-type SharedAccessKey \
    --storage-uri https://myAccountName.blob.core.windows.net/myContainer/myBacpac.bacpac

Importez bacpac dans une base de données existante à l’aide d’une clé de compte de stockage.

az sql db import -s myserver -n mydatabase -g mygroup -p password -u login --storage-key MYKEY== \
    --storage-key-type StorageAccessKey \
    --storage-uri https://myAccountName.blob.core.windows.net/myContainer/myBacpac.bacpac

Paramètres obligatoires

--admin-password -p

Obligatoire. Mot de passe de connexion administrateur.

--admin-user -u

Obligatoire. Nom de connexion administrateur.

--storage-key

Obligatoire. Clé de stockage.

--storage-key-type

Obligatoire. Type de clé de stockage.

Valeurs acceptées: SharedAccessKey, StorageAccessKey
--storage-uri

Obligatoire. URI de stockage.

Paramètres facultatifs

--auth-type -a

Type d’authentification.

Valeurs acceptées: ADPassword, SQL
--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 d’Azure SQL Database.

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

Modifier

Répertorier les bases de données sur un serveur ou un pool élastique.

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

Exemples

Répertorier les bases de données sur un serveur ou un pool élastique. (généré automatiquement)

az sql db list --resource-group MyResourceGroup --server myserver

Paramètres facultatifs

--elastic-pool

Si elle est spécifiée, répertorie uniquement les bases de données de ce pool élastique.

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

--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 db list-deleted

Modifier

Obtient une liste de bases de données supprimées pouvant être restaurées.

az sql db list-deleted [--ids]
                       [--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 ».

--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 db list-editions

Modifier

Afficher les éditions de base de données disponibles pour l’abonnement actif.

Inclut les objectifs de service disponibles et les limites de stockage. Pour réduire la détail, les paramètres permettant de réduire intentionnellement les limites de stockage sont masqués par défaut.

az sql db list-editions --location
                        [--available]
                        [--dtu]
                        [--edition]
                        [--service-objective]
                        [--show-details {max-size}]
                        [--vcores]

Exemples

Afficher toutes les éditions de base de données dans un emplacement.

az sql db list-editions -l westus -o table

Afficher tous les objectifs de service de base de données disponibles pour l’édition Standard.

az sql db list-editions -l westus --edition Standard -o table

Afficher les tailles de base de données maximales disponibles pour l’objectif de service P1

az sql db list-editions -l westus --service-objective P1 --show-details 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.

--service-objective

Objectif de service à rechercher. S’il n’est pas spécifié, tous les objectifs de service sont affichés.

--show-details -d

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

Valeurs acceptées: 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 db list-usages

Modifier

Obtient les utilisations de base de données.

az sql db list-usages [--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 d’Azure SQL Database.

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

Modifier

Renommez une base de données.

az sql db rename --new-name
                 [--ids]
                 [--name]
                 [--resource-group]
                 [--server]
                 [--subscription]

Exemples

Renommez une base de données. (généré automatiquement)

az sql db rename --name MyAzureSQLDatabase --new-name MyNew --resource-group MyResourceGroup --server myserver

Paramètres obligatoires

--new-name

Nouveau nom auquel la base de données sera renommée.

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 d’Azure SQL Database.

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

Modifier

Créez une base de données en restaurant à partir d’une sauvegarde.

az sql db restore --dest-name
                  [--assign-identity {false, true}]
                  [--auto-pause-delay]
                  [--availability-zone]
                  [--backup-storage-redundancy]
                  [--capacity]
                  [--compute-model {Provisioned, Serverless}]
                  [--deleted-time]
                  [--edition]
                  [--elastic-pool]
                  [--encryption-protector]
                  [--encryption-protector-auto-rotation {false, true}]
                  [--family]
                  [--federated-client-id]
                  [--ha-replicas]
                  [--ids]
                  [--keys]
                  [--license-type {BasePrice, LicenseIncluded}]
                  [--min-capacity]
                  [--name]
                  [--no-wait]
                  [--preferred-enclave-type {Default, VBS}]
                  [--read-scale {Disabled, Enabled}]
                  [--resource-group]
                  [--server]
                  [--service-level-objective]
                  [--subscription]
                  [--tags]
                  [--time]
                  [--umi]
                  [--zone-redundant {false, true}]

Exemples

Créez une base de données en restaurant à partir d’une sauvegarde. (généré automatiquement)

az sql db restore --dest-name MyDest --edition GeneralPurpose --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver --subscription MySubscription --time "2018-05-20T05:34:22"

Créez une base de données avec un stockage de sauvegarde géoredondant en restaurant à partir d’une sauvegarde. (généré automatiquement)

az sql db restore --dest-name MyDest --edition GeneralPurpose --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver --subscription MySubscription --time "2018-05-20T05:34:22" --backup-storage-redundancy Geo

Paramètres obligatoires

--dest-name

Nom de la base de données qui sera créée en tant que destination de restauration.

Paramètres facultatifs

--assign-identity -i

Attribuer une identité pour la base de données.

Valeurs acceptées: false, true
--auto-pause-delay

Durée en minutes après laquelle la base de données est automatiquement suspendue. La valeur -1 signifie que la pause automatique est désactivée.

--availability-zone

Zone de disponibilité

--backup-storage-redundancy --bsr

Redondance du stockage de sauvegarde utilisée pour stocker les sauvegardes. Les valeurs autorisées sont les suivantes : Local, Zone, Geo, GeoZone.

--capacity -c

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

--compute-model

Modèle de calcul de la base de données.

Valeurs acceptées: Provisioned, Serverless
--deleted-time

Si elle est spécifiée, restaurez à partir d’une base de données supprimée au lieu d’une base de données existante. Doit correspondre à l’heure supprimée d’une base de données supprimée sur le même serveur. Vous devez spécifier --time ou --deleted-time (ou les deux). L’heure doit être au format suivant : « AAAA-MM-DDTHH :MM :SS ».

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

--elastic-pool

Nom ou ID de ressource du pool élastique dans lequel créer la base de données.

--encryption-protector

Spécifie la clé du coffre de clés Azure à utiliser comme clé de protecteur de chiffrement de base de données.

--encryption-protector-auto-rotation --epauto

Spécifie l’indicateur de rotation automatique de la clé de protection du chiffrement de base de données. Peut être true, false ou null.

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

--federated-client-id

ID client fédéré pour la base de données SQL. Il est utilisé pour le scénario CMK interlocataire.

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

--keys

Liste des clés AKV pour la base de données SQL.

--license-type

Type de licence à appliquer pour cette base de données.LicenseIncluded si vous avez besoin d’une licence, ou BasePricesi vous disposez d’une licence et que vous êtes éligible à Azure HybridBenefit.

Valeurs acceptées: BasePrice, LicenseIncluded
--min-capacity

Capacité minimale que la base de données aura toujours allouée, si elle n’est pas suspendue.

--name -n

Nom d’Azure SQL Database.

--no-wait

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

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

Spécifie le type d’enclave pour cette ressource.

Valeurs acceptées: Default, VBS
--read-scale

Si cette option est activée, les connexions dont l’intention d’application est définie en lecture seule dans leur chaîne de connexion peuvent être routées vers un réplica secondaire en lecture seule. Cette propriété est uniquement paramétrable pour les bases de données Premium et Critique pour l’entreprise.

Valeurs acceptées: Disabled, Enabled
--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 .

--service-level-objective --service-objective

Objectif de service pour la nouvelle base de données. Par exemple : Basic, S0, P1, GP_Gen4_1, GP_S_Gen5_8, BC_Gen5_2, HS_Gen5_32.

--subscription

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

--tags

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

--time -t

Point dans le temps de la base de données source qui sera restauré pour créer la nouvelle base de données. Doit être supérieur ou égal à la valeur la plus ancienne de la base de données source. Vous devez spécifier --time ou --deleted-time (ou les deux). L’heure doit être au format suivant : « AAAA-MM-DDTHH :MM :SS ».

--umi --user-assigned-identity-id

Liste des identités affectées par l’utilisateur pour la base de données SQL.

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

Modifier

Obtenez les détails d’une base de données.

az sql db show [--expand-keys {false, true}]
               [--ids]
               [--keys-filter]
               [--name]
               [--resource-group]
               [--server]
               [--subscription]

Exemples

Obtenez les détails d’une base de données. (généré automatiquement)

az sql db show --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver

Paramètres facultatifs

--expand-keys

Développez les clés AKV pour la base de données.

Valeurs acceptées: false, true
Valeur par défaut: False
--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 ».

--keys-filter

Développez les clés AKV pour la base de données.

--name -n

Nom d’Azure SQL Database.

--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 db show-connection-string

Modifier

Génère une chaîne de connexion à une base de données.

az sql db show-connection-string --client {ado.net, jdbc, odbc, php, php_pdo, sqlcmd}
                                 [--auth-type {ADIntegrated, ADPassword, SqlPassword}]
                                 [--ids]
                                 [--name]
                                 [--server]
                                 [--subscription]

Exemples

Générer chaîne de connexion pour ado.net

az sql db show-connection-string -s myserver -n mydb -c ado.net

Paramètres obligatoires

--client -c

Type de fournisseur de connexions client.

Valeurs acceptées: ado.net, jdbc, odbc, php, php_pdo, sqlcmd

Paramètres facultatifs

--auth-type -a

Type d'authentification.

Valeurs acceptées: ADIntegrated, ADPassword, SqlPassword
Valeur par défaut: SqlPassword
--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 d’Azure SQL Database.

Valeur par défaut: <databasename>
--server -s

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

Valeur par défaut: <servername>
--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 db show-deleted

Modifier

Obtenez les détails d’une base de données supprimée.

az sql db show-deleted --restorable-dropped-database-id
                       [--expand-keys {false, true}]
                       [--ids]
                       [--keys-filter]
                       [--resource-group]
                       [--server]
                       [--subscription]

Exemples

Obtenez les détails d’une base de données supprimée. (généré automatiquement)

az sql db show-deleted --resource-group MyResourceGroup --server myserver --restorable-dropped-database-id "MyAzureSQLDatabase,133203966918270000"

Paramètres obligatoires

--restorable-dropped-database-id -r

ID de base de données supprimé pouvant être restauré.

Paramètres facultatifs

--expand-keys

Développez les clés AKV pour la base de données.

Valeurs acceptées: false, true
Valeur par défaut: False
--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 ».

--keys-filter

Développez les clés AKV pour la base de données.

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

Modifier

Mettez à jour une base de données.

az sql db update [--add]
                 [--assign-identity {false, true}]
                 [--auto-pause-delay]
                 [--backup-storage-redundancy]
                 [--capacity]
                 [--compute-model {Provisioned, Serverless}]
                 [--edition]
                 [--elastic-pool]
                 [--encryption-protector]
                 [--encryption-protector-auto-rotation {false, true}]
                 [--exhaustion-behavior {AutoPause, BillOverUsage}]
                 [--family]
                 [--federated-client-id]
                 [--filter]
                 [--force-string]
                 [--free-limit {false, true}]
                 [--ha-replicas]
                 [--ids]
                 [--keys]
                 [--keys-to-remove]
                 [--maint-config-id]
                 [--manual-cutover {false, true}]
                 [--max-size]
                 [--min-capacity]
                 [--name]
                 [--no-wait]
                 [--perform-cutover {false, true}]
                 [--preferred-enclave-type {Default, VBS}]
                 [--read-scale {Disabled, Enabled}]
                 [--remove]
                 [--resource-group]
                 [--server]
                 [--service-objective]
                 [--set]
                 [--subscription]
                 [--umi]
                 [--zone-redundant {false, true}]

Exemples

Mettez à jour une base de données vers l’édition Standard, niveau de performances S0 (10 DTU) en spécifiant la capacité DTU. Notez que GeneralPurpose permet une plus grande plage de taille maximale que l’édition Standard.

az sql db update -g mygroup -s myserver -n mydb --edition Standard --capacity 10 --max-size 250GB

Mettez à jour une base de données vers l’édition Standard, niveau de performances S1 (20 DTU) en spécifiant le nom du niveau de performance. Notez que GeneralPurpose permet une plus grande plage de taille maximale que l’édition Standard.

az sql db update -g mygroup -s myserver -n mydb --edition Standard --service-objective S1 --max-size 250GB

Mettre à jour une base de données vers l’édition GeneralPurpose, 4 vcores avec du matériel Gen5

az sql db update -g mygroup -s myserver -n mydb --edition GeneralPurpose --capacity 4 --family Gen5

Mettre à jour la base de données avec une taille maximale accrue

az sql db update -g mygroup -s myserver -n mydb --max-size 500GB

Mettre à jour la base de données avec redondance de zone activée

az sql db update -g mygroup -s myserver -n mydb -z

Mettre à jour la base de données avec redondance de zone désactivée explicitement

az sql db update -g mygroup -s myserver -n mydb -z false

Mettre à jour la base de données vers un modèle de calcul serverless

az sql db update -g mygroup -s myserver -n mydb --edition GeneralPurpose --capacity 2 --family Gen5 --compute-model Serverless

Mettre à jour la base de données avec le stockage de sauvegarde localement redondant

az sql db update -g mygroup -s myserver -n mydb --backup-storage-redundancy Local

Mettez à jour la base de données avec l’enclave VBS activée.

az sql db update -g mygroup -s myserver -n mydb --preferred-enclave-type VBS

Mettre à jour le comportement d’épuisement de la base de données de limite gratuite vers BillOverUsage

az sql db update -g mygroup -s myserver -n mydb --free-limit-exhaustion-behavior BillOverUsage

Mettre à jour une base de données vers l’édition Hyperscale, 2 vcores avec du matériel Gen5, avec l’option de basculement manuelle

az sql db update -g mygroup -s myserver -n mydb --edition Hyperscale --service-objective HS_Gen5_2 --manual-cutover

Déclencher le basculement avec une option de basculement lors de la mise à jour de la base de données vers l’édition Hyperscale est en cours

az sql db update -g mygroup -s myserver -n mydb --perform-cutover

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: []
--assign-identity -i

Attribuer une identité pour la base de données.

Valeurs acceptées: false, true
Valeur par défaut: False
--auto-pause-delay

Durée en minutes après laquelle la base de données est automatiquement suspendue. La valeur -1 signifie que la pause automatique est désactivée.

--backup-storage-redundancy --bsr

Redondance du stockage de sauvegarde utilisée pour stocker les sauvegardes. Les valeurs autorisées sont les suivantes : Local, Zone, Geo, GeoZone.

--capacity -c

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

--compute-model

Modèle de calcul de la base de données.

Valeurs acceptées: Provisioned, Serverless
--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, Hyperscale.

--elastic-pool

Nom ou ID de ressource du pool élastique vers utilisant la base de données.

--encryption-protector

Spécifie la clé du coffre de clés Azure à utiliser comme clé de protecteur de chiffrement de base de données.

--encryption-protector-auto-rotation --epauto

Spécifie l’indicateur de rotation automatique de la clé de protection du chiffrement de base de données. Peut être true, false ou null.

Valeurs acceptées: false, true
--exhaustion-behavior --fleb --free-limit-exhaustion-behavior

Spécifie le comportement lorsque les limites gratuites mensuelles sont épuisées pour la base de données gratuite. AutoPause : la base de données sera automatiquement suspendue lors de l’épuisement des limites gratuites pour le reste du mois. BillForUsage : La base de données continuera d’être en ligne en cas d’épuisement des limites gratuites et toute dépassement sera facturée.

Valeurs acceptées: AutoPause, BillOverUsage
--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.

--federated-client-id

ID client fédéré pour la base de données SQL. Il est utilisé pour le scénario CMK interlocataire.

--filter

Expression de filtre OData qui filtre les éléments de la collection. Valeur par défaut est Aucun.

--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
--free-limit --use-free-limit

Indique si la base de données utilise des limites mensuelles gratuites ou non. Autorisé sur une base de données dans un abonnement.

Valeurs acceptées: false, true
--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 ».

--keys

Liste des clés AKV pour la base de données SQL.

--keys-to-remove

Liste des clés AKV à supprimer de la base de données SQL.

--maint-config-id -m

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

--manual-cutover

Indique s’il faut effectuer un basculement manuel pendant la mise à jour SLO. Autorisé lors de la mise à jour de la base de données vers le niveau Hyperscale.

Valeurs acceptées: false, true
--max-size

Nouvelle taille maximale de la base de données exprimée en octets.

--min-capacity

Capacité minimale que la base de données aura toujours allouée, si elle n’est pas suspendue.

--name -n

Nom d’Azure SQL Database.

--no-wait

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

Valeur par défaut: False
--perform-cutover

Indique s’il faut effectuer le basculement lors de la mise à jour de la base de données vers le niveau Hyperscale.

Valeurs acceptées: false, true
--preferred-enclave-type

Spécifie le type d’enclave pour cette ressource.

Valeurs acceptées: Default, VBS
--read-scale

Si cette option est activée, les connexions dont l’intention d’application est définie en lecture seule dans leur chaîne de connexion peuvent être routées vers un réplica secondaire en lecture seule. Cette propriété est uniquement paramétrable pour les bases de données Premium et Critique pour l’entreprise.

Valeurs acceptées: Disabled, Enabled
--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 .

--service-objective

Nom du nouvel objectif de service. S’il s’agit d’un objectif de service de base de données autonome et que la base de données se trouve actuellement dans un pool élastique, la base de données est supprimée du pool.

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

--umi --user-assigned-identity-id

Liste des identités affectées par l’utilisateur pour la base de données SQL.

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