Partager via

az datamigration sql-vm

  • 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-vm . En savoir plus sur les extensions.

Gérer les migrations de base de données vers une machine virtuelle SQL.

Commandes

Nom Description Type Statut
az datamigration sql-vm cancel

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

 Extension GA
az datamigration sql-vm create

Créez une migration de base de données vers une machine virtuelle SQL donnée.

 Extension GA
az datamigration sql-vm cutover

Lancez le basculement pour la migration de base de données en ligne en cours vers une machine virtuelle SQL.

 Extension GA
az datamigration sql-vm show

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

 Extension GA
az datamigration sql-vm wait

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

 Extension GA

az datamigration sql-vm cancel

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

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

Exemples

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

az datamigration sql-vm cancel --migration-operation-id "4124fe90-d1b6-4b50-b4d9-46d02381f59a" --resource-group "testrg" --sql-vm-name "testvm" --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>.

--sql-vm-name

Nom de la machine virtuelle SQL 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-vm create

Créez une migration de base de données vers une machine virtuelle SQL donnée.

az datamigration sql-vm create --resource-group
                               --sql-vm-name
                               --target-db-name
                               [--migration-service]
                               [--no-wait]
                               [--offline-configuration]
                               [--scope]
                               [--source-database-name]
                               [--source-location]
                               [--source-sql-connection]
                               [--target-db-collation]
                               [--target-location]

Exemples

Créez ou mettez à jour une ressource de migration de base de données avec un partage de fichiers en tant que source pour les fichiers de sauvegarde.

az datamigration sql-vm create --source-location '{\"fileShare\":{\"path\":\"\\\\SharedBackup\\user\",\"password\":\"placeholder\",\"username\":\"Server\\name\"}}' --target-location account-key="abcd" storage-account-resource-id="account.database.windows.net" --migration-service "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.DataMigration/sqlMigrationServices/testagent" --offline-configuration last-backup-name="last_backup_file_name" offline=true --scope "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm" --source-database-name "aaa" --source-sql-connection authentication="WindowsAuthentication" data-source="aaa" encrypt-connection=true password="placeholder" trust-server-certificate=true user-name="bbb" --resource-group "testrg" --sql-vm-name "testvm" --target-db-name "db1"

Créez ou mettez à jour une ressource de migration de base de données avec stockage Blob Azure comme source pour les fichiers de sauvegarde.

az datamigration sql-vm create --source-location '{\"AzureBlob\":{\"storageAccountResourceId\":\"/subscriptions/1111-2222-3333-4444/resourceGroups/RG/prooviders/Microsoft.Storage/storageAccounts/MyStorage\",\"accountKey\":\"======AccountKey====\",\"blobContainerName\":\"ContainerName-X\"}}' --migration-service "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.DataMigration/sqlMigrationServices/testagent" --offline-configuration last-backup-name="last_backup_file_name" offline=true --scope "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/testvm" --source-database-name "aaa" --source-sql-connection authentication="WindowsAuthentication" data-source="aaa" encrypt-connection=true password="placeholder" trust-server-certificate=true user-name="bbb" --resource-group "testrg" --sql-vm-name "testvm" --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>.

--sql-vm-name

Nom de la machine virtuelle SQL 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
--offline-configuration

Configuration hors connexion.

Utilisation : --offline-configuration offline=XX last-backup-name=XX

hors connexion : dernier nom de la migration hors connexion : nom de la dernière sauvegarde pour la migration hors connexion. Cette option est facultative pour les migrations à partir du partage de fichiers. S’il n’est pas fourni, le service détermine le dernier nom du fichier de sauvegarde en fonction des derniers fichiers de sauvegarde présents dans le partage de fichiers.

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

Emplacement source des sauvegardes. Valeur attendue : json-string/json-file/@json-file.

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

--target-db-collation

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

--target-location

Emplacement cible pour la copie de sauvegardes.

Utilisation : --target-location storage-account-resource-id=XX account-key=XX

storage-account-resource-id : ID de ressource du compte de stockage copiant des sauvegardes. clé de compte : Stockage clé de compte.

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

Lancez le basculement pour la migration de base de données en ligne en cours vers une machine virtuelle SQL.

az datamigration sql-vm cutover --migration-operation-id
                                [--ids]
                                [--no-wait]
                                [--resource-group]
                                [--sql-vm-name]
                                [--subscription]
                                [--target-db-name]

Exemples

Bascule l’opération de migration en ligne pour la base de données.

az datamigration sql-vm cutover --migration-operation-id "4124fe90-d1b6-4b50-b4d9-46d02381f59a" --resource-group "testrg" --sql-vm-name "testvm" --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>.

--sql-vm-name

Nom de la machine virtuelle SQL 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-vm show

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

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

Exemples

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

az datamigration sql-vm show --expand "MigrationStatusDetails" --resource-group "testrg" --sql-vm-name "testvm" --target-db-name "db1"

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

az datamigration sql-vm show --resource-group "testrg" --sql-vm-name "testvm" --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>.

--sql-vm-name

Nom de la machine virtuelle SQL 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-vm wait

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

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

Exemples

Suspendez l’exécution de la ligne suivante du script CLI jusqu’à ce que la machine virtuelle sql-migration de données soit correctement créée.

az datamigration sql-vm wait --resource-group "testrg" --sql-vm-name "testvm" --target-db-name "db1" --created

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

--sql-vm-name

Nom de la machine virtuelle SQL 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.