Configurar

Esta página apresenta as etapas de configuração necessárias para usar a API Cloud Spanner.

Se você quiser usar o Cloud Spanner sem usar a API, consulte o Início rápido sobre como usar o console.

Antes de começar

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

• O SDK do Google Cloud, que inclui a configuração da ferramenta de linha de comando gcloud (fazer o download).

Configurar um projeto do Console do GCP

1. No Console do Google Cloud Platform, acesse a página "Projetos".
Acessar a página "Projetos"
2. Crie um novo projeto do Console do GCP ou abra um projeto existente clicando no nome dele.
Importante: o nome usado precisa ter entre 4 e 30 caracteres. Quando você digita o nome, a forma sugere um código do projeto, que você pode editar. O código 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. Além disso, você precisa estar ciente de que alguns identificadores de recurso (como códigos de projeto) podem ser mantidos além da vida útil do 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 para a ferramenta de linha de comando gcloud, substituindo o código do projeto (não o nome do projeto) da seguinte maneira:

gcloud config set project [MY_PROJECT_ID]

4. Verifique se o faturamento foi ativado para o projeto.

   Saiba como ativar o faturamento

   Para informações sobre os preços do Cloud Spanner, consulte Preços.
5. Ative a Cloud Spanner API para o projeto.
   Ativar a Cloud Spanner API

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

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

Para executar o código localmente durante o desenvolvimento e o teste, use o SDK do Google Cloud (a ferramenta de linha de comando gcloud) com o Application Default Credentials. No prompt de comando, execute:

gcloud auth application-default login

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

Observação: usar o gcloud auth application-default login é útil para o desenvolvimento local. Quando você estiver pronto para usar o Cloud Spanner no seu ambiente de produção, saiba mais sobre outras opções de credenciais em Como receber credenciais para fluxos voltados ao servidor.

Executar a ferramenta de linha de comando do gcloud

Agora que seu ambiente de desenvolvimento e autenticação foi configurado, execute a ferramenta de linha de comando gcloud para interagir com o Cloud Spanner:

gcloud spanner instance-configs list

Você verá uma lista das configurações de instância do Cloud Spanner que seu projeto pode acessar, incluindo configurações regionais e multirregionais. Saiba mais sobre isso em Instâncias.

Você concluiu a configuração!

Próximas etapas

Saiba como usar as bibliotecas de cliente do Google Cloud para criar uma instância do Cloud Spanner, banco de dados, tabelas e índices. Em seguida, armazene, consulte e leia dados no Cloud Spanner.

• Primeiros passos com o Cloud Spanner em C#
• Primeiros passos com o Cloud Spanner no Go
• Primeiros passos com o Cloud Spanner em Java
• Primeiros passos com o Cloud Spanner em Node.js
• Primeiros passos com o Cloud Spanner em PHP
• Primeiros passos com o Cloud Spanner em Python
• Primeiros passos com o Cloud Spanner em Ruby
• Primeiros passos com o Cloud Spanner em REST