Configurar o ambiente

Nesta página, você vai conferir 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.

Configurar um projeto do Google Cloud

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

    Acessar a página "Projetos"

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

  3. Abra uma janela de terminal e defina seu projeto como o projeto 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. Make sure 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 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

Install the Google Cloud CLI, then initialize it by running the following command: 

gcloud init

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.

  1. Install the Google Cloud CLI.

  2. To initialize the gcloud CLI, run the following command: 

    gcloud init

  3. 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.

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.

  1. Install the Google Cloud CLI.

  2. To initialize the gcloud CLI, run the following command: 

    gcloud init

  3. 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.

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 gcloud CLI.

    Install the Google Cloud CLI, then initialize it by running the following command: 

    gcloud init

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 o ambiente de desenvolvimento e a autenticação, execute a ferramenta de linha de comando gcloud para interagir com o Spanner:

gcloud spanner instance-configs list

Você vai encontrar 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 do Cloud e os drivers para criar uma instância, um banco de dados, tabelas e índices do Spanner. Em seguida, armazene, consulte e leia dados no Spanner.