Criar um job de migração

O Database Migration Service usa jobs de migração para migrar dados dos bancos de dados de origem para a instância de destino do Cloud SQL. Os jobs de migração ajudam a organizar os perfis de conexão de origem e destino, definir configurações específicas para o processo de migração, monitorar o progresso e finalizar com segurança toda a operação.

A criação de um job de migração inclui as seguintes tarefas:

  • Selecionar perfis de conexão de origem e destino.

  • Escolher quais bancos de dados detectados na instância de origem você quer migrar.

  • Realizar um teste de job de migração para garantir que o Database Migration Service possa se conectar à origem e ao destino dos dados.

  • Iniciar o job de migração e monitorar o progresso.

  • Promover o job de migração quando você quiser alternar o aplicativo para a nova instância.

Antes de começar

  1. Verifique se você atende aos seguintes requisitos:
    • Você tem um bucket do Cloud Storage para arquivos de backup do SQL Server.
    • Seus arquivos de backup completo e de registro de transações são enviados para o bucket do Cloud Storage.
    • Você tem um perfil de conexão de origem para o bucket do Cloud Storage.
    • Você criou e configurou a instância de destino do Cloud SQL para SQL Server e tem um perfil de conexão de destino para ela.
  2. No console do Google Cloud , na página do seletor de projetos, selecione ou crie um projeto do Google Cloud .

    Acessar o seletor de projetos

  3. Ative as APIs Database Migration Service, Compute Engine, Cloud Storage e API Cloud SQL Admin.

    Ativar as APIs

Funções exigidas

Para receber as permissões necessárias para criar jobs de migração no Database Migration Service, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Esses papéis predefinidos contêm as permissões necessárias para realizar migrações homogêneas do SQL Server com o Database Migration Service. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para realizar migrações homogêneas do SQL Server com o Database Migration Service:

  • datamigration.*
  • resourcemanager.projects.get
  • resourcemanager.projects.list
  • cloudsql.instances.create
  • cloudsql.instances.get
  • cloudsql.instances.list
  • cloudsql.databases.get
  • cloudsql.databases.delete
  • cloudsql.operations.get
  • compute.machineTypes.list
  • compute.machineTypes.get
  • compute.projects.get
  • storage.buckets.create
  • storage.buckets.list
  • storage.objects.list

Essas permissões também podem ser concedidas com papéis personalizados ou outros papéis predefinidos.

Definir configurações e criar um job de migração

Para criar um job de migração, siga estas etapas:

Console

  1. No console do Google Cloud , acesse a página Jobs de migração.

    Acessar Jobs de migração

  2. Clique em Criar job de migração.

    A página do assistente de configuração do job de migração é aberta. Esse assistente contém vários painéis que orientam você em cada etapa da configuração.

    É possível pausar a criação de um job de migração a qualquer momento clicando em SALVAR E SAIR. Todos os dados inseridos até esse ponto são salvos em um rascunho de job de migração. É possível concluir o rascunho do job de migração mais tarde. Consulte Atualizar um job de migração de rascunho.

  3. Na página Começar, insira as seguintes informações:
    • Nome do job de migração

      Este é um nome legível por humanos para o job de migração. Esse valor é exibido no console do Google Cloud .

    • ID da tarefa de migração

      Este é um identificador legível por máquina para seu job de migração. Use esse valor para trabalhar com jobs de migração usando os comandos da CLI do Google Cloud ou a API do Database Migration Service.

    • Na lista Mecanismo de banco de dados de origem, selecione SQL Server ou Amazon RDS para SQL Server.

    Os campos Mecanismo do banco de dados de destino e Tipo de job de migração são preenchidos automaticamente e não podem ser alterados.

  4. Clique em Salvar e continuar.
  5. Na página Definir sua origem, faça o seguinte:
    1. Use o menu suspenso para selecionar o perfil de conexão de origem.

      Se você ainda não tiver um perfil de conexão de origem, clique em Criar perfil de conexão diretamente no menu suspenso. Para mais informações sobre como criar perfis de conexão, consulte Criar um perfil de conexão de origem.

    2. Se você quiser usar um arquivo de backup diferencial na migração, na seção Personalizar configurações de origem, marque a caixa de seleção Usar backups diferenciais.

      Os backups diferenciais são úteis se você precisar replicar muitos dados que apareceram no banco de dados desde o backup completo e quiser processá-los em massa, em vez de fazer upload de vários arquivos de registro de transações. Para mais informações sobre os tipos de backup compatíveis, consulte Tipos de arquivo de backup compatíveis.

      Se você usar backups diferenciais, crie a pasta diff no bucket do Cloud Storage. Consulte Armazenar arquivos de backup em um bucket do Cloud Storage.

    3. Clique em Salvar e continuar.
  6. Na página Definir um destino, use o menu suspenso para selecionar o perfil de conexão de destino.

    Se você ainda não tiver um perfil de conexão de destino, clique em Criar perfil de conexão diretamente no menu suspenso. Para mais informações sobre como criar perfis de conexão, consulte Criar um perfil de conexão de destino.

  7. Clique em Salvar e continuar.
  8. Na página Configurar bancos de dados de migração, faça o seguinte:
    1. Na seção Selecionar bancos de dados para migrar, use as caixas de seleção para escolher quais bancos de dados você quer incluir neste job de migração. Essa lista é preenchida com base nas pastas que você criou no bucket do Cloud Storage para os arquivos de backup.

      É possível adicionar e remover bancos de dados do job de migração mais tarde. Consulte Adicionar ou remover bancos de dados de um job de migração.

    2. (Opcional) Se você usa backups criptografados, forneça as chaves de criptografia para eles. Para mais detalhes sobre o uso de backups criptografados, consulte Usar backups criptografados.

      Execute estas ações:

      • Clique em Editar detalhes ao lado do banco de dados selecionado para migração.

        O painel lateral Criptografia é aberto.

      • Use os menus suspensos Chave de criptografia para selecionar suas chaves.
      • No campo Senha, digite a senha da chave de criptografia.
      • Clique em Salvar e sair.
  9. Clique em Salvar e continuar.
  10. Em Testar e criar job de migração, realize as seguintes ações:
    1. (Opcional) Clique em Testar job para verificar se o Database Migration Service pode identificar todos os arquivos de backup e estabelecer as conexões de rede necessárias.

      Se o teste falhar, consulte as mensagens de erro para resolver o problema e execute o teste novamente. Para mais informações sobre possíveis erros, consulte Diagnosticar problemas.

    2. Clique em Criar e iniciar job para começar a migração.

      Se você quiser realizar o job de migração em outro momento, clique em Salvar e volte mais tarde para executar o job. Consulte Iniciar um job de migração.

gcloud

Este exemplo usa a flag opcional --no-async para que todas as operações sejam realizadas de forma síncrona. Isso significa que alguns comandos podem levar um tempo para serem concluídos. É possível pular a flag --no-async para executar comandos de forma assíncrona. Se fizer isso, use o comando gcloud database-migration operations describe para verificar se a operação foi bem-sucedida.

Antes de usar os dados do comando abaixo, faça estas substituições:

  • MIGRATION_JOB_ID por um identificador legível por máquina para o job de migração. Use esse valor para trabalhar com jobs de migração usando os comandos da CLI do Google Cloud ou a API do Database Migration Service.
  • REGION pelo identificador da região em que você quer salvar o job de migração.
  • MIGRATION_JOB_NAME por um nome legível por humanos para o job de migração. Esse valor é exibido no Database Migration Service no console do Google Cloud .
  • SOURCE_CONNECTION_PROFILE_ID por um identificador legível por máquina do perfil de conexão de origem.
  • DESTINATION_CONNECTION_PROFILE_ID pelo identificador legível por máquina do perfil de conexão de destino.
  • COMMA_SEPARATED_DATABASE_ID_LIST por uma lista separada por vírgulas de identificadores de banco de dados do SQL Server que você quer migrar dos arquivos de backup. Esses identificadores precisam ser iguais aos nomes das pastas do banco de dados no Cloud Storage.

    Por exemplo: --sqlserver-databases=my-business-database,my-other-database

  • Configuração de backup diferencial: se você usar arquivos de backup diferencial para a migração, adicione a flag --sqlserver-diff-backup ao comando. Por padrão, os jobs de migração não usam arquivos de backup diferencial e ignoram a pasta diff no bucket do Cloud Storage.

    Para mais informações sobre os arquivos de backup aceitos, consulte Tipos de arquivos de backup aceitos.

  • (Opcional) MAPPING_FILE_FOR_PATHS_TO_ENCRYPTION_KEYS com o caminho do disco local para um arquivo de configuração que mapeia caminhos para chaves de criptografia no Cloud Storage com os identificadores de banco de dados relevantes. Para mais informações sobre como criar esse arquivo de mapeamento, consulte Usar backups criptografados.

    Por exemplo: --sqlserver-encrypted-databases=~/encryption-keys-mapping-file.json

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud database-migration migration-jobs \
create MIGRATION_JOB_ID \
  --no-async \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME \
  --source=SOURCE_CONNECTION_PROFILE_ID \
  --destination=DESTINATION_CONNECTION_PROFILE_ID \
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST \
  --sqlserver-encrypted-databases=MAPPING_FILE_FOR_PATHS_TO_ENCRYPTION_KEYS \
  --type=CONTINUOUS

Windows (PowerShell)

gcloud database-migration migration-jobs `
create MIGRATION_JOB_ID `
  --no-async `
  --region=REGION `
  --display-name=MIGRATION_JOB_NAME `
  --source=SOURCE_CONNECTION_PROFILE_ID `
  --destination=DESTINATION_CONNECTION_PROFILE_ID `
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST `
  --sqlserver-encrypted-databases=MAPPING_FILE_FOR_PATHS_TO_ENCRYPTION_KEYS `
  --type=CONTINUOUS

Windows (cmd.exe)

gcloud database-migration migration-jobs ^
create MIGRATION_JOB_ID ^
  --no-async ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME ^
  --source=SOURCE_CONNECTION_PROFILE_ID ^
  --destination=DESTINATION_CONNECTION_PROFILE_ID ^
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST ^
  --sqlserver-encrypted-databases=MAPPING_FILE_FOR_PATHS_TO_ENCRYPTION_KEYS ^
  --type=CONTINUOUS

Você receberá uma resposta semelhante a esta:

Waiting for migration job [MIGRATION_JOB_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created migration job MIGRATION_JOB_ID [OPERATION_ID]
Resultado

O job de migração foi criado. Você pode prosseguir com o processo de migração:

A seguir