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 vetorial KNN, pesquisa de texto completo e Spanner Graph. Para mais informações, consulte o resumo das edições do Spanner.

Neste guia de início rápido, mostramos como usar uma instância de teste sem custo financeiro do Spanner e um aplicativo de exemplo. 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 de 90 dias sem custo financeiro 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: só é possível 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, prossiga para Criar uma instância de teste sem custo financeiro na próxima seção.

   Se o Cloud Billing não estiver ativado para seu projeto, vincule uma conta do Cloud Billing ou crie uma nova. O Google usa essas informações de pagamento para verificar sua identidade. Não vamos cobrar 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 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ê for um novo cliente do Google Cloud , também poderá se qualificar para o teste sem custo financeiro de US$ 300 por 90 dias doGoogle Cloud , que oferece US $300 em créditos do Cloud Billing para pagar por qualquer recurso do Google Cloud. A instância de teste sem custo financeiro do Spanner é um complemento aos créditos de US $300 oferecidos pelo teste sem custo financeiro do Google Cloud , e você não precisa usar nenhum crédito 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 prossiga para 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 custo financeiro.

gcloud

Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloudagora, crie uma conta para avaliar o desempenho dos 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 CLI gcloud com sua identidade federada.

Para inicializar a CLI gcloud, execute o seguinte comando:

gcloud init

Crie ou selecione um projeto do Google Cloud .

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 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 do Google Cloud que você está criando.

• Selecione o projeto do 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 CLI gcloud com sua identidade federada.

Para inicializar a CLI gcloud, execute o seguinte comando:

gcloud init

Crie ou selecione um projeto do Google Cloud .

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 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 do Google Cloud que você está criando.

• Selecione o projeto do 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 doGoogle 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 seu projeto Google Cloud .
2. Insira o ID da instância para identificar permanentemente sua instância. O ID da instância também precisa ser exclusivo no projeto do Google Cloud . Não é possível mudar o ID da instância depois.

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

   A configuração da instância determina a localização geográfica em que sua instância é armazenada e replicada. É possível criar uma instância de teste sem custo financeiro em qualquer uma das configurações de instância regional do Spanner. Para 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 custo financeiro, 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 é 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 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:

• INSTANCE_DESCRIPTION: o nome a ser exibido para a instância no consoleGoogle Cloud . O nome da instância precisa ser exclusivo no seu 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, não o nome de exibição, ao se referir a uma instância nos comandos gcloud CLI.

Depois de criar a instância de teste sem custo financeiro, você vai receber uma solicitação para continuar aprendendo e conhecendo o Spanner. Para isso, basta iniciar 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 que você criar sua instância de teste sem custo financeiro usando o console do Google Cloud , o Spanner vai criar 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 exemplo 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 amostra.

É possível conferir as tabelas e os dados no banco de dados de exemplo. Também é possível acessar e visualizar 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 exemplo 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 amostra consiste em um serviço gRPC de back-end apoiado por 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 da 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 e 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 amostra e iniciar o serviço gRPC de back-end e o gerador de carga de trabalho para o aplicativo de amostra fornecido:

   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ê optar por 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 do 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ê optar por 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 como delimitador de campo e uma nova linha como 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 atual 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 o 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 aplicável 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 fornece 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 sua 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 custos financeiros 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, consulte a página de preços.