Partager via

az datamigration sql-managed-instance

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

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

Commandes

Nom Description Type Statut
az datamigration sql-managed-instance cancel

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

 Extension GA
az datamigration sql-managed-instance create

Créez une migration de base de données vers une instance managée SQL donnée.

 Extension GA
az datamigration sql-managed-instance cutover

Lancez le basculement pour la migration de base de données en ligne en cours vers SQL Managed Instance.

 Extension GA
az datamigration sql-managed-instance show

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

 Extension GA
az datamigration sql-managed-instance wait

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de l’instance sql-managed-instance soit remplie.

 Extension GA

az datamigration sql-managed-instance cancel

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

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

Exemples

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

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

--managed-instance-name

Nom de l’instance managée SQL cible.

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

--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-managed-instance create

Créez une migration de base de données vers une instance managée SQL donnée.

az datamigration sql-managed-instance create --managed-instance-name
                                             --resource-group
                                             --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-managed-instance create --managed-instance-name "managedInstance1" --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.Sql/managedInstances/instance" --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" --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-managed-instance create --managed-instance-name "managedInstance1" --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.Sql/managedInstances/instance" --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" --target-db-name "db1"

Paramètres obligatoires

--managed-instance-name

Nom de l’instance managée SQL cible.

--resource-group -g

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

--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-managed-instance cutover

Lancez le basculement pour la migration de base de données en ligne en cours vers SQL Managed Instance.

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

Exemples

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

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

--managed-instance-name

Nom de l’instance managée SQL cible.

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

--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-managed-instance show

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

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

Exemples

Obtenir la migration de base de données SQL MI avec le paramètre expand.

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

Obtenir la migration de base de données SQL MI sans le paramètre expand.

az datamigration sql-managed-instance show --managed-instance-name "managedInstance1" --resource-group "testrg" --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 ».

--managed-instance-name

Nom de l’instance managée SQL cible.

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

--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-managed-instance wait

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de l’instance sql-managed-instance soit remplie.

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

Exemples

Suspendez l’exécution de la ligne de script CLI suivante jusqu’à ce que l’instance sql-managed-instance de datamigration soit correctement créée.

az datamigration sql-managed-instance wait --managed-instance-name "managedInstance1" --resource-group "testrg" --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
--managed-instance-name

Nom de l’instance managée SQL cible.

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

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