Este documento mostra como configurar e consultar um banco de dados de gráficos do Spanner para modelar, armazenar e analisar relações de dados complexas usando o console Google Cloud e as bibliotecas de cliente.
Os tópicos a seguir ajudam você a aprender como:
Para saber mais sobre os preços do Spanner, consulte Preços do Spanner.
Para testar um codelab, consulte Introdução ao Spanner Graph.
Antes de começar
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verify that billing is enabled for your Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verify that billing is enabled for your Google Cloud project.
- Ative a API Spanner:
Acessar "Ativar a API Spanner" -
Para receber as permissões necessárias para criar instâncias e bancos de dados, peça ao administrador para conceder a você o papel do IAM de Administrador do Cloud Spanner (
roles/spanner.admin
) no seu projeto. -
Para ter as permissões necessárias para consultar gráficos do Spanner se você não tiver o papel de administrador do Cloud Spanner, peça ao administrador para conceder a você o papel do IAM de Leitor de banco de dados do Cloud Spanner (
roles/spanner.databaseReader
) no seu projeto. No console Google Cloud , acesse a página Spanner.
Selecione ou crie um Google Cloud projeto, se ainda não tiver feito isso.
Escolha uma destas opções:
Se você nunca criou uma instância do Spanner, na página Bem-vindo ao Spanner, clique em Criar uma instância provisionada.
Se você já criou uma instância do Spanner, na página Instâncias, clique em Criar instância.
Na página Selecionar uma edição, escolha Enterprise Plus ou Enterprise.
O Spanner Graph está disponível apenas nas edições Enterprise ou Enterprise Plus. Para comparar as diferentes edições, clique em Comparar edições. Para mais informações, consulte a visão geral das edições do Spanner.
Clique em Continuar.
Em Nome da instância, insira um nome, por exemplo,
test-instance
.Em ID da instância, mantenha ou mude o ID da instância. O ID da instância é o nome dela por padrão, mas você pode mudar isso. O nome e o ID da instância podem ser iguais ou diferentes.
Clique em Continuar.
Em Escolher uma configuração, faça o seguinte:
Mantenha a opção Regional selecionada.
Em Selecionar uma configuração, escolha uma região. O Spanner armazena e replica suas instâncias na região selecionada.
Clique em Continuar.
Em Configurar capacidade de computação, faça o seguinte:
Em Selecionar unidade, escolha Unidades de processamento (PUs).
Em Escolher um modo de escalonamento, mantenha Alocação manual selecionada e, em Quantidade, mantenha 1.000 unidades de processamento.
Clique em Criar. O console do Google Cloud mostra a página Visão geral da instância criada.
No console Google Cloud , acesse a página Instâncias do Spanner.
Clique na instância que você criou, por exemplo,
Test Instance
.Em Visão geral, abaixo do nome da instância, clique em Criar banco de dados.
Em Nome do banco de dados, insira um nome. Por exemplo,
example-db
.Em Selecionar dialeto do banco de dados, escolha SQL padrão do Google. O Spanner Graph não está disponível no dialeto PostgreSQL.
Insira o seguinte esquema na guia do editor Modelos de DDL. O esquema contém duas definições de tabela de nós,
Person
eAccount
, e duas definições de tabela de arestas,PersonOwnAccount
eAccountTransferAccount
. O Spanner Graph usa tabelas relacionais para definir gráficos. Por isso, você vê tabelas relacionais e instruções de gráfico no esquema. Para saber mais sobre o esquema do Spanner Graph, consulte a visão geral do esquema do Spanner Graph:CREATE TABLE Person ( id INT64 NOT NULL, name STRING(MAX), birthday TIMESTAMP, country STRING(MAX), city STRING(MAX), ) PRIMARY KEY (id); CREATE TABLE Account ( id INT64 NOT NULL, create_time TIMESTAMP, is_blocked BOOL, nick_name STRING(MAX), ) PRIMARY KEY (id); CREATE TABLE PersonOwnAccount ( id INT64 NOT NULL, account_id INT64 NOT NULL, create_time TIMESTAMP, FOREIGN KEY (account_id) REFERENCES Account (id) ) PRIMARY KEY (id, account_id), INTERLEAVE IN PARENT Person ON DELETE CASCADE; CREATE TABLE AccountTransferAccount ( id INT64 NOT NULL, to_id INT64 NOT NULL, amount FLOAT64, create_time TIMESTAMP NOT NULL, order_number STRING(MAX), FOREIGN KEY (to_id) REFERENCES Account (id) ) PRIMARY KEY (id, to_id, create_time), INTERLEAVE IN PARENT Account ON DELETE CASCADE; CREATE OR REPLACE PROPERTY GRAPH FinGraph NODE TABLES (Account, Person) EDGE TABLES ( PersonOwnAccount SOURCE KEY (id) REFERENCES Person (id) DESTINATION KEY (account_id) REFERENCES Account (id) LABEL Owns, AccountTransferAccount SOURCE KEY (id) REFERENCES Account (id) DESTINATION KEY (to_id) REFERENCES Account (id) LABEL Transfers );
Mantenha as configurações padrão em Mostrar opções de criptografia.
Clique em Criar.O console do Google Cloud mostra a página Visão geral do banco de dados que você criou.
Na página Spanner Studio, clique em
Nova guia ou use a guia do editor.Copie e cole as seguintes instruções de inserção de dados de gráfico nos nós e arestas.
INSERT INTO Account (id, create_time, is_blocked, nick_name) VALUES (7,"2020-01-10 06:22:20.222",false,"Vacation Fund"), (16,"2020-01-27 17:55:09.206",true,"Vacation Fund"), (20,"2020-02-18 05:44:20.655",false,"Rainy Day Fund"); INSERT INTO Person (id, name, birthday, country, city) VALUES (1,"Alex","1991-12-21 00:00:00","Australia","Adelaide"), (2,"Dana","1980-10-31 00:00:00","Czech_Republic","Moravia"), (3,"Lee","1986-12-07 00:00:00","India","Kollam"); INSERT INTO AccountTransferAccount (id, to_id, amount, create_time, order_number) VALUES (7,16,300,"2020-08-29 15:28:58.647","304330008004315"), (7,16,100,"2020-10-04 16:55:05.342","304120005529714"), (16,20,300,"2020-09-25 02:36:14.926","103650009791820"), (20,7,500,"2020-10-04 16:55:05.342","304120005529714"), (20,16,200,"2020-10-17 03:59:40.247","302290001255747"); INSERT INTO PersonOwnAccount (id, account_id, create_time) VALUES (1,7,"2020-01-10 06:22:20.222"), (2,20,"2020-01-27 17:55:09.206"), (3,16,"2020-02-18 05:44:20.655");
Clique em Executar. Quando a execução for concluída, a guia Resultados vai mostrar que três linhas foram inseridas.
Na página Visão geral do banco de dados, clique em Spanner Studio no menu de navegação.
Na página Spanner Studio, clique em
Nova guia ou use a guia do editor.Insira a consulta a seguir no editor de consultas. A consulta encontra todas as pessoas para quem Dana transferiu dinheiro e o valor dessas transferências.
GRAPH FinGraph MATCH (from_person:Person {name: "Dana"})-[:Owns]-> (from_account:Account)-[transfer:Transfers]-> (to_account:Account)<-[:Owns]-(to_person:Person) RETURN from_person.name AS from_account_owner, from_account.id AS from_account_id, to_person.name AS to_account_owner, to_account.id AS to_account_id, transfer.amount AS amount
Clique em Executar.
A guia Resultados mostra os seguintes caminhos de Dana, proprietária da conta número 20:
- Para
Account {id:7}
, de propriedade de Alex. Para
Account {id:16}
de propriedade de Lee.
- Para
No console Google Cloud , acesse Instâncias do Spanner.
Clique no nome da instância, por exemplo, Instância de teste.
Clique no nome do banco de dados, por exemplo, example-db.
Na página Detalhes do banco de dados, clique em Excluir banco de dados.
Confirme se quer excluir o banco de dados digitando o nome dele e clicando em Excluir.
No console Google Cloud , acesse a página Instâncias do Spanner.
Clique no nome da instância que você quer excluir, por exemplo, Instância de teste.
Clique em Excluir instância.
Confirme que você quer excluir a instância digitando o nome dela e clicando em Excluir.
- Saiba mais sobre o Spanner Graph usando um codelab.
- Saiba mais sobre o esquema do Spanner Graph.
- Criar, atualizar ou descartar um esquema de gráfico do Spanner.
- Inserir, atualizar ou excluir dados do gráfico do Spanner.
- Visão geral das consultas do Spanner Graph.
- Migre para o Spanner Graph.
Criar uma instância do Spanner
Ao usar o Spanner pela primeira vez, é necessário criar uma instância, que aloca recursos para bancos de dados do Spanner. Nesta seção, mostramos como criar uma instância usando o console Google Cloud .
Criar um banco de dados de grafos usando um esquema
Nesta seção, mostramos como criar um banco de dados do Spanner Graph usando um esquema do Spanner Graph. É possível usar o console Google Cloud ou as bibliotecas de cliente.
Console
Bibliotecas de cliente
Python
Java
Go
C++
Inserir dados do gráfico
Depois de criar o banco de dados, você pode adicionar dados a ele. Esta seção mostra como inserir dados no gráfico usando o console do Google Cloud para uma interface gráfica ou usando as bibliotecas de cliente de forma programática.
Console
Bibliotecas de cliente
Python
Java
Go
C++
O gráfico a seguir mostra as pessoas, contas, propriedade e transferências de conta dos encartes:
Executar uma consulta de grafo
Depois de inserir dados no gráfico, é possível consultá-los para encontrar padrões e relações. Nesta seção, mostramos como executar consultas usando o consoleGoogle Cloud para uma interface gráfica ou de forma programática com bibliotecas de cliente.
Console
Bibliotecas de cliente
Python
Java
Go
C++
Limpar
Nesta seção, mostramos como limpar os recursos criados para evitar cobranças na sua conta do Cloud Billing. Se você planeja conferir outros exemplos de gráficos do Spanner na seção Próximas etapas, não siga estas etapas ainda. A exclusão de uma instância do Spanner também exclui todos os bancos de dados nela.