Criar uma instância de teste gratuito e um aplicativo de exemplo do Spanner

Observação: uma instância de teste sem custos financeiros do Spanner é compatível com recursos da edição Standard e da edição Enterprise, como funções de distância de vetor KNN, pesquisa de texto completo e Spanner Graph. Para mais informações, consulte a visão geral das edições do Spanner.

Neste guia de início rápido, você vai aprender a usar uma instância de teste sem custo financeiro do Spanner e um aplicativo de amostra. Para mais informações, consulte a visão geral das instâncias de teste sem custo financeiro do Spanner.

Comece com uma instância de teste sem custo financeiro

Uma instância de teste sem custo financeiro de 90 dias do Spanner está disponível para qualquer pessoa com uma Conta do Google que tenha o Cloud Billing ativado no projeto. Você não vai receber cobranças a menos que faça upgrade da instância de teste sem custo financeiro para uma instância paga.

É possível criar uma instância de teste sem custos financeiros usando o console Google Cloud ou a Google Cloud CLI.

Observação: você só pode criar uma instância de teste sem custo financeiro por ciclo de vida do projeto e um máximo de cinco instâncias de teste sem custo financeiro por conta do Cloud Billing.

Antes de começar

Console do Google Cloud

1. No console Google Cloud , acesse a página Spanner.

   Acessar o Spanner

2. Selecione ou crie um projeto do Google Cloud , caso ainda não tenha feito isso.

3. Se o Cloud Billing já estiver ativado para seu projeto, vá para Criar instância de teste sem custo financeiro na próxima seção.

   Se o Cloud Billing não estiver ativado no seu projeto, vincule uma conta do Cloud Billing ou crie uma nova conta do Cloud Billing. O Google usa essas informações de pagamento para confirmar sua identidade. Não cobramos pela sua instância do Spanner, a menos que você faça upgrade da sua conta do Cloud Billing para uma conta paga e faça upgrade da sua instância de teste sem custo financeiro do Spanner para uma instância paga.

   a. Clique em Acessar faturamento.

   b. Em seguida, clique em Vincular uma conta de faturamento.

   Observação: se você é um novo cliente do Google Cloud , também pode se qualificar para o Google Cloud teste sem custo financeiro de 90 dias e US$ 300, que oferece US $300 em créditos sem custo financeiro do Cloud Billing para pagar por recursos do Google Cloud. A instância de teste sem custo financeiro do Spanner é adicional aos US $300 em créditos de teste sem custo financeiro oferecidos pelo Google Cloud , e você não precisa usar nenhum crédito sem custo financeiro do Cloud Billing para criar uma instância de teste sem custo financeiro.

   c. Siga as etapas para criar uma conta de faturamento e vincule-a ao seu projeto.

   d. Depois de ativar o Cloud Billing para seu projeto, acesse a página Spanner.

   Acessar o Spanner

   e. Clique em Criar instância sem custo financeiro e acesse Criar instância de teste sem custo financeiro na próxima seção.

4. Opcional: se você já tiver criado uma instância do Spanner no projeto, a página Instâncias do Spanner vai aparecer.

   Clique em Criar instância sem custos financeiros.

gcloud

Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

Instale a CLI do Google Cloud.

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

Para inicializar a gcloud CLI, execute o seguinte comando:

gcloud init

Crie ou selecione um Google Cloud projeto.

Funções necessárias para selecionar ou criar um projeto

• Selecionar um projeto: não é necessário um papel específico do IAM para selecionar um projeto. Você pode escolher qualquer projeto em que tenha recebido um papel.
• Criar um projeto: para criar um projeto, é necessário ter o papel de Criador de projetos (roles/resourcemanager.projectCreator), que contém a permissão resourcemanager.projects.create. Saiba como conceder papéis.

Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

• Crie um projeto do Google Cloud :

  gcloud projects create PROJECT_ID

  Substitua PROJECT_ID por um nome para o projeto Google Cloud que você está criando.

• Selecione o projeto Google Cloud que você criou:

  gcloud config set project PROJECT_ID

  Substitua PROJECT_ID pelo nome do projeto do Google Cloud .

Verifique se o faturamento está ativado para o projeto do Google Cloud .

Se você estiver usando um shell local, crie credenciais de autenticação local para sua conta de usuário:

gcloud auth application-default login

Não é necessário fazer isso se você estiver usando o Cloud Shell.

Se um erro de autenticação for retornado e você estiver usando um provedor de identidade (IdP) externo, confirme se você fez login na CLI gcloud com sua identidade federada.

Instale a CLI do Google Cloud.

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

Para inicializar a gcloud CLI, execute o seguinte comando:

gcloud init

Crie ou selecione um Google Cloud projeto.

Funções necessárias para selecionar ou criar um projeto

• Selecionar um projeto: não é necessário um papel específico do IAM para selecionar um projeto. Você pode escolher qualquer projeto em que tenha recebido um papel.
• Criar um projeto: para criar um projeto, é necessário ter o papel de Criador de projetos (roles/resourcemanager.projectCreator), que contém a permissão resourcemanager.projects.create. Saiba como conceder papéis.

Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

• Crie um projeto do Google Cloud :

  gcloud projects create PROJECT_ID

  Substitua PROJECT_ID por um nome para o projeto Google Cloud que você está criando.

• Selecione o projeto Google Cloud que você criou:

  gcloud config set project PROJECT_ID

  Substitua PROJECT_ID pelo nome do projeto do Google Cloud .

Verifique se o faturamento está ativado para o projeto do Google Cloud .

Se você estiver usando um shell local, crie credenciais de autenticação local para sua conta de usuário:

gcloud auth application-default login

Não é necessário fazer isso se você estiver usando o Cloud Shell.

Se um erro de autenticação for retornado e você estiver usando um provedor de identidade (IdP) externo, confirme se você fez login na CLI gcloud com sua identidade federada.

Criar uma instância de teste sem custo financeiro

Console do Google Cloud

As etapas a seguir explicam como criar uma instância de teste sem custo financeiro usando o console Google Cloud .

Na página Criar sua instância de teste sem custo financeiro, faça o seguinte:

1. Insira o Nome da instância a ser exibido no console Google Cloud . A instância precisa ser exclusiva no projeto Google Cloud .
2. Insira o ID da instância para identificá-la permanentemente. O ID da instância também precisa ser exclusivo no seu projeto Google Cloud . Não será possível alterar o ID da instância mais tarde.

3. Selecione um local de configuração no menu suspenso Região.

   A localização geográfica em que a instância é armazenada e replicada é determinada pela configuração da instância. É possível criar uma instância de teste sem custo financeiro em qualquer uma das configurações de instância regional do Spanner. Para conferir uma lista completa de todas as configurações de instância disponíveis, consulte Configurações regionais, birregionais e multirregionais.

4. Clique em Criar instância sem custos financeiros.

   Depois de criar a instância de teste sem custo financeiro, o Spanner cria um banco de dados de amostra para você conhecer e se familiarizar com os recursos do Spanner. Para mais informações, consulte Visão geral das instâncias de teste sem custos financeiros.

gcloud

Para criar uma instância de teste sem custos financeiros, use o comando gcloud spanner instances create.

gcloud spanner instances create INSTANCE_ID \
   --instance-type=free-instance --config=INSTANCE_CONFIG \
   --description=INSTANCE_DESCRIPTION

Substitua:

• INSTANCE_ID: um identificador permanente exclusivo no seu projeto Google Cloud . Não será possível mudar o ID da instância depois.

• INSTANCE_CONFIG: um identificador permanente da configuração da instância, que define a localização geográfica dela. É possível criar uma instância de teste sem custo financeiro em qualquer uma das configurações de instância regional do Spanner:

• INSTANCE_DESCRIPTION: o nome a ser exibido para a instância no console doGoogle Cloud . O nome da instância precisa ser exclusivo no projetoGoogle Cloud .

Por exemplo, para criar uma instância de teste sem custo financeiro chamada trial-instance com o nome de exibição Trial Instance usando a configuração de instância regional regional-us-east5, execute o seguinte:

gcloud spanner instances create trial-instance --config=regional-us-east5 \
  --instance-type=free-instance --description="Trial Instance"

Observação: use o ID da instância, e não o nome de exibição, ao se referir a uma instância em comandos gcloud CLI.

Depois de criar a instância do teste sem custo financeiro, você vai receber uma solicitação para continuar aprendendo e conhecendo o Spanner. Para isso, inicie um tutorial detalhado que ensina a criar um banco de dados usando um aplicativo de exemplo. Para mais informações, consulte Começar a usar um aplicativo de exemplo.

Começar a usar um banco de dados de exemplo

Depois de criar a instância de teste sem custo financeiro usando o console Google Cloud , o Spanner cria um banco de dados de amostra para você conhecer e se familiarizar com os recursos do Spanner.

É possível acessar o banco de dados de amostra usando o console do Google Cloud .

Console do Google Cloud

1. No console Google Cloud , acesse a página Instâncias do Spanner.

   Acessar a página "Instâncias"

2. Clique no nome da instância de teste sem custo financeiro.

3. Clique no nome do banco de dados de exemplo.

É possível conferir as tabelas e os dados no banco de dados de amostra. Também é possível acessar e visualizar as consultas salvas na página do Spanner Studio. As consultas salvas mostram diferentes recursos e capacidades do Spanner.

Começar a usar um aplicativo de exemplo

O Spanner também oferece um aplicativo de amostra de código aberto para ajudar você a começar a usar a instância de teste sem custo financeiro do Spanner. O aplicativo de exemplo consiste em um serviço gRPC de back-end com suporte de um banco de dados do Spanner e um gerador de carga de trabalho que direciona o tráfego para o serviço.

É possível acessar o aplicativo de exemplo usando a Google Cloud CLI.

gcloud

1. Conclua as etapas descritas na configuração do gcloud, que aborda a criação e a definição de um projeto Google Cloud padrão, a ativação da API Cloud Spanner e a configuração do OAuth 2.0 para receber credenciais de autenticação para usar a API Cloud Spanner.

   Execute o comando gcloud auth application-default login para configurar o ambiente de desenvolvimento local com credenciais de autenticação.

2. Execute o comando gcloud spanner samples run para fazer o download do aplicativo de exemplo e iniciar o serviço gRPC de back-end e o gerador de carga de trabalho para o aplicativo de exemplo especificado:

   gcloud spanner samples run APPNAME --instance-id INSTANCE_ID
   

3. Para mais informações e uma lista de outros comandos disponíveis para o aplicativo de exemplo, consulte a documentação da CLI gcloud.

Importe seus próprios dados

É possível importar seus próprios dados para um banco de dados do Spanner usando um arquivo CSV, um arquivo dump do MySQL ou um arquivo dump do PostgreSQL. É possível fazer upload de um arquivo local usando o Cloud Storage ou diretamente de um bucket do Cloud Storage. O upload de um arquivo local usando o Cloud Storage pode gerar cobranças.

Se você escolher usar um arquivo CSV, também será necessário fazer upload de um arquivo JSON separado que contenha o esquema do banco de dados.

Console do Google Cloud

1. No console Google Cloud , acesse a página Instâncias do Spanner.

   Acessar as instâncias do Spanner

2. Selecione a instância em que você quer criar o banco de dados.

3. Clique em Importar meus dados.

4. Digite os seguintes valores:

   • Selecione o Tipo de arquivo.

   • Faça upload do arquivo do seu computador ou selecione um caminho de bucket do Cloud Storage para o arquivo.

   • (Opcional) Se você escolher usar um arquivo CSV, também será necessário fazer upload de um arquivo JSON separado que contenha o esquema do banco de dados. O arquivo JSON precisa usar a seguinte estrutura para definir o esquema:

     {
       "name": "COLUMN_NAME",
       "type": "TYPE",
       "notNull": NOT_NULL_VALUE,
       "primaryKeyOrder": PRIMARY_KEY_ORDER
     }

     Substitua:

     • COLUMN_NAME: o nome da coluna na tabela.

     • TYPE: o tipo de dados da coluna.

     • (Opcional) NOT_NULL_VALUE: indica se a coluna pode armazenar valores nulos ou não. As entradas válidas são true ou false. O padrão é false.

     • (Opcional): PRIMARY_KEY_ORDER: determina a ordem da chave primária. Defina o valor como 0 para uma coluna de chave não primária. Defina o valor como um número inteiro, por exemplo, 1 para uma coluna de chave primária. Colunas com números menores aparecem antes em uma chave primária composta.

     Por padrão, o arquivo CSV espera uma vírgula para o delimitador de campo e uma nova linha para o delimitador de linha. Para mais informações sobre como usar delimitadores personalizados, consulte a referência gcloud alpha spanner databases import.

   • Selecione um banco de dados novo ou existente como destino.

5. Clique em Importar.

6. O Spanner abre o Cloud Shell e preenche um comando que instala a ferramenta de migração do Spanner e executa o comando gcloud alpha spanner databases import. Pressione a tecla ENTER para importar dados para seu banco de dados.x

Fazer upgrade de uma instância de teste sem custo financeiro

As etapas a seguir explicam como fazer upgrade da instância de teste sem custo financeiro.

Console do Google Cloud

1. No console Google Cloud , acesse a página Instâncias do Spanner.

   Acessar a página "Instâncias"

2. Clique no nome da instância de teste sem custo financeiro.

3. Na página Visão geral da instância, clique em Editar instância ou Editar para fazer upgrade.

4. No campo Atualizar nome da instância, insira um nome mais adequado para sua instância paga, se aplicável.

5. Selecione a opção de upgrade. Você pode selecionar uma das seguintes opções:

   • Fazer upgrade agora
   • Fazer upgrade automático para a versão completa da edição Enterprise após o término do período de teste
   • Lembrar mais tarde

   A seção Resumo oferece uma descrição dos custos de computação e armazenamento da instância paga atualizada que você selecionou.

6. Clique em Salvar para fazer upgrade da instância de teste sem custo financeiro.

gcloud

Para fazer upgrade da instância de teste sem custo financeiro para uma instância paga da edição Enterprise com a mesma configuração, execute o seguinte comando gcloud spanner instances update:

gcloud spanner instances update INSTANCE_ID --instance-type=provisioned

Excluir a instância

Aviso: com a exclusão de uma instância, todos os respectivos bancos de dados também são removidos permanentemente. Não é possível desfazer essa ação. Além disso, não é possível criar outra instância de teste sem custo financeiro depois de excluir a primeira. Você pode criar uma instância de teste sem custo financeiro por ciclo de vida do projeto.

Console do Google Cloud

1. Acesse a página Instâncias do Spanner no console do Google Cloud .

   Acessar a página "Instâncias"

2. Clique no nome da instância a ser excluída.

3. Na página Visão geral da instância, clique em Excluir instância.

4. Siga as instruções para confirmar a exclusão da instância.

5. Clique em Excluir.

gcloud

Para excluir a instância do teste sem custo financeiro, use o seguinte comando gcloud spanner instances delete:

gcloud spanner instances delete INSTANCE_ID

A seguir

• Saiba mais sobre as instâncias de teste sem custo financeiro do Spanner.
• Saiba mais sobre instâncias e bancos de dados do Spanner.
• Para detalhes sobre os preços do Spanner após o período de teste sem custos financeiros, consulte a página de preços.