Partilhar via

az datamigration sql-db

  • Referência

Nota

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

Gerencie migrações de banco de dados para o Banco de Dados SQL.

Comandos

Name Description Tipo Status
az datamigration sql-db cancel

Pare a migração de banco de dados em andamento para o Banco de Dados SQL.

 Extensão GA
az datamigration sql-db create

Crie uma nova migração de banco de dados para um determinado Banco de Dados SQL. Este comando pode migrar dados das tabelas de banco de dados de origem selecionadas para as tabelas de banco de dados de destino. Se o banco de dados de destino não tiver nenhuma tabela existente, use o comando New-AzDataMigrationSqlServerSchema para migrar objetos de esquema do banco de dados de origem para o databse de destino. O link de New-AzDataMigrationSqlServerSchema é https://learn.microsoft.com/cli/azure/datamigration?view=azure-cli-latest#az-datamigration-sql-server-schema.

 Extensão GA
az datamigration sql-db delete

Exclua uma migração de banco de dados em andamento ou concluída para o Banco de Dados SQL.

 Extensão GA
az datamigration sql-db show

Recupere a migração de banco de dados especificada para um determinado banco de dados SQL.

 Extensão GA
az datamigration sql-db wait

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

 Extensão GA

az datamigration sql-db cancel

Pare a migração de banco de dados em andamento para o Banco de Dados SQL.

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

Exemplos

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

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

Parâmetros Obrigatórios

--migration-operation-id

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

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--no-wait

Não espere que a operação de longa duração termine.

Default value: False
--resource-group -g

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

--sqldb-instance-name

Nome do servidor do Banco de dados SQL de destino.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--target-db-name

O nome do banco de dados de destino.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az datamigration sql-db create

Crie uma nova migração de banco de dados para um determinado Banco de Dados SQL. Este comando pode migrar dados das tabelas de banco de dados de origem selecionadas para as tabelas de banco de dados de destino. Se o banco de dados de destino não tiver nenhuma tabela existente, use o comando New-AzDataMigrationSqlServerSchema para migrar objetos de esquema do banco de dados de origem para o databse de destino. O link de New-AzDataMigrationSqlServerSchema é 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]

Exemplos

Crie ou atualize o recurso de migração de banco de dados com parâmetros máximos.

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"

Crie ou atualize o recurso de migração de banco de dados com parâmetros mínimos.

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"

Parâmetros Obrigatórios

--resource-group -g

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

--sqldb-instance-name

Nome do servidor do Banco de dados 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 espere que a operação de longa duração termine.

Default value: False
--scope

ID do recurso de destino (SQL VM, SQL Managed Instance ou SQL DB).

--source-database-name

Nome do banco de dados de origem.

--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. user-name: Nome de usuário para se conectar ao SQL de origem. password: Senha para se conectar ao SQL de origem. encrypt-connection: Se a conexão deve ser criptografada ou não. trust-server-certificate: Se o certificado do servidor deve ser confiável ou não.

--table-list

Lista de tabelas a copiar.

--target-db-collation

Agrupamento de banco de dados a ser usado para o banco de dados de destino.

--target-sql-connection

Detalhes da conexão do Banco de Dados SQL de destino.

Uso: --target-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. user-name: Nome de usuário para se conectar ao SQL de origem. password: Senha para se conectar ao SQL de origem. encrypt-connection: Se a conexão deve ser criptografada ou não. trust-server-certificate: Se o certificado do servidor deve ser confiável ou não.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az datamigration sql-db delete

Exclua uma migração de banco de dados em andamento ou concluída para o Banco de Dados SQL.

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

Exemplos

Excluir recurso de migração de banco de dados.

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

Parâmetros Opcionais

--force

Força opcional excluir booleano. Se isso for fornecido como verdadeiro, a migração será excluída mesmo se estiver ativa.

Valores aceites: false, true
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--no-wait

Não espere que a operação de longa duração termine.

Default value: False
--resource-group -g

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

--sqldb-instance-name

Nome do servidor do Banco de dados SQL de destino.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--target-db-name

O nome do banco de dados de destino.

--yes -y

Não solicite confirmação.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az datamigration sql-db show

Recupere a migração de banco de dados especificada para um determinado banco de dados SQL.

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

Exemplos

Obtenha a migração do banco de dados Sql DB com o parâmetro expand.

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

Obtenha a migração do banco de dados Sql DB sem o parâmetro expand.

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

Parâmetros Opcionais

--expand

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

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--migration-operation-id

ID opcional da operação de migração. 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

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

--sqldb-instance-name

Nome do servidor do Banco de dados SQL de destino.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--target-db-name

O nome do banco de dados de destino.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az datamigration sql-db wait

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

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]

Exemplos

Pause a execução da próxima linha do script CLI até que o sql-db de migração de dados seja criado com êxito.

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

Pause a execução da próxima linha do script CLI até que o sql-db de migração de dados seja excluído com êxito.

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

Parâmetros Opcionais

--created

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

Default value: False
--custom

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

--deleted

Aguarde até ser excluído.

Default value: False
--exists

Aguarde até que o recurso exista.

Default value: False
--expand

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

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--interval

Intervalo de sondagem em segundos.

Default value: 30
--migration-operation-id

ID opcional da operação de migração. 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

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

--sqldb-instance-name

Nome do servidor do Banco de dados SQL de destino.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--target-db-name

O nome do banco de dados de destino.

--timeout

Espera máxima em segundos.

Default value: 3600
--updated

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

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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