Compartilhar via

az datamigration sql-vm

  • Referência

Observação

Essa referência faz parte da extensão datamigration para a CLI do Azure (versão 2.15.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az datamigration sql-vm. Saiba mais sobre extensões.

Gerenciar migrações de banco de dados para a VM do SQL.

Comandos

Nome Description Tipo Status
az datamigration sql-vm cancel

Interrompa a migração de banco de dados em andamento para a VM do SQL.

 Extensão GA
az datamigration sql-vm create

Crie uma migração de banco de dados para uma determinada VM do SQL.

 Extensão GA
az datamigration sql-vm cutover

Inicie a substituição da migração de banco de dados online em andamento para a VM do SQL.

 Extensão GA
az datamigration sql-vm show

Recupere a migração de banco de dados especificada para uma determinada VM do SQL.

 Extensão GA
az datamigration sql-vm wait

Coloque a CLI em um estado de espera até que uma condição da datamigration sql-vm seja atendida.

 Extensão GA

az datamigration sql-vm cancel

Interrompa a migração de banco de dados em andamento para a VM do SQL.

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

Exemplos

Interrompe a migração contínua para o banco de dados.

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

Parâmetros Exigidos

--migration-operation-id

Operação de migração de acompanhamento de ID.

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Valor padrão: False
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--sql-vm-name

Nome da Máquina Virtual SQL de destino.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--target-db-name

O nome do banco de dados de destino.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

az datamigration sql-vm create

Crie uma migração de banco de dados para uma determinada VM do 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]

Exemplos

Crie ou atualize o recurso de Migração de Banco de Dados com o compartilhamento de arquivos como fonte para arquivos de 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"

Crie ou atualize o recurso de Migração de Banco de Dados com o Armazenamento de Blobs do Azure como fonte para arquivos de 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"

Parâmetros Exigidos

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--sql-vm-name

Nome da Máquina Virtual SQL de destino.

--target-db-name

O nome do banco de dados de destino.

Parâmetros Opcionais

--migration-service

ID do recurso do Serviço de Migração.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Valor padrão: False
--offline-configuration

Configuração offline.

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

offline: nome do último backup da migração offline: sobrenome de backup para migração offline. Isso é opcional para migrações do compartilhamento de arquivos. Se não for fornecido, o serviço determinará o último nome do arquivo de backup com base nos arquivos de backup mais recentes presentes no compartilhamento de arquivos.

--scope

ID de recurso do recurso de destino (VM do SQL, Instância Gerenciada de SQL ou Banco de Dados SQL).

--source-database-name

Nome do banco de dados de origem.

--source-location

Local de origem dos backups. Valor esperado: json-string/json-file/@json-file.

--source-sql-connection

Detalhes da conexão do SQL Server de origem.

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

fonte de dados: fonte de dados. autenticação: tipo de autenticação. nome de usuário: nome de usuário para se conectar ao SQL de origem. senha: senha para se conectar ao SQL de origem. encrypt-connection: se deseja criptografar a conexão ou não. trust-server-certificate: independentemente de confiar no certificado do servidor ou não.

--target-db-collation

Ordenação de banco de dados a ser usada para o banco de dados de destino.

--target-location

Local de destino para copiar backups.

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

storage-account-resource-id: ID do recurso da conta de armazenamento copiando backups. chave de conta: chave da conta de armazenamento.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

az datamigration sql-vm cutover

Inicie a substituição da migração de banco de dados online em andamento para a VM do SQL.

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

Exemplos

Operação de migração online de substituição para o banco de dados.

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

Parâmetros Exigidos

--migration-operation-id

Operação de migração de acompanhamento de ID.

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Valor padrão: False
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--sql-vm-name

Nome da Máquina Virtual SQL de destino.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--target-db-name

O nome do banco de dados de destino.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

az datamigration sql-vm show

Recupere a migração de banco de dados especificada para uma determinada VM do SQL.

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

Exemplos

Obtenha a migração do banco de dados de VM sql com o parâmetro de expansão.

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

Obtenha a migração do banco de dados de VM sql sem o parâmetro de expansão.

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

Parâmetros Opcionais

--expand

Os detalhes completos da migração serão incluídos na resposta.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--migration-operation-id

ID da operação de migração opcional. Se isso for fornecido, os detalhes da operação de migração para essa ID serão recuperados. Se não for fornecido (padrão), os detalhes relacionados à operação mais recente ou atual serão recuperados.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--sql-vm-name

Nome da Máquina Virtual SQL de destino.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--target-db-name

O nome do banco de dados de destino.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

az datamigration sql-vm wait

Coloque a CLI em um estado de espera até que uma condição da datamigration sql-vm seja atendida.

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]

Exemplos

Pause a execução da próxima linha de script da CLI até que a datamigration sql-vm seja criada com êxito.

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

Parâmetros Opcionais

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Valor padrão: False
--custom

Aguarde até que a condição atenda a uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

Valor padrão: False
--exists

Aguarde até que o recurso exista.

Valor padrão: False
--expand

Os detalhes completos da migração serão incluídos na resposta.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--interval

Intervalo de sondagem em segundos.

Valor padrão: 30
--migration-operation-id

ID da operação de migração opcional. Se isso for fornecido, os detalhes da operação de migração para essa ID serão recuperados. Se não for fornecido (padrão), os detalhes relacionados à operação mais recente ou atual serão recuperados.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--sql-vm-name

Nome da Máquina Virtual SQL de destino.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--target-db-name

O nome do banco de dados de destino.

--timeout

Espera máxima em segundos.

Valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.