Condividi tramite

az datamigration sql-vm

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione datamigration per l'interfaccia della riga di comando di Azure (versione 2.15.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az datamigration sql-vm . Altre informazioni sulle estensioni.

Gestire le migrazioni di database alla macchina virtuale SQL.

Comandi

Nome Descrizione Tipo Status
az datamigration sql-vm cancel

Arrestare la migrazione del database in corso alla macchina virtuale SQL.

 Estensione Disponibilità generale
az datamigration sql-vm create

Creare una nuova migrazione del database a una determinata macchina virtuale SQL.

 Estensione Disponibilità generale
az datamigration sql-vm cutover

Avviare il cutover per la migrazione online del database in corso alla macchina virtuale SQL.

 Estensione Disponibilità generale
az datamigration sql-vm show

Recuperare la migrazione del database specificata per una determinata macchina virtuale SQL.

 Estensione Disponibilità generale
az datamigration sql-vm wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione della datamigration sql-vm.

 Estensione Disponibilità generale

az datamigration sql-vm cancel

Arrestare la migrazione del database in corso alla macchina virtuale SQL.

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

Esempio

Arrestare la migrazione in corso per il database.

az datamigration sql-vm cancel --migration-operation-id "4124fe90-d1b6-4b50-b4d9-46d02381f59a" --resource-group "testrg" --sql-vm-name "testvm" --target-db-name "db1"

Parametri necessari

--migration-operation-id

Operazione di migrazione di rilevamento ID.

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--sql-vm-name

Nome della macchina virtuale SQL di destinazione.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--target-db-name

Nome del database di destinazione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az datamigration sql-vm create

Creare una nuova migrazione del database a una determinata macchina virtuale SQL.

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]

Esempio

Creare o aggiornare la risorsa migrazione del database con condivisione file come origine per i file di backup.

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"

Creare o aggiornare la risorsa migrazione del database con Archiviazione BLOB di Azure come origine per i file di backup.

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"

Parametri necessari

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--sql-vm-name

Nome della macchina virtuale SQL di destinazione.

--target-db-name

Nome del database di destinazione.

Parametri facoltativi

--migration-service

ID risorsa del servizio migrazione.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
--offline-configuration

Configurazione offline.

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

offline: last-backup-name della migrazione offline: cognome del backup per la migrazione offline. Questa opzione è facoltativa per le migrazioni dalla condivisione file. Se non viene specificato, il servizio determinerà l'ultimo nome del file di backup in base ai file di backup più recenti presenti nella condivisione file.

--scope

ID risorsa della risorsa di destinazione (MACCHINA virtuale SQL, Istanza gestita di SQL o database SQL).

--source-database-name

Nome del database di origine.

--source-location

Percorso di origine dei backup. Valore previsto: json-string/json-file/@json-file.

--source-sql-connection

Dettagli della connessione di SQL Server di origine.

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

origine dati: origine dati. authentication: tipo di autenticazione. user-name: nome utente per la connessione a SQL di origine. password: password per la connessione a SQL di origine. encrypt-connection: indica se crittografare o meno la connessione. trust-server-certificate: indica se considerare attendibile o meno il certificato del server.

--target-db-collation

Regole di confronto del database da usare per il database di destinazione.

--target-location

Percorso di destinazione per la copia dei backup.

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

storage-account-resource-id: ID risorsa dell'account di archiviazione che copia i backup. account-key: Archiviazione chiave dell'account.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az datamigration sql-vm cutover

Avviare il cutover per la migrazione online del database in corso alla macchina virtuale SQL.

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

Esempio

Operazione di migrazione online completa per il database.

az datamigration sql-vm cutover --migration-operation-id "4124fe90-d1b6-4b50-b4d9-46d02381f59a" --resource-group "testrg" --sql-vm-name "testvm" --target-db-name "db1"

Parametri necessari

--migration-operation-id

Operazione di migrazione di rilevamento ID.

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--sql-vm-name

Nome della macchina virtuale SQL di destinazione.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--target-db-name

Nome del database di destinazione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az datamigration sql-vm show

Recuperare la migrazione del database specificata per una determinata macchina virtuale SQL.

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

Esempio

Ottenere la migrazione del database vm Sql con il parametro di espansione.

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

Ottenere la migrazione del database vm Sql senza il parametro di espansione.

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

Parametri facoltativi

--expand

I dettagli della migrazione completi devono essere inclusi nella risposta.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--migration-operation-id

ID operazione di migrazione facoltativa. Se viene specificato, vengono recuperati i dettagli dell'operazione di migrazione per tale ID. Se non viene specificato (impostazione predefinita), vengono recuperati i dettagli relativi all'operazione più recente o corrente.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--sql-vm-name

Nome della macchina virtuale SQL di destinazione.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--target-db-name

Nome del database di destinazione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az datamigration sql-vm wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione della datamigration sql-vm.

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]

Esempio

Sospendere l'esecuzione della riga di comando successiva dello script dell'interfaccia della riga di comando fino a quando non viene creata correttamente la datamigration sql-vm.

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

Parametri facoltativi

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

Valore predefinito: False
--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendere l'eliminazione.

Valore predefinito: False
--exists

Attendere che la risorsa esista.

Valore predefinito: False
--expand

I dettagli della migrazione completi devono essere inclusi nella risposta.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--interval

Intervallo di polling in secondi.

Valore predefinito: 30
--migration-operation-id

ID operazione di migrazione facoltativa. Se viene specificato, vengono recuperati i dettagli dell'operazione di migrazione per tale ID. Se non viene specificato (impostazione predefinita), vengono recuperati i dettagli relativi all'operazione più recente o corrente.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--sql-vm-name

Nome della macchina virtuale SQL di destinazione.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--target-db-name

Nome del database di destinazione.

--timeout

Attesa massima in secondi.

Valore predefinito: 3600
--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

Valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.