1. Visão geral
Última atualização:23/07/2020
O que é o Cloud Spanner?
O Google Cloud Spanner é um banco de dados distribuído globalmente e em conformidade com ACID que lida automaticamente com réplicas, fragmentação e processamento de transações. Assim, você pode escalonar rapidamente para atender a qualquer padrão de uso e garantir o sucesso dos seus produtos.
Principais características
- Banco de dados relacional, criado para escalonamento:tudo que você espera de um banco de dados relacional (esquemas, consultas SQL e transações ACID) testado na prática e pronto para escalonamento global.
- Disponibilidade de 99,999%:o Cloud Spanner oferece disponibilidade de 99,999% líder do setor para instâncias multirregionais, o que significa 10 vezes menos inatividade do que quatro noves. Além disso, ele oferece replicação transparente e síncrona em todas as configurações regionais e multirregionais.
- Fragmentação automática:o Cloud Spanner otimiza o desempenho ao fragmentar automaticamente os dados com base na carga da solicitação e no tamanho dos dados. Como resultado, você passa menos tempo se preocupando com o escalonamento do seu banco de dados e, em vez disso, se concentra na expansão dos seus negócios.
O que você vai aprender
- Criar instâncias do Cloud Spanner usando o console do Google Cloud.
- Como criar um banco de dados em uma instância do Cloud Spanner.
- Usando o sampledb para carregar e consultar dados de amostra.
- Excluir a instância do Cloud Spanner.
2. Configuração e requisitos
Configuração de ambiente autoguiada
Se você ainda não tem uma Conta do Google (Gmail ou Google Apps), crie uma. Faça login no Console do Google Cloud Platform ( console.cloud.google.com) e crie um projeto:


Lembre-se do código do projeto, um nome exclusivo em todos os projetos do Google Cloud. O nome acima já foi escolhido e não servirá para você. Faremos referência a ele mais adiante neste codelab como PROJECT_ID.
Em seguida, ative o faturamento no console do Cloud para usar os recursos do Google Cloud.
A execução por meio deste codelab terá um custo baixo, mas poderá ser mais se você decidir usar mais recursos ou se deixá-los em execução. Consulte a seção "limpeza" no final deste documento.
Novos usuários do Google Cloud estão qualificados para um teste sem custo financeiro de US$300.
3. Abrir o Spanner no console do Cloud
No console do Google Cloud, clique no ícone de menu no canto superior esquerdo da tela para abrir a navegação à esquerda.
Role a tela para baixo e selecione "Spanner":

Agora você vai ver a interface do Cloud Spanner. Se estiver usando um projeto que ainda não ativou a API Cloud Spanner, uma caixa de diálogo vai pedir que você faça isso. Se você já tiver ativado a API, pule esta etapa.
Clique em "Ativar" para continuar:

4. Criar uma instância
Primeiro, crie uma instância do Cloud Spanner. Na interface, clique em "Criar instância" para criar uma:

Ao clicar em "Criar instância", você vai acessar uma página para criar uma instância. Insira um nome de instância e escolha uma configuração.
É possível escolher uma configuração regional ou multirregional. As configurações regionais terão todas as réplicas na mesma região, e as multirregionais criarão réplicas de leitura em várias regiões. Clique em "Comparar configurações de região" para fazer a comparação.

Depois de escolher uma configuração, o resumo vai aparecer no painel à direita:

No futuro, você poderá aumentar o número de nós para dar mais recursos à sua instância ou diminuir se ela não precisar de recursos extras.
Clique em "Criar" para criar a instância.

Sua instância do Cloud Spanner está pronta para uso.

5. Criar um banco de dados
Para criar um banco de dados, clique em "Criar banco de dados":

Insira um nome para o novo banco de dados. Também é possível fornecer um esquema neste momento.

Vamos pular a etapa de fornecer um esquema e clicar em "Criar" para criar um banco de dados vazio.

Depois de clicar em "Criar", um novo banco de dados será criado:

6. Carregar e consultar dados de amostra
Neste codelab, vamos carregar e consultar dados de amostra usando o sampledb. O Sampledb contém vários conjuntos de dados e pode importar dados para seus bancos de dados atuais.
Vamos executar o programa no Google Cloud Shell. Se esta for a primeira vez que você usa o Google Cloud Shell para este projeto, o logotipo dele vai aparecer na barra de navegação superior. Ative o Cloud Shell clicando nele.

Depois de ativado, um console vai aparecer na parte de baixo:

No console, clone o repositório sampledb e siga as instruções para instalar as dependências:
$ git clone https://github.com/cloudspannerecosystem/sampledb.git
Depois de clonar o repositório, navegue até o novo diretório, crie um ambiente virtual e instale os requisitos necessários:
$ cd sampledb $ virtualenv env $ source env/bin/activate $ pip install -r requirements.txt
Depois que as dependências forem instaladas, execute sampledb para criar um novo banco de dados com dados de amostra:
$ python batch_import.py my-first-instance my-sample-db
Quando a operação for concluída, você poderá ver "my-sample-db" com duas novas tabelas (comments e stories):

O conjunto de dados de exemplo contém histórias e comentários do Hacker News. Clique em "Consulta" para começar a consultar e navegar pelos dados:

7. Limpar
Esta etapa é opcional. Se você quiser continuar testando a instância do Cloud Spanner, não é necessário limpá-la agora. No entanto, o projeto que você está usando vai continuar sendo cobrado pela instância. Se você não precisar mais dessa instância, exclua-a agora para evitar essas cobranças.
Volte à página da instância clicando em "my-first-instance" no canto superior esquerdo:

Clique no botão "Excluir" para remover a instância:

A exclusão de uma instância é permanente. Não é possível recuperar os dados dessa instância. Para evitar a exclusão acidental da instância errada, confirme a exclusão inserindo o nome da instância em uma caixa de diálogo de confirmação:

Digite o nome da instância e pressione "Excluir".
8. Parabéns!
Você criou uma instância do Cloud Spanner, um banco de dados vazio, carregou dados de amostra e (opcionalmente) excluiu a instância do Cloud Spanner.
O que vimos
- Criar instâncias do Cloud Spanner usando o console do Google Cloud.
- Como criar um banco de dados em uma instância do Cloud Spanner.
- Usando o sampledb para carregar e consultar dados de amostra.
- Excluir a instância do Cloud Spanner.
Saiba mais
- Consulte a documentação do Google Cloud Spanner.
- Leia sobre as APIs e bibliotecas de cliente do Google Cloud Spanner.