Instalar a CLI gcloud e configurar a API Cloud Spanner

Nesta página, você vai conferir as etapas de configuração necessárias para usar a API Cloud Spanner com a CLI do Google Cloud, 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 (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.
Consulte as diretrizes de nomenclatura

3. Abra uma janela de terminal e defina seu projeto como o projeto padrão da CLI do Google Cloud, 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.

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ê usa uma conta de serviço em um projeto diferente para acessar 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 a autenticação e autorização de APIs.

Para executar o código localmente durante o desenvolvimento e o teste, use a CLI do Google Cloud com as credenciais padrão do aplicativo. 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.

Executar a CLI do Google Cloud

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

Você vai encontrar 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 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