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

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