Configurar o ambiente

Nesta página, você vai conhecer as etapas de configuração necessárias para usar a API Cloud Spanner com a Google Cloud CLI, as bibliotecas de cliente e os drivers do Spanner.

Se você quiser usar o Spanner com o console do Google Cloud , consulte o Guia de início rápido sobre como usar o console.

Funções exigidas

Para ter as permissões necessárias para usar e interagir com bancos de dados do Spanner, peça ao administrador para conceder a você os seguintes papéis do IAM:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Configurar um projeto do Google Cloud

  1. Acesse a página Projetos no console do Google Cloud .

    Acessar a página "Projetos"

  2. Crie um novo projeto Google Cloud ou abra um projeto atual clicando no nome dele.

  3. Abra uma janela de terminal e defina seu projeto como o padrão da Google Cloud CLI, substituindo MY_PROJECT_ID pelo ID (e 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 é possível saber mais sobre os preços do Spanner.

  5. Ative a API Cloud Spanner para o projeto.

    Ativar a API Cloud Spanner

    Observação: se você usar uma conta de serviço em um projeto diferente para acessar sua instância do Spanner, será necessário ativar a API do Spanner nos dois projetos.

Configurar 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 do Google Cloud. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando: 

gcloud init

Se você estiver usando um provedor de identidade externo (IdP), primeiro faça login na CLI gcloud com sua identidade federada.

Para configurar a CLI da gcloud para usar a representação da conta de serviço para autenticação nas APIs do Google, em vez de suas credenciais de usuário, execute o seguinte comando: 

gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

Para mais informações, consulte Identidade temporária de conta de serviço.

Terraform

Para usar o código do Terraform em um ambiente de desenvolvimento local, instale e inicialize a gcloud CLI e configure o Application Default Credentials com suas credenciais de usuário.

    Instale a CLI do Google Cloud.

    Se você estiver usando um provedor de identidade externo (IdP), primeiro faça login na CLI gcloud com 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.

Confira mais informações em Set up authentication for a local development environment.

Bibliotecas de cliente

Para usar bibliotecas de cliente em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e configure o Application Default Credentials com suas credenciais de usuário.

    Instale a CLI do Google Cloud.

    Se você estiver usando um provedor de identidade externo (IdP), primeiro faça login na CLI gcloud com 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.

Confira mais informações em Set up authentication for a local development environment.

Para configurar o arquivo ADC local para usar a identidade temporária de conta de serviço para autenticação nas APIs do Google, em vez de suas credenciais de usuário, execute o seguinte comando: 

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

Para mais informações, consulte Identidade temporária de conta de serviço.

REST

Para usar a API REST em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

    Instale a CLI do Google Cloud.

    Se você estiver usando um provedor de identidade externo (IdP), primeiro faça login na CLI gcloud com sua identidade federada.

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

É possível usar a representação de conta de serviço para gerar um token de acesso para solicitações da API REST.identidade temporária de conta de serviço Para mais informações, consulte Conta de serviço representada.

Executar a Google Cloud CLI

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

gcloud spanner instance-configs list

Você vai ver uma lista das configurações de instância do Spanner que seu projeto pode acessar, incluindo configurações regionais, birregionais e multirregionais. Para mais informações, consulte a visão geral das instâncias.

Você concluiu a configuração!

A seguir

Saiba como usar as bibliotecas de cliente e os drivers do Cloud para criar uma instância, um banco de dados, tabelas e índices do Spanner. Em seguida, armazene, consulte e leia dados no Spanner.