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

    After installing the Google Cloud CLI, initialize it by running the following command: 

    gcloud init

    If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    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. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

      gcloud init

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

    1. Install the Google Cloud CLI.

    2. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

      gcloud init

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

      After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    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.