Partager via

az datamigration sql-db

  • Référence

Remarque

Cette référence fait partie de l’extension de migration de données pour Azure CLI (version 2.15.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az datamigration sql-db . En savoir plus sur les extensions.

Gérer les migrations de base de données vers la base de données SQL.

Commandes

Nom Description Type Statut
az datamigration sql-db cancel

Arrêtez la migration de base de données en cours vers la base de données SQL.

 Extension GA
az datamigration sql-db create

Créez une migration de base de données vers une base de données SQL donnée. Cette commande peut migrer des données des tables de base de données sources sélectionnées vers les tables de base de données cibles. Si la base de données cible n’a pas de table existante, utilisez la commande New-AzDataMigrationSqlServerSchema pour migrer des objets de schéma de la base de données source vers la base de données cible. Le lien de New-AzDataMigrationSqlServerSchema est https://learn.microsoft.com/cli/azure/datamigration?view=azure-cli-latest#az-datamigration-sql-server-schema.

 Extension GA
az datamigration sql-db delete

Supprimez une migration de base de données en cours ou terminée vers la base de données SQL.

 Extension GA
az datamigration sql-db show

Récupérez la migration de base de données spécifiée pour une base de données SQL donnée.

 Extension GA
az datamigration sql-db wait

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

 Extension GA

az datamigration sql-db cancel

Arrêtez la migration de base de données en cours vers la base de données SQL.

az datamigration sql-db cancel --migration-operation-id
                               [--ids]
                               [--no-wait]
                               [--resource-group]
                               [--sqldb-instance-name]
                               [--subscription]
                               [--target-db-name]

Exemples

Arrête la migration continue pour la base de données.

az datamigration sql-db cancel --migration-operation-id "9a90bb84-e70f-46f7-b0ae-1aef5b3b9f07" --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

Paramètres obligatoires

--migration-operation-id

Opération de migration de suivi des ID.

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

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

--sqldb-instance-name

Nom du serveur SQL Database server cible.

--subscription

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

--target-db-name

Nom de la base de données cible.

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

Créez une migration de base de données vers une base de données SQL donnée. Cette commande peut migrer des données des tables de base de données sources sélectionnées vers les tables de base de données cibles. Si la base de données cible n’a pas de table existante, utilisez la commande New-AzDataMigrationSqlServerSchema pour migrer des objets de schéma de la base de données source vers la base de données cible. Le lien de New-AzDataMigrationSqlServerSchema est https://learn.microsoft.com/cli/azure/datamigration?view=azure-cli-latest#az-datamigration-sql-server-schema.

az datamigration sql-db create --resource-group
                               --sqldb-instance-name
                               --target-db-name
                               [--migration-service]
                               [--no-wait]
                               [--scope]
                               [--source-database-name]
                               [--source-sql-connection]
                               [--table-list]
                               [--target-db-collation]
                               [--target-sql-connection]

Exemples

Créez ou mettez à jour une ressource de migration de base de données avec des paramètres maximum.

az datamigration sql-db create --migration-service "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.DataMigration/sqlMigrationServices/testagent" --scope "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/servers/sqldbinstance" --source-database-name "aaa" --source-sql-connection authentication="WindowsAuthentication" data-source="aaa" encrypt-connection=true password="placeholder" trust-server-certificate=true user-name="bbb" --table-list "[Schema1].[TableName1]" "[Schema2].[TableName2]" --target-sql-connection authentication="SqlAuthentication" data-source="sqldbinstance" encrypt-connection=true password="placeholder" trust-server-certificate=true user-name="bbb" --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

Créer ou mettre à jour une ressource de migration de base de données avec des paramètres minimum.

az datamigration sql-db create --migration-service "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.DataMigration/sqlMigrationServices/testagent" --scope "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/servers/sqldbinstance" --source-database-name "aaa" --source-sql-connection authentication="WindowsAuthentication" data-source="aaa" encrypt-connection=true password="placeholder" trust-server-certificate=true user-name="bbb" --target-sql-connection authentication="SqlAuthentication" data-source="sqldbinstance" encrypt-connection=true password="placeholder" trust-server-certificate=true user-name="bbb" --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

Paramètres obligatoires

--resource-group -g

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

--sqldb-instance-name

Nom du serveur SQL Database server cible.

--target-db-name

Nom de la base de données cible.

Paramètres facultatifs

--migration-service

ID de ressource du service de migration.

--no-wait

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

valeur par défaut: False
--scope

ID de ressource de la ressource cible (machine virtuelle SQL, SQL Managed Instance ou base de données SQL).

--source-database-name

Nom de la base de données source.

--source-sql-connection

Détails de la connexion SQL Server source.

Utilisation : --source-sql-connection data-source=XX authentication=XX user-name=XX password=XX encrypt-connection=XX trust-server-certificate=XX

source de données : source de données. authentification : type d’authentification. nom d’utilisateur : nom d’utilisateur pour se connecter à sql source. mot de passe : mot de passe pour se connecter à sql source. chiffre-connexion : indique s’il faut chiffrer la connexion ou non. trust-server-certificate : indique s’il faut approuver le certificat de serveur ou non.

--table-list

Liste des tables à copier.

--target-db-collation

Classement de base de données à utiliser pour la base de données cible.

--target-sql-connection

Détails de connexion de base de données SQL cible.

Utilisation : --target-sql-connection data-source=XX authentication=XX user-name=XX password=XX encrypt-connection=XX trust-server-certificate=XX

source de données : source de données. authentification : type d’authentification. nom d’utilisateur : nom d’utilisateur pour se connecter à sql source. mot de passe : mot de passe pour se connecter à sql source. chiffre-connexion : indique s’il faut chiffrer la connexion ou non. trust-server-certificate : indique s’il faut approuver le certificat de serveur ou non.

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

Supprimez une migration de base de données en cours ou terminée vers la base de données SQL.

az datamigration sql-db delete [--force {false, true}]
                               [--ids]
                               [--no-wait]
                               [--resource-group]
                               [--sqldb-instance-name]
                               [--subscription]
                               [--target-db-name]
                               [--yes]

Exemples

Supprime la ressource de migration de base de données.

az datamigration sql-db delete --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

Paramètres facultatifs

--force

Force facultative supprimer booléen. S’il s’agit de la valeur true, la migration est supprimée même si elle est active.

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

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

--sqldb-instance-name

Nom du serveur SQL Database server cible.

--subscription

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

--target-db-name

Nom de la base de données cible.

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

Récupérez la migration de base de données spécifiée pour une base de données SQL donnée.

az datamigration sql-db show [--expand]
                             [--ids]
                             [--migration-operation-id]
                             [--resource-group]
                             [--sqldb-instance-name]
                             [--subscription]
                             [--target-db-name]

Exemples

Obtenir la migration de base de données Sql DB avec le paramètre expand.

az datamigration sql-db show --expand "MigrationStatusDetails" --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

Obtenir la migration de base de données Sql DB sans le paramètre expand.

az datamigration sql-db show --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1"

Paramètres facultatifs

--expand

Les détails complets de la migration sont inclus dans la réponse.

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

--migration-operation-id

ID d’opération de migration facultatif. Si cela est fourni, les détails de l’opération de migration pour cet ID sont récupérés. S’il n’est pas fourni (valeur par défaut), les détails relatifs à l’opération la plus récente ou actuelle sont récupérés.

--resource-group -g

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

--sqldb-instance-name

Nom du serveur SQL Database server cible.

--subscription

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

--target-db-name

Nom de la base de données cible.

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 datamigration sql-db wait

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

az datamigration sql-db wait [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--expand]
                             [--ids]
                             [--interval]
                             [--migration-operation-id]
                             [--resource-group]
                             [--sqldb-instance-name]
                             [--subscription]
                             [--target-db-name]
                             [--timeout]
                             [--updated]

Exemples

Suspendre l’exécution de la ligne de script CLI suivante jusqu’à ce que la base de données sql-db soit créée avec succès.

az datamigration sql-db wait --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1" --created

Suspendre l’exécution de la ligne de script CLI suivante jusqu’à ce que la base de données sql-db soit correctement supprimée.

az datamigration sql-db wait --resource-group "testrg" --sqldb-instance-name "sqldbinstance" --target-db-name "db1" --deleted

Paramètres facultatifs

--created

Attendez la création avec « provisioningState » sur « Succeeded ».

valeur par défaut: False
--custom

Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState !='InProgress', instanceView.statuses[ ?code=='PowerState/running'].

--deleted

Attendez la suppression.

valeur par défaut: False
--exists

Attendez que la ressource existe.

valeur par défaut: False
--expand

Les détails complets de la migration sont inclus dans la réponse.

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

--interval

Intervalle d’interrogation en secondes.

valeur par défaut: 30
--migration-operation-id

ID d’opération de migration facultatif. Si cela est fourni, les détails de l’opération de migration pour cet ID sont récupérés. S’il n’est pas fourni (valeur par défaut), les détails relatifs à l’opération la plus récente ou actuelle sont récupérés.

--resource-group -g

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

--sqldb-instance-name

Nom du serveur SQL Database server cible.

--subscription

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

--target-db-name

Nom de la base de données cible.

--timeout

Délai maximal d’attente en secondes.

valeur par défaut: 3600
--updated

Attendez la mise à jour avec provisioningState sur « Réussi ».

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.