Configurar

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

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.
  3. 3
  4. Abra uma janela de terminal e defina seu projeto como o projeto padrão da ferramenta de linha de comando gcloud, substituindo MY_PROJECT_ID pelo ID (e não pelo nome) do projeto:

    gcloud config set project MY_PROJECT_ID
  5. Verifique se a cobrança está ativada para o seu projeto do Google Cloud. Saiba como confirmar se a cobrança está ativada para o seu projeto.

  6. Também é possível saber mais sobre os preços do Cloud Spanner.
  7. Ative a API Cloud Spanner para o projeto.

    Ativar a API Cloud Spanner

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

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

Para executar seu código localmente durante o desenvolvimento e o teste, use o SDK do Google Cloud (a ferramenta de linha de comando gcloud) com 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.

Executar a ferramenta de linha de comando gcloud

Agora que você configurou ambiente de desenvolvimento e autenticação, 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!

A seguir

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