Partager via


az sql db replica

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

Commandes

Nom Description Type État
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 replica create

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

Vous pouvez voir la liste complète des options de niveau de performance en exécutant az sql db list-editions -a -o table -l LOCATION. La base de données secondaire doit avoir la même édition que la base de données primaire.

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

Exemples

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

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb --service-objective S0

Créer une base de données avec l’édition GeneralPurpose, le matériel Gen4 et 1 vcore en tant que réplica secondaire d’une base de données GeneralPurpose existante

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb -f Gen4 -c 1

Créez une base de données avec un stockage de sauvegarde redondant interzone en tant que réplica secondaire d’une base de données existante.

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb --backup-storage-redundancy Zone

Paramètres obligatoires

--name -n

Nom d’Azure SQL Database.

--partner-server

Nom du serveur dans lequel créer le réplica.

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

--assign-identity -i

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

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

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

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

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

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

Propriété Valeur
Groupe de paramètres: Serverless offering Arguments
Valeurs acceptées: Provisioned, Serverless
--elastic-pool

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

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

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

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

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

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

Propriété Valeur
Groupe de paramètres: Serverless offering Arguments
--no-wait

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

Propriété Valeur
Valeur par défaut: False
--partner-database

Nom du nouveau réplica. S’il n’est pas spécifié, la valeur par défaut est le nom de la base de données source.

--partner-resource-group

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

--partner-sub-id

ID d’abonnement dans lequel créer le réplica. S’il n’est pas spécifié, la valeur par défaut est l’ID d’abonnement d’origine.

--preferred-enclave-type

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

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

Propriété Valeur
Valeurs acceptées: Disabled, Enabled
--secondary-type

Type de secondaire à créer. Les valeurs autorisées sont les suivantes : Géo, Nommé.

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

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

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

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

az sql db replica delete-link --partner-server
                              [--ids]
                              [--name]
                              [--partner-resource-group]
                              [--resource-group]
                              [--server]
                              [--subscription]
                              [--yes]
--partner-server

Nom du serveur dans lequel se trouve l’autre réplica.

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

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

Nom du groupe de ressources dans lequel se trouve l’autre réplica. S’il n’est pas spécifié, la valeur par défaut est le groupe de ressources de la première base de données.

--resource-group -g

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

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

N’invitez pas à confirmer.

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

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

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

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

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

Format de sortie.

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

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

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

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

az sql db replica list-links [--ids]
                             [--name]
                             [--resource-group]
                             [--server]
                             [--subscription]

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

az sql db replica list-links --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver

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

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

az sql db replica set-primary [--allow-data-loss]
                              [--ids]
                              [--name]
                              [--resource-group]
                              [--server]
                              [--subscription]

Exemples

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

az sql db replica set-primary --allow-data-loss --name MyDatabase --resource-group MyResourceGroup --server myserver --subscription MySubscription

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.

--allow-data-loss

Si elle est spécifiée, l’opération de basculement autorise la perte de données.

Propriété Valeur
Valeur par défaut: False
--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 de la base de données à basculer.

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

Nom du groupe de ressources contenant le réplica secondaire qui deviendra le nouveau réplica principal.

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

Nom du serveur contenant le réplica secondaire qui deviendra le nouveau réplica principal. 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