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. 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

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

  3. Instale a Google Cloud CLI.
  4. 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 do 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