Instalar a CLI gcloud e configurar a API Cloud Spanner

Nesta página, mostramos as etapas de configuração necessárias para usar a API Cloud Spanner com a Google Cloud CLI, bibliotecas de cliente Impulsionadores do Spanner.

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

Antes de começar

Sua máquina de desenvolvimento deve ter o item a seguir instalado:

• A CLI gcloud, que inclui a configuração da Google Cloud CLI (faça o download).

Configure 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 do Google Cloud ou abra um existente clicando no nome do projeto.
Importante: o nome que você usa precisa ter entre 4 e 30 caracteres. Quando você digita o nome, o formulário sugere um ID do projeto, que você pode editar. O ID do projeto usado precisa ter entre seis e 30 caracteres, com uma letra minúscula como o primeiro caractere. Você pode usar um traço, uma letra minúscula ou um dígito para os caracteres restantes, mas o último caractere não pode ser um traço. Você precisa estar ciente de que alguns identificadores de recurso, como IDs do projeto, podem ser mantidos além do tempo de vida do seu projeto. Por esse motivo, evite armazenar informações confidenciais em identificadores de recurso.
Consultar as diretrizes de nomenclatura

3. Abra uma janela do terminal e defina seu projeto como o projeto padrão para a Google Cloud CLI, substituindo MY_PROJECT_ID pelo ID do projeto (não pelo nome do projeto):

   gcloud config set project MY_PROJECT_ID

4. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

Saiba 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ê usa uma conta de serviço em um projeto diferente para acessar seu do Spanner, você precisa ativar o serviço em ambos os projetos.

Configurar a autenticação e a autorização

O Spanner usa OAuth 2.0 para autenticação e autorização de APIs.

Para executar seu código localmente durante o desenvolvimento e os testes, use a Google Cloud CLI e Application Default Credentials. No prompt de comando, execute:

gcloud auth application-default login

Depois de autenticar usando o comando gcloud auth application-default login, as bibliotecas de cliente da API que usam Application Default Credentials selecionam automaticamente as credenciais criadas. É preciso executar o comando apenas uma vez por ambiente de usuário local.

Observação: o uso de gcloud auth application-default login é adequado para desenvolvimento local. Quando estiver tudo pronto para usar o Spanner na produção ambiente, conheça outras opções de credenciais em Como receber credenciais para fluxo centrado no servidor.

execute a Google Cloud CLI

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

gcloud spanner instance-configs list

É exibida uma lista das configurações de instância do Spanner que pode acessar, incluindo opções regionais, birregionais personalizadas. 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 um Instância, banco de dados, tabelas e índices do Spanner. Em seguida, armazene, consulte e leem dados no Spanner.

• Primeiros passos com o Spanner em C++
• Primeiros passos com o Spanner em C#
• Primeiros passos com o Spanner em Go
• Primeiros passos com o Spanner em Java
• Primeiros passos com o Spanner no 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 na gcloud