Configure o seu ambiente

Esta página explica os passos de configuração necessários para usar a API Cloud Spanner com a CLI do Google Cloud, as bibliotecas de cliente e os controladores do Spanner.

Se quiser usar o Spanner com a Google Cloud consola, consulte o Início rápido com a consola.

Funções necessárias

Para receber as autorizações de que precisa para usar e interagir com bases de dados do Spanner, peça ao seu administrador que lhe conceda as seguintes funções do IAM:

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Configure um Google Cloud projeto

  1. Aceda à página Projetos na Google Cloud consola.

    Aceda à página Projetos

  2. Crie um novo Google Cloud projeto ou abra um projeto existente clicando no nome do projeto.

  3. Abra uma janela de terminal e defina o seu projeto como o projeto predefinido para a CLI do Google Cloud, substituindo MY_PROJECT_ID pelo ID do projeto (não pelo nome do projeto): 

    gcloud config set project MY_PROJECT_ID

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

    5. Também pode saber mais sobre os preços do Spanner.

  5. Ative a API Cloud Spanner para o projeto.

    Ative a API Cloud Spanner

    Nota: se usar uma conta de serviço num projeto diferente para aceder à sua instância do Spanner, tem de ativar a API Spanner em ambos os projetos.

Configure a autenticação

Select the tabs for how you plan to access the API:

Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

gcloud

Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

gcloud init

Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

Para configurar a CLI gcloud para usar a representação de contas de serviço para autenticar em APIs Google, em vez das suas credenciais de utilizador, execute o seguinte comando: 

gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

Para mais informações, consulte o artigo Roubo de identidade de contas de serviço.

Terraform

Para usar o código do Terraform num ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure as Credenciais padrão da aplicação com as suas credenciais de utilizador.

    Instale a CLI Google Cloud.

    Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    If you're using a local shell, then create local authentication credentials for your user account: 

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

    If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

Para mais informações, consulte Set up authentication for a local development environment.

Bibliotecas cliente

Para usar bibliotecas de cliente num ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure as Credenciais padrão da aplicação com as suas credenciais de utilizador.

    Instale a CLI Google Cloud.

    Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    If you're using a local shell, then create local authentication credentials for your user account: 

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

    If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

Para mais informações, consulte Set up authentication for a local development environment.

Para configurar o ficheiro ADC local de modo a usar a representação da conta de serviço para autenticar as APIs Google, em vez das suas credenciais de utilizador, execute o seguinte comando: 

gcloud auth application-default login --impersonate-service-account=SERVICE_ACCT_EMAIL

Para mais informações, consulte o artigo Roubo de identidade de contas de serviço.

REST

Para usar a API REST num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

    Instale a CLI Google Cloud.

    Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

Para mais informações, consulte o artigo Autenticar para usar REST na Google Cloud documentação de autenticação.

Pode usar a representação da conta de serviço para gerar uma chave de acesso para pedidos da API REST. Para mais informações, consulte o artigo Conta de serviço roubada.

Execute a CLI do Google Cloud

Agora que configurou o ambiente de desenvolvimento e a autenticação, execute a ferramenta de linha de comandos gcloud para interagir com o Spanner:

gcloud spanner instance-configs list

Deve ver uma lista das configurações de instâncias do Spanner às quais o seu projeto pode aceder, incluindo configurações regionais, de duas regiões e multirregionais. Para mais informações, consulte a vista geral das instâncias.

Concluiu a configuração!

O que se segue?

Saiba como usar as bibliotecas e os controladores de clientes da nuvem para criar uma instância, uma base de dados, tabelas e índices do Spanner. Em seguida, armazene, consulte e leia dados no Spanner.