Configurar a ferramenta de migração do Spanner

Neste documento, descrevemos como instalar e executar a ferramenta de migração do Spanner (SMT) no Cloud Shell. Para mais informações sobre a SMT, consulte Ferramenta de migração do Spanner.

Antes de começar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  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 (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 (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 CLI do Google Cloud.
  7. Para inicializar a Google Cloud CLI, execute o comando gcloud init.

    8. Instalar a ferramenta de migração do Spanner

    É possível instalar o 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 comando gcloud components install:

      gcloud components install spanner-migration-tool

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

    Acessar a ferramenta de migração do Spanner

    Use o comando gcloud alpha spanner migrate para acessar e usar o SMT.

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

      gcloud alpha spanner migrate web

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

    Conectar ao Spanner

    Para se conectar ao Spanner usando a interface da Web do 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á localizada.
      • ID da instância: o ID da instância do Spanner.

    3. Clique em Salvar.

    Conectar ao banco de dados de origem

    Você precisa se conectar ao banco de dados de origem usando a interface da Web do SMT com 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 seu 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 o PostgreSQL.

    Depois de inserir as informações, clique em Testar conexão e em Conectar para se conectar ao banco de dados de origem.

    A seguir