Configurar o ambiente

Nesta página, você verá 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 Google Cloud console, consulte o Guia de início rápido sobre como usar o console.

Funções exigidas

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

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 usando personalizados papéis ou outros predefinidos papéis.

Configurar um Google Cloud projeto

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

    Acessar a página "Projetos"

  2. Crie um novo Google Cloud projeto 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 do projeto (e não pelo nome): 

    gcloud config set project MY_PROJECT_ID

  4. Verifique se o faturamento foi ativado para o Google Cloud projeto.

    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 a instância do Spanner, será necessário ativar a API Spanner nos dois projetos.

Configurar a autenticação

Selecione as guias para definir como você quer acessar a API:

Console

Quando você usa o Google Cloud console para acessar Google Cloud serviços e APIs, não é necessário configurar a autenticação.

gcloud

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

gcloud init

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

Para configurar a CLI gcloud e 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 config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

Saiba mais em 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 CLI gcloud e configure o Application Default Credentials com suas credenciais de usuário.

  1. Instale a Google Cloud CLI.

  2. Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

  3. Se você estiver usando um shell local, crie credenciais de autenticação local para sua conta de usuário: 

    gcloud auth application-default login

    Não é necessário fazer isso se você estiver usando o Cloud Shell.

    Se um erro de autenticação for retornado e você estiver usando um provedor de identidade (IdP) externo, confirme se você fez login na CLI gcloud com sua identidade federada.

Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.

Bibliotecas de cliente

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

  1. Instale a Google Cloud CLI.

  2. Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

  3. Se você estiver usando um shell local, crie credenciais de autenticação local para sua conta de usuário: 

    gcloud auth application-default login

    Não é necessário fazer isso se você estiver usando o Cloud Shell.

    Se um erro de autenticação for retornado e você estiver usando um provedor de identidade (IdP) externo, confirme se você fez login na CLI gcloud com sua identidade federada.

Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.

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

Saiba mais em Identidade temporária de conta de serviço.

REST

Para usar a API REST em um ambiente de desenvolvimento local, use as credenciais que você vai informar à CLI gcloud.

    Instale a Google Cloud CLI.

    Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

Saiba mais em Autenticar para usar REST na documentação de Google Cloud autenticação.

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

Executar a Google Cloud CLI

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

gcloud spanner instance-configs list

Você verá uma lista das configurações de instância do Spanner que seu projeto pode acessar, incluindo configurações regionais, de duas regiões 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 instância, banco de dados, tabelas e índices do Spanner. Em seguida, armazene, consulte e leia dados no Spanner.