Instale a CLI gcloud e configure a API Cloud Spanner

Nesta página, apresentamos 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.

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 (fazer 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 projeto existente clicando no nome dele.
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 (e não pelo nome):

   gcloud config set project MY_PROJECT_ID

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

Também é possível saber mais sobre os preços do Spanner.

5. Ative a Cloud Spanner API 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 e a autorização

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

Para executar o código localmente durante o desenvolvimento e o teste, use a Google Cloud CLI com o 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 pronto para usar o Spanner no seu ambiente de produção, saiba mais sobre outras opções de credenciais em Como receber credenciais para fluxos de servidor.

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ê deve ver uma lista das configurações de instância do Spanner que seu projeto pode acessar, incluindo configurações regionais e multirregionais. Saiba mais sobre isso em 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.

• 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 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 na gcloud