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:
-
Ler e gravar dados:
Usuário do banco de dados do Cloud Spanner (
roles/spanner.databaseUser
) na instância -
Acesso somente leitura aos bancos de dados:
Leitor de banco de dados do Cloud Spanner (
roles/spanner.databaseReader
) na instância
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
-
Acesse a página Projetos no console do Google Cloud .
- Crie um novo projeto Google Cloud ou abra um projeto atual clicando no nome dele.
-
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
-
Make sure that billing is enabled for your Google Cloud project.
Também é possível saber mais sobre os preços do Spanner.
-
Ative a API Cloud Spanner para o projeto.
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
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
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.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
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.
- Introdução ao Spanner em C++
- Primeiros passos com o Spanner em C#
- Introdução ao Spanner em Go
- Primeiros passos com o Spanner em Java
- Introdução ao Spanner em JDBC
- Primeiros passos com o Spanner em Node.js
- Primeiros passos com o Spanner em PHP
- Primeiros passos com o Spanner em Python
- Primeiros passos com o Spanner em Ruby
- Primeiros passos com o Spanner em REST
- Primeiros passos com o Spanner no 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.
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.
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.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-09 UTC.