Configurar a ferramenta de migração do Spanner

Este documento descreve como instalar e executar a ferramenta de migração do Spanner (SMT, na sigla em inglês) no Cloud Shell. Para mais informações sobre a SMT, consulte Ferramenta de migração do Spanner.

Antes de começar

  1. Faça login na sua Google Cloud conta do. Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US $300 em créditos para executar, testar e implantar cargas de trabalho.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

  6. Instale a Google Cloud CLI.
  7. Para inicializar a Google Cloud CLI, execute o comando gcloud init.

Instalar a ferramenta de migração do Spanner

É possível instalar a SMT usando um comando de shell do Linux ou a Google Cloud CLI:

Shell do Linux

Para instalar a SMT, execute o seguinte comando:

  sudo apt-get install google-cloud-sdk-spanner-migration-tool

gcloud

É possível instalar a SMT usando o gcloud components install comando:

  gcloud components install spanner-migration-tool

Para mais informações sobre como instalar a SMT, consulte Instalar a ferramenta de migração do Spanner.

Acessar a ferramenta de migração do Spanner

É possível usar o gcloud alpha spanner migrate comando para acessar e usar a SMT.

Para iniciar a UI da Web da SMT, execute o seguinte comando:

  gcloud alpha spanner migrate web

Você precisa fornecer suas Google Cloud credenciais para permitir que a SMT acesse recursos. Clique em http://localhost:8080 na resposta ao comando anterior para abrir a UI da Web.

Conectar ao Spanner

Para se conectar ao Spanner usando a UI da Web da SMT, faça o seguinte:

  1. Clique no botão de edição para configurar a conexão com o Spanner.

  2. Especifique as seguintes informações para se conectar ao Spanner:

    • ID do projeto: o ID do projeto em que a instância do Spanner está.
    • ID da instância: o ID da instância do Spanner.

  3. Clique em Salvar.

Conectar ao banco de dados de origem

É necessário se conectar ao banco de dados de origem usando a UI da Web da SMT, fornecendo as seguintes informações:

  • Mecanismo de banco de dados: especifique se o banco de dados de origem é MySQL, SQL Server, Oracle ou PostgreSQL.
  • Nome do host: o endereço IP do banco de dados de origem.
  • Porta: a porta em que o banco de dados de origem está acessível.
  • Nome de usuário: o nome de usuário do banco de dados de origem.
  • Senha: a senha do banco de dados de origem.
  • Dialeto do Spanner: especifique se você quer usar o GoogleSQL ou PostgreSQL.

Depois de inserir as informações, você pode se conectar ao banco de dados de origem clicando em Testar conexão e, em seguida, clicando em Conectar.

A seguir