Partager via

az sql db replica

  • Référence

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

Modifier

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

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 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]
                         [--capacity]
                         [--compute-model {Provisioned, Serverless}]
                         [--elastic-pool]
                         [--encryption-protector]
                         [--encryption-protector-auto-rotation {false, true}]
                         [--family]
                         [--federated-client-id]
                         [--ha-replicas]
                         [--keys]
                         [--license-type {BasePrice, LicenseIncluded}]
                         [--min-capacity]
                         [--no-wait]
                         [--partner-database]
                         [--partner-resource-group]
                         [--preferred-enclave-type {Default, VBS}]
                         [--read-scale {Disabled, Enabled}]
                         [--secondary-type]
                         [--service-level-objective]
                         [--tags]
                         [--umi]
                         [--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 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.

--compute-model

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

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

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

--no-wait

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

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.

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

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

Modifier

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.

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

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

Modifier

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. (généré automatiquement)

az sql db replica list-links --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver
--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 replica set-primary

Modifier

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. (généré automatiquement)

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

Paramètres facultatifs

--allow-data-loss

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

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

--name -n

Nom de la base de données à basculer.

--resource-group -g

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

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

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