Configure a ferramenta de migração do Spanner

Este documento descreve como instalar e executar a ferramenta de migração do Spanner (SMT) no Cloud Shell. Para mais informações sobre a SMT, consulte a 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 CLI Google Cloud.
  4. Para inicializar a CLI Google Cloud, execute o comando gcloud init.

    5. Instale a ferramenta de migração do Spanner

    Pode instalar o SMT através de um comando da shell do Linux ou da Google Cloud CLI:

    Shell do Linux

    Para instalar o SMT, execute o seguinte comando:

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

    gcloud

    Pode instalar o SMT através do comando gcloud components install:

      gcloud components install spanner-migration-tool

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

    Aceda à ferramenta de migração do Spanner

    Pode usar o comando gcloud alpha spanner migrate para aceder e usar o SMT.

    Para iniciar a IU Web do SMT, pode executar o seguinte comando:

      gcloud alpha spanner migrate web

    Tem de fornecer as suas Google Cloud credenciais para permitir que o SMT aceda aos recursos. Clique em http://localhost:8080 na resposta ao comando anterior para abrir a IU Web.

    Associe ao Spanner

    Para se ligar ao Spanner através da IU Web do SMT, faça o seguinte:

    1. Clique no botão de edição para configurar a ligação ao Spanner.

    2. Especifique as seguintes informações para estabelecer ligação ao Spanner:

      • ID do projeto: o ID do projeto onde se encontra a sua instância do Spanner.
      • ID da instância: o ID da instância do Spanner.

    3. Clique em Guardar.

    Faça a ligação à base de dados de origem

    Tem de estabelecer ligação à base de dados de origem através da IU Web do SMT, fornecendo as seguintes informações:

    • Database Engine: especifique se a base de dados de origem é MySQL, SQL Server, Oracle ou PostgreSQL.
    • Nome do anfitrião: o endereço IP da base de dados de origem.
    • Porta: a porta onde a base de dados de origem está acessível.
    • Nome de utilizador: o nome de utilizador da base de dados de origem.
    • Palavra-passe: a palavra-passe da base de dados de origem.
    • Dialeto do Spanner: especifique se quer usar o GoogleSQL ou o PostgreSQL.

    Depois de introduzir as informações, pode estabelecer ligação à base de dados de origem clicando em Testar ligação e, de seguida, em Ligar.

    O que se segue?