Sobre este codelab
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 processa automaticamente 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 recursos
- Banco de dados relacional, criado para escalonamento:tudo o que você espera de um banco de dados relacional, como esquemas, consultas SQL e transações ACID, testado na prática e pronto para escalonamento global.
- Disponibilidade de 99,999%:o Cloud Spanner oferece uma disponibilidade de 99,999% líder do setor para instâncias multirregionais, 10 vezes menos inatividade do que serviços com disponibilidade de quatro noves, e 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
- Criação de instâncias do Cloud Spanner usando o console do Google Cloud.
- Criação de um novo banco de dados em uma instância do Cloud Spanner.
- Usando o sampledb para carregar e consultar dados de amostra.
- Exclusão da 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 novo 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 acessar a navegação à esquerda.
Role para baixo e selecione "Spanner":
A interface do Cloud Spanner vai aparecer. Se você estiver usando um projeto que ainda não ativou a API Cloud Spanner, vai aparecer uma caixa de diálogo solicitando a ativação. Se você já ativou a API, pule esta etapa.
Clique em "Ativar" para continuar:
4. Criar uma instância
Primeiro, você vai criar uma instância do Cloud Spanner. Na interface, clique em "Criar instância" para criar uma nova instância:
Ao clicar em "Criar instância", você será direcionado para uma página de criação de instância. Insira um nome de instância e escolha uma configuração.
Você pode escolher uma configuração regional ou multirregional. As configurações regionais terão todas as réplicas na mesma região, e as multirregionais vão criar réplicas de leitura em várias regiões. Clique em "Comparar configurações de região" para comparar a configuraçã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 fornecer mais recursos à instância ou diminuí-lo 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 novo banco de dados, clique em "Criar banco de dados":
Insira um nome para o novo banco de dados. Como alternativa, você também pode fornecer um esquema.
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 do Google Cloud Shell vai aparecer na barra de navegação na parte de cima. Ative o Cloud Shell clicando nele.
Depois de ativar, 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, será possível executar o sampledb para criar um novo banco de dados com dados de amostra:
$ python batch_import.py my-first-instance my-sample-db
Depois disso, você vai poder acessar "my-sample-db" com duas novas tabelas (comentários e histórias):
O conjunto de dados de amostra 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 sua instância do Cloud Spanner, não precisa limpá-la no momento. 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 para evitar cobranças.
Para voltar à página da instância, clique 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 digitando o nome da instância em uma caixa de diálogo de confirmação:
Insira o nome da instância e pressione "Excluir".
8. Parabéns!
Você criou uma nova instância do Cloud Spanner, criou um banco de dados vazio, carregou dados de amostra e (opcionalmente) excluiu a instância do Cloud Spanner.
O que vimos
- Criação de instâncias do Cloud Spanner pelo console do Google Cloud.
- Criação de um novo banco de dados em uma instância do Cloud Spanner.
- Usando o sampledb para carregar e consultar dados de amostra.
- Exclusão da instância do Cloud Spanner.
Saiba mais
- Acesse a documentação do Google Cloud Spanner.
- Leia sobre as APIs e as bibliotecas de cliente do Google Cloud Spanner.