Criar um job de migração para uma nova instância de destino

MySQL   |  PostgreSQL   |  PostgreSQL para AlloyDB

A criação de um job de migração inclui:

• Definir as configurações do job de migração.
• Especificar informações sobre o perfil de conexão que você criou para seu banco de dados de origem (perfil de conexão de origem).
• Definir configurações para a instância de banco de dados de destino do Cloud SQL e criar a instância.
• Configurar a conectividade entre as instâncias de banco de dados de origem e destino.
• Testar o job de migração para garantir que as informações de conexão fornecidas para o job sejam válidas.

Observação: para conectividade de IP privado, ao migrar para uma instância do Cloud SQL criada com o Database Migration Service, só é possível usar o método de acesso a serviços privados (peering de VPC). Se você quiser usar o Private Service Connect com o cluster de destino, primeiro crie a instância de destino diretamente no Cloud SQL e siga as etapas na página Migrar para uma instância atual.

Para criar um job de migração para uma nova instância de destino, faça o seguinte:

Console

Definir configurações para o job de migração

1. No console 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 mostram cada etapa de 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. Você pode concluir o rascunho do job de migração depois.

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

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

   2. ID do job de migração

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

   3. Na lista Mecanismo de banco de dados de origem, selecione MySQL.

      O campo Mecanismo do banco de dados de destino é preenchido automaticamente e não pode ser alterado.

   4. Selecione a região em que você salva o job de migração.

      O Database Migration Service é um produto totalmente regional. Isso significa que todas as entidades relacionadas à sua migração (perfis de conexão de origem e destino, jobs de migração, bancos de dados de destino) precisam ser salvas em uma única região. Selecione a região com base na localização dos serviços que precisam dos seus dados, como instâncias do Compute Engine ou apps do App Engine, entre outros serviços. Depois de escolher a região de destino, não será possível mudar essa seleção.

      Importante:se você planeja usar a edição Enterprise Plus do Cloud SQL para MySQL, verifique se a região é compatível com essa edição. Consulte Suporte a regiões do Cloud SQL para MySQL Enterprise Plus.
4. Clique em Salvar e continuar.

Especificar informações sobre o perfil de conexão de origem

Na página Definir uma origem, siga estas etapas:

1. No menu suspenso Perfil de conexão de origem, selecione o perfil de conexão do banco de dados de origem.
2. Na seção Personalizar a configuração de despejo completo, clique em Editar configuração.
3. No painel Editar configuração de despejo completo, no menu suspenso Método de despejo completo, selecione uma das seguintes opções:
   • Baseado em arquivo físico: selecione essa opção se quiser usar o utilitário Percona XtraBackup para fornecer seu próprio arquivo de backup. Essa abordagem exige etapas de preparação adicionais. Para conferir o guia completo sobre como usar arquivos de backup físico gerados pelo Percona XtraBackup, consulte Migrar seus bancos de dados usando um arquivo físico do Percona XtraBackup.
   • Baseado em lógica: selecione essa opção se quiser usar um arquivo de backup lógico criado pelo utilitário mysqlshell. O Database Migration Service pode gerar automaticamente esse arquivo de backup para você, ou você pode fornecer sua própria cópia.
4. Edite as outras configurações de despejo. Faça uma destas ações:
   • Se você usar o arquivo de backup físico, em Forneça sua pasta, clique em Procurar e selecione a pasta em que você fez upload do arquivo dump completo. Selecione a pasta dedicada que contém o arquivo de backup completo, e não o bucket de armazenamento em si.

   • Se você usar um arquivo de backup lógico, configure o paralelismo de despejo de dados ou as flags de despejo.

     Expanda esta seção para conferir as etapas completas do arquivo de backup lógico

     Na seção Escolha como gerar seu arquivo de despejo, use uma das seguintes opções:

     1. Gerar automaticamente o despejo inicial (recomendado)

        Essa opção é recomendada porque o Database Migration Service sempre gera um arquivo dump inicial do banco de dados depois que o job de migração é criado e iniciado.

        O Database Migration Service usa esse arquivo para reproduzir as definições de objeto originais e os dados de tabela do banco de dados de origem para que essas informações possam ser migradas para uma instância de banco de dados de destino do Cloud SQL.

        Se você usar o despejo gerado automaticamente, selecione o tipo de operação que o Database Migration Service vai realizar na seção Configurar operação de despejo de dados:

        • Paralelismo de despejo de dados: use uma opção de paralelismo de alta performance, disponível ao migrar para as versões 5.7 ou 8 do MySQL.
          Se você optar por usar o paralelismo de carga, forneça os privilégios necessários no banco de dados de origem para seu cenário (como LOCK_TABLES). Para mais informações sobre as permissões necessárias para bancos de dados de origem, consulte Configurar banco de dados de origem.

          A velocidade do paralelismo de dados está relacionada à quantidade de carga induzida no banco de dados de origem:

          • Ideal (recomendado): performance equilibrada com carga ideal no banco de dados de origem.
          • Máximo: oferece as maiores velocidades de despejo, mas pode aumentar a carga no banco de dados de origem.
          • Mínimo: usa a menor quantidade de recursos de computação no banco de dados de origem, mas pode ter uma taxa de transferência de despejo mais lenta.
        • Flags de despejo: essa opção é exclusiva com Paralelismo de despejo de dados. Use essa configuração para definir diretamente flags para o utilitário mysqldump usado para criar o arquivo dump.

          Para adicionar uma flag:

          1. Clique em ADICIONAR FLAG.

          2. Selecione uma das seguintes flags:

             • add-locks: Essa flag envolve cada tabela contida no arquivo dump com instruções LOCK TABLES e UNLOCK TABLES. Isso resulta em inserções mais rápidas quando o arquivo dump é carregado na instância de destino.
             • ignore-error: Use esta flag para inserir uma lista de números de erros separados por vírgulas. Esses números representam os erros que o utilitário mysqldump vai ignorar.
             • max-allowed-packet: Use esta flag para definir o tamanho máximo do buffer para comunicação entre o cliente MySQL e o banco de dados MySQL de origem. O tamanho padrão do buffer é de 24 MB, e o máximo é de 1 GB.
               Se você estiver usando colunas BLOB grandes ou strings longas nas tabelas do banco de dados de origem, aumente o tamanho do buffer para essa flag.
             Para mais informações sobre essas flags, consulte a documentação sobre o utilitário mysqldump no Manual de referência do MySQL 8.0.
          3. Clique em CONCLUÍDO.
          4. Repita essas etapas para cada flag que você quiser adicionar.

          Para remover uma flag, clique no ícone da lixeira à direita da linha que contém a flag.

     2. Fornecer a sua

        Essa opção não é recomendada porque, por padrão, o Database Migration Service realiza um despejo inicial como parte da execução do job de migração.

        Se você quiser usar seu próprio arquivo dump, selecione Fornecer o próprio, clique em PROCURAR, selecione o arquivo (ou a pasta inteira do Cloud Storage se você usar vários arquivos) e clique em SELECIONAR.

        Verifique se o despejo foi gerado nas últimas 24 horas e atende aos requisitos de despejo.

5. Clique em Salvar e continuar.

Configurar e criar a instância de destino do Cloud SQL

1. Na página Definir um destino, no menu suspenso Tipo de instância de destino, selecione Nova instância. Defina todas as configurações relevantes:
   1. No campo ID da instância de destino, forneça um identificador para a instância do Cloud SQL ou use o identificador gerado automaticamente.

      Não inclua informações sensíveis ou de identificação pessoal no identificador. Não é necessário incluir o ID do projeto no nome da instância. Isso é feito automaticamente quando necessário, como nos arquivos de registros.

   2. No campo Senha, forneça uma senha alfanumérica para a instância de destino do Cloud SQL. Esta é a senha da conta de administrador root na instância.

      Insira a senha manualmente ou clique em Gerar para que o Database Migration Service crie uma automaticamente.

   3. No menu suspenso Versão do banco de dados, escolha a versão do banco de dados para a instância de destino.

      Clique em Mostrar versões secundárias para conferir todas as versões secundárias. Saiba mais sobre o suporte à migração entre versões.

   4. Selecione a edição do Cloud SQL para MySQL da instância de destino. Há duas opções disponíveis: Cloud SQL para MySQL Enterprise e Cloud SQL para MySQL Enterprise Plus.

      As edições do Cloud SQL para MySQL vêm com diferentes conjuntos de recursos, tipos de máquinas disponíveis e preços. Consulte a documentação do Cloud SQL para escolher a edição adequada às suas necessidades. Para mais informações, consulte Introdução às edições do Cloud SQL para MySQL.

   5. O menu Região mostra a mesma região selecionada na página Começar.

      Se você estiver configurando a instância para alta disponibilidade, selecione Várias zonas (altamente disponível). É possível selecionar a zona primária e a secundária. As condições a seguir se aplicam quando a zona secundária é usada durante a criação da instância:

      • As zonas padrão são Qualquer para a zona primária e Qualquer (diferente da primária) para a zona secundária.
      • Se as zonas primária e secundária forem especificadas, elas precisarão ser diferentes.
   6. Na seção Conexões, escolha se quer adicionar um endereço IP público ou particular para a instância de destino. É possível configurar a instância para ter os dois tipos de endereços IP, mas pelo menos um tipo é necessário para a migração. Selecione uma destas opções:
      • Se você quiser migrar usando o peering de VPC ou um túnel SSH reverso, selecione IP privado.

        • Para ativar a conectividade de IP particular, confira se você atende a todos os requisitos de rede adicionais.

          Expanda esta seção para conferir todos os requisitos de IP particular.

          • A API Service Networking está ativada. É possível ativar a API Service Networking usando o console Google Cloud .
          • Você tem a permissão servicenetworking.services.addPeering do IAM.
          • Você configurou o acesso a serviços particulares para seu projeto, para o qual é necessário ter o papel compute.networkAdmin do IAM.
          • Há pelo menos uma rede VPC não legada no seu projeto ou uma rede VPC compartilhada.
          • Se você estiver usando uma rede VPC compartilhada, também precisará fazer o seguinte:
            • Ativar a API Service Networking no projeto host
            • Adicionar o usuário ao projeto host
            • Conceda ao usuário o papel do IAM compute.networkAdmin no projeto host.
        • Selecione a rede VPC associada para fazer peering. Se você planeja se conectar à origem da migração usando o peering de VPC, escolha a VPC em que a instância está localizada.
        • Se uma rede de serviço gerenciado nunca foi configurada para a VPC selecionada, você pode escolher um intervalo de IP e clicar em Conectar ou usar um intervalo de IP selecionado automaticamente e clicar em Alocar e conectar.
      • Se você quiser migrar pela Internet usando uma lista de permissões de IP, selecione IP público.
        

        Opcionalmente, em IP público, clique no campo Redes autorizadas e autorize uma rede ou um proxy a se conectar à instância do Cloud SQL. As redes só são autorizadas com os endereços que você fornece. Consulte Configurar IP público na documentação do Cloud SQL.

      A configuração da conectividade do job de migração é feita em uma etapa posterior. Para saber mais sobre os métodos de rede disponíveis, consulte Configurar a conectividade.

2. Selecione o tipo de máquina para a instância do Cloud SQL. O tamanho do disco precisa ser igual ou maior que o tamanho do banco de dados de origem. Saiba mais sobre os tipos de máquinas do MySQL.
   Observação:as máquinas disponíveis na seleção Tipo de máquina dependem da edição do Cloud SQL que você usa.
3. Para o Cloud SQL para MySQL Enterprise Plus: marque a caixa de seleção Ativar cache de dados se quiser usar o recurso de cache de dados no banco de dados de destino.

   O cache de dados é um recurso opcional disponível para instâncias da edição Enterprise Plus do Cloud SQL para MySQL que adiciona uma unidade de estado sólido local de alta velocidade ao banco de dados de destino. Esse recurso pode gerar custos extras para o Cloud SQL. Para mais informações sobre o cache de dados, consulte Visão geral do cache de dados na documentação do Cloud SQL.

4. Especifique o tipo de armazenamento da instância do Cloud SQL. Você pode escolher uma unidade de estado sólido (SSD) ou uma unidade de disco rígido (HDD).
5. Especifique a capacidade de armazenamento (em GBytes) da instância do Cloud SQL.

   Verifique se a instância tem capacidade de armazenamento suficiente para processar os dados do banco de dados de origem. É possível aumentar essa capacidade a qualquer momento, mas não diminuí-la.

6. (Opcional) Configure as opções de criptografia de dados ou rótulos de recursos para sua instância de destino.

   Expanda esta seção para conferir as etapas opcionais.

   Clique em Mostrar configurações opcionais e faça o seguinte:

   1. Especifique se você quer gerenciar a criptografia dos dados migrados da origem para o destino. Por padrão, seus dados são criptografados com uma chave gerenciada pelo Google Cloud. Se você quiser gerenciar a criptografia, use uma chave de criptografia gerenciada pelo cliente (CMEK). Para fazer isso, siga estas etapas:

      1. Marque a caixa de seleção Usar uma chave de criptografia gerenciada pelo cliente (CMEK).
      2. No menu Selecionar uma chave gerenciada pelo cliente, escolha sua CMEK.

      Se você não encontrar sua chave, clique em Inserir nome do recurso da chave para informar o nome do recurso da chave que você quer usar. Exemplo de nome de recurso da chave: projects/my-project-name/locations/my-location/keyRings/my-keyring/cryptoKeys/my-key.

      Ao criar o job de migração, o Database Migration Service verifica se a CMEK existe e se o serviço tem permissões para usar a chave.

      Se o Database Migration Service não tiver essas permissões, informações vão aparecer especificando que a conta de serviço do Database Migration Service não pode usar a CMEK. Clique em Conceder para dar permissões ao Database Migration Service para usar a chave.

      Para mais informações sobre como criar uma CMEK, consulte Como usar chaves de criptografia gerenciadas pelo cliente (CMEK).

   2. Adicione as flags necessárias para serem aplicadas ao servidor de banco de dados. Se possível, verifique se as flags de banco de dados na instância de destino do Cloud SQL criada são as mesmas do banco de dados de origem. Saiba mais sobre as flags de banco de dados compatíveis com o MySQL.
   3. Adicione os rótulos específicos da instância do Cloud SQL.

      Os rótulos ajudam a organizar as instâncias. Por exemplo, é possível organizar rótulos por centro de custos ou ambiente. Os rótulos também são incluídos na fatura para que você veja a distribuição de custos entre eles.

7. Clique em Criar destino e continuar. O Database Migration Service está criando sua instância de destino do Cloud SQL. Esse processo pode levar vários minutos.
   Ponto principal:

   • O Database Migration Service cria uma instância do Cloud SQL que será cobrada de acordo com a configuração especificada. Se o fluxo de criação do job de migração for interrompido antes da conclusão, use o botão Cancelar para limpar a instância do Cloud SQL. Se o navegador ou a guia for fechada, se você clicar em Salvar e sair ou se sair da tela, a instância do Cloud SQL não será limpa e precisará ser excluída manualmente na página "Instâncias do Cloud SQL".
   • Depois que a instância de destino é criada, as configurações da instância do Cloud SQL não podem mais ser editadas no console do Database Migration Service. Você ainda pode acessar a instância diretamente no console do Cloud SQL para modificá-la.

Configurar a conectividade entre as instâncias de banco de dados de origem e destino

No menu suspenso Método de conectividade, selecione um método de conectividade de rede. Esse método define como a instância do Cloud SQL recém-criada se conectará ao banco de dados de origem. Os métodos de conectividade de rede atuais incluem lista de permissões de IP, túnel SSH reverso e peering de VPC.

Se você quiser usar...	Faça o seguinte:
O método de conectividade de rede da lista de permissões de IP,	É necessário especificar o endereço IP de saída da instância de destino. Se a instância do Cloud SQL criada for de alta disponibilidade, inclua os endereços IP de saída das instâncias primária e secundária.
O método de conectividade de rede do túnel SSH reverso.	Selecione a instância de VM do Compute Engine que vai hospedar o túnel. Depois de especificar a instância, o Google vai fornecer um script que executa as etapas para configurar o túnel entre os bancos de dados de origem e de destino. Você precisará executar o script na Google Cloud CLI. Execute os comandos em uma máquina que tenha conectividade com o banco de dados de origem e com Google Cloud.
O método de conectividade de rede de peering de VPC,	Selecione a rede VPC em que o banco de dados de origem está localizado. A instância do Cloud SQL será atualizada para se conectar a essa rede.

Depois de selecionar e configurar a conectividade de rede, clique em Configurar e continuar.

Testar, criar e executar o job de migração

Nesta etapa final, revise o resumo das configurações do job de migração, da origem, do destino e do método de conectividade. Em seguida, teste a validade da configuração do job de migração. Se houver problemas, modifique as configurações do job de migração. Nem todas as configurações podem ser editadas.

1. Na página Testar e criar job de migração, clique em Testar job.

   Se o teste falhar, você pode resolver o problema na parte do fluxo destinada a isso e refazer o teste. Para informações sobre como resolver problemas de um teste de job de migração com falha, consulte Diagnosticar problemas do MySQL.

2. Quando o teste do job de migração terminar, clique em Criar e iniciar job para criar e iniciar o job de migração imediatamente ou em Criar job para criar o job de migração sem iniciá-lo imediatamente.

   Se o job não for iniciado no momento da criação, ele poderá ser iniciado na página Jobs de migração clicando em INICIAR. Independente de quando o job de migração começa, sua organização é cobrada pela existência da instância de destino.

   Sua migração está em andamento. Quando você inicia o job de migração, o Database Migration Service começa o despejo completo, bloqueando brevemente o banco de dados de origem. Se a origem estiver no Amazon RDS ou no Amazon Aurora, o Database Migration Service também vai precisar de um período curto de inatividade na gravação (aproximadamente menos de um minuto) no início da migração. Para mais informações, consulte Limitações conhecidas.

   Atenção:se você usou o Terraform para provisionar o banco de dados de destino, pode haver desvio de configuração durante a execução do job de migração. Não tente reaplicar as configurações do Terraform antes da conclusão da migração. Para mais informações, consulte Desvio de configuração do Terraform.
3. Acesse Revisar o job de migração.

gcloud

1. Crie o perfil de conexão de destino.
   Ao migrar para uma nova instância de destino com a Google Cloud CLI, você cria a instância de destino e o perfil de conexão em uma única ação.
   Execute o comando a seguir (clique no link para expandir):

   gcloud database-migration connection-profiles create cloudsql

   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. Você pode pular a flag --no-async para executar comandos de forma assíncrona. Se você 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:

   • CONNECTION_PROFILE_ID com um identificador legível por máquina para seu perfil de conexão.
   • DATABASE_VERSION com a versão do MySQL que você quer usar na instância de destino. As versões do banco de dados são especificadas como strings que incluem as versões principal e secundária. Por exemplo: MYSQL_8_0, MYSQL_8_0_32, MYSQL_8_0_36.

     Para todas as versões possíveis do MySQL, consulte a referência da flag --database-version.

   • (Opcional) EDITION Por padrão, as novas instâncias criadas com a Google Cloud CLI usam o Cloud SQL para MySQL Enterprise Plus. Se você planeja usar o Cloud SQL para MySQL Enterprise Plus, confira se a região é compatível com essa edição. Consulte Suporte a regiões do Cloud SQL para MySQL Enterprise Plus.

     É possível mudar a edição usando a flag --edition com um dos seguintes valores:

     • enterprise-plus para a edição Enterprise Plus do Cloud SQL para MySQL
     • enterprise para a edição Enterprise do Cloud SQL para MySQL
   • TIER com o nome do tipo de máquina do Cloud SQL que você quer usar. Os tipos de máquina são especificados como strings que seguem a convenção do Cloud SQL, por exemplo, db-n1-standard-1, db-perf-optimized-N-2. Para uma lista completa dos tipos de máquinas disponíveis e seus identificadores para uso com a Google Cloud CLI, consulte Tipos de máquinas na documentação do Cloud SQL para MySQL.

     As instâncias criadas com a Google Cloud CLI usam por padrão a edição Enterprise Plus do Cloud SQL para MySQL, que tem diferentes tipos de máquina disponíveis. Se você quiser usar um tipo de máquina disponível apenas na edição Enterprise do Cloud SQL para MySQL, use a flag opcional --edition=enterprise para especificar a edição.

   • REGION com o identificador da região em que você quer salvar o perfil de conexão.

     Por padrão, as novas instâncias criadas com a Google Cloud CLI usam o Cloud SQL para MySQL Enterprise Plus. Se você planeja usar o Cloud SQL para MySQL Enterprise Plus, verifique se a região é compatível com essa edição. Consulte Suporte a regiões do Cloud SQL para MySQL Enterprise Plus. É possível mudar a edição usando a flag opcional --edition.

   • (Opcional) CONNECTION_PROFILE_NAME com um nome legível para seu perfil de conexão. Esse valor é exibido no console Google Cloud .
   • Configuração de rede

     Por padrão, as novas instâncias criadas com a Google Cloud CLI têm um endereço IP público atribuído e são configuradas para usar a conectividade de IP público. Você pode usar outros métodos de conectividade. Para mais informações, consulte Configurar a conectividade.

     Não é necessário usar flags adicionais se você quiser usar a conectividade de IP público. Se você quiser usar a conectividade de IP particular com o peering de rede VPC ou um túnel SSH reverso, verifique se você atende aos seguintes requisitos de rede adicionais para ativar a conectividade de IP particular e inclua flags adicionais no comando.

     Expanda esta seção para conferir todos os requisitos de IP particular.

     • A API Service Networking está ativada. É possível ativar a API Service Networking usando o console Google Cloud .
     • Você tem a permissão servicenetworking.services.addPeering do IAM.
     • Você configurou o acesso a serviços particulares para seu projeto, para o qual é necessário ter o papel compute.networkAdmin do IAM.
     • Há pelo menos uma rede VPC não legada no seu projeto ou uma rede VPC compartilhada.
     • Se você estiver usando uma rede VPC compartilhada, também precisará fazer o seguinte:
       • Ativar a API Service Networking no projeto host
       • Adicionar o usuário ao projeto host
       • Conceda ao usuário o papel do IAM compute.networkAdmin no projeto host.

     Inclua as seguintes flags adicionais se quiser usar a conectividade de IP particular (com peering de rede VPC ou com um túnel SSH reverso em uma VM do Compute Engine):

     • --no-enable-ip-v4: (opcional) para não atribuir um endereço IP público à instância de destino. É possível ter um endereço IP público e um particular atribuídos à instância de destino, mas talvez você não queira um endereço IP público se usar a conectividade de IP particular.
     • --private-network: para atribuir um endereço IP particular à instância de destino, especifique o nome da nuvem privada virtual em que você quer atribuir um endereço IP particular.

   Execute o seguinte comando:

   Linux, macOS ou Cloud Shell

   Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

   gcloud database-migration connection-profiles \
   create mysql CONNECTION_PROFILE_ID \
     --no-async \
     --region=REGION \
     --database-version=DATABASE_VERSION \
     --tier=TIER \
     --display-name=CONNECTION_PROFILE_NAME

   Windows (PowerShell)

   Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

   gcloud database-migration connection-profiles `
   create mysql CONNECTION_PROFILE_ID `
     --no-async `
     --region=REGION `
     --database-version=DATABASE_VERSION `
     --tier=TIER `
     --display-name=CONNECTION_PROFILE_NAME

   Windows (cmd.exe)

   Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

   gcloud database-migration connection-profiles ^
   create mysql CONNECTION_PROFILE_ID ^
     --no-async ^
     --region=REGION ^
     --database-version=DATABASE_VERSION ^
     --tier=TIER ^
     --display-name=CONNECTION_PROFILE_NAME

   Você receberá uma resposta semelhante a esta:

   Waiting for connection profile [CONNECTION_PROFILE_ID]
   to be created with [OPERATION_ID]
   
   Waiting for operation [OPERATION_ID] to complete...done.
   
   Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]
   

2. Crie o job de migração.
   Se você usar o peering de VPC ou uma conectividade de túnel SSH reverso, adicione as flags necessárias, como --peer-vpc, ou --vm, --vm-ip, --vm-port, --vpc. Para mais informações, consulte Configurar a conectividade e Exemplos da Google Cloud CLI.
   Execute o comando a seguir (clique no link para expandir):

   gcloud database-migration migration-jobs create

   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. Você pode pular a flag --no-async para executar comandos de forma assíncrona. Se você 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 com um identificador legível por máquina para seu job de migração. Você usa esse valor para trabalhar com jobs de migração usando comandos da CLI do Google Cloud ou a API do Database Migration Service.
   • REGION com o identificador da região em que você quer salvar o job de migração.
   • MIGRATION_JOB_NAME com um nome legível para o job de migração. Esse valor é exibido no Database Migration Service no console Google Cloud .
   • SOURCE_CONNECTION_PROFILE_ID com um identificador legível por máquina do perfil de conexão de origem.
   • DESTINATION_CONNECTION_PROFILE_ID com um identificador legível por máquina do perfil de conexão de destino.

   Execute o seguinte comando:

   Linux, macOS ou Cloud Shell

   Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

   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 \
     --type=MIGRATION_JOB_TYPE

   Windows (PowerShell)

   Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

   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 `
     --type=MIGRATION_JOB_TYPE

   Windows (cmd.exe)

   Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

   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 ^
     --type=MIGRATION_JOB_TYPE

   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]