Criar e gerenciar um esquema do Spanner Graph visualmente

Este documento é um guia sobre como gerenciar esquemas do Spanner Graph visualmente no Spanner Studio. A modelagem visual simplifica o design de gráficos, permitindo mapear nós e arestas por uma interface intuitiva em vez de criar instruções DDL manuais. Esse recurso facilita o design, a compreensão e a colaboração com outras pessoas. Além disso, essa abordagem aplica automaticamente as práticas recomendadas de esquema do Spanner Graph, garantindo que ele seja otimizado desde o início.

Os esquemas do Spanner Graph também podem ser criados e editados com DDL. Para mais informações sobre esquemas de gráficos de propriedades, consulte a visão geral do esquema do Spanner Graph. Se você encontrar erros ao criar um esquema de gráfico de propriedades, consulte Solução de problemas do Spanner Graph.

O painel de detalhes da aresta ao editar um esquema de gráfico no Spanner Studio

Criar um gráfico

Para começar, navegue até o Spanner Studio e clique em Criar gráfico na página inicial. A ferramenta de modelagem de gráficos oferece a flexibilidade de criar o gráfico de várias maneiras:

  • Do zero:crie nós e arestas totalmente pela interface visual. O Spanner gera automaticamente os DDLs necessários e os objetos de esquema de otimização de desempenho.

  • De tabelas atuais:mapeie suas tabelas relacionais atuais diretamente em um modelo de gráfico, desde que elas tenham conexões estabelecidas entre si.

  • Uma abordagem híbrida:modele alguns elementos do zero e mapeie outros das tabelas atuais.

Nós do modelo

Para adicionar um nó ao gráfico, siga estas etapas:

Do zero

Quando você cria um novo nó, o Spanner gera automaticamente uma tabela de banco de dados para ele. Ao definir as propriedades e chaves do nó, o Spanner configura as colunas e chaves primárias da tabela.

  1. Abra a tela de modelagem de gráficos no Spanner Studio.
  2. Adicione um nó ao gráfico e selecione Novo como a fonte de dados.
  3. Atribua um nome ao nó. A tabela criada para esse nó é nomeada de acordo com esse valor.
  4. Atribua um rótulo ao nó. Por padrão, esse rótulo corresponde ao nome do nó, mas pode ser alterado.
  5. Defina as propriedades associadas ao rótulo, incluindo os nomes e tipos de dados. Selecione É a chave do elemento para pelo menos uma propriedade para designá-la como uma chave. Selecione Não é nulo para não permitir valores nulos.

De uma tabela atual

Ao mapear um nó para uma tabela atual, o Spanner usa o esquema da tabela como base. O rótulo, as propriedades e as chaves são herdados automaticamente da tabela, mas podem ser substituídos.

  1. Abra a tela de modelagem de gráficos no Spanner Studio.
  2. Adicione um nó ao gráfico e selecione Fonte de dados atual como a fonte de dados.
  3. Atribua um rótulo ao nó. Por padrão, esse rótulo corresponde ao nome do nó, mas pode ser alterado.
  4. Defina as propriedades associadas ao rótulo. O Spanner mapeia as colunas da tabela para propriedades e as chaves primárias para chaves de elementos. É possível personalizar essa configuração fazendo o seguinte:
    • Criar novas propriedades:adicione novas propriedades, o que faz com que o Spanner crie automaticamente as colunas subjacentes na tabela.
    • Remover propriedades:remova todas as colunas mapeadas que não são necessárias para esse nó.

Arestas do modelo

Para adicionar uma aresta ao gráfico, siga estas etapas:

Do zero

Quando você cria uma nova aresta do zero, a tabela subjacente é criada automaticamente. Ao definir os nós de origem e de destino, o Spanner configura as chaves primárias necessárias e as colunas de referência em segundo plano.

  1. Abra a tela de modelagem de gráficos no Spanner Studio.

  2. Adicione uma aresta ao gráfico e selecione Novo como a fonte de dados. Insira o nome da aresta.

  3. Selecione os nós de origem e de destino. O Spanner gera as propriedades necessárias para identificar as chaves de elementos de origem e de destino, usando-as como as chaves de elementos padrão da aresta.

    Por padrão, apenas uma única aresta pode existir entre dois nós específicos, porque o Spanner usa as chaves de elementos do nó de origem e de destino para identificar exclusivamente cada aresta. Se você precisar de várias arestas entre os mesmos dois nós (um caso de uso comum no mundo real), defina uma propriedade adicional e selecione É a chave do elemento para manter cada aresta exclusiva.

  4. Atribua um rótulo à aresta. Por padrão, ele corresponde ao nome da aresta.

  5. Defina outras propriedades para a aresta.

Quando você finalizar a aresta, o Spanner vai gerar automaticamente as instruções DDL necessárias para otimizar as travessias de arestas. Para mais detalhes, consulte Revisar e gerar DDL.

De uma tabela atual

Ao mapear uma aresta para uma tabela atual, o Spanner usa o esquema da tabela como base. O rótulo, as propriedades e as chaves são herdados automaticamente da tabela, mas é possível substituí-los ou adicionar novas propriedades.

  1. Abra a tela de modelagem de gráficos no Spanner Studio.

  2. Adicione uma aresta ao gráfico e selecione Tabela atual como a fonte de dados.

  3. Selecione os nós de origem e de destino. Defina as colunas de referência de origem e de destino references columns.

  4. Atribua um rótulo à aresta. Por padrão, ele corresponde ao nome da tabela de entrada da aresta.

  5. Defina as propriedades associadas ao rótulo. O Spanner mapeia automaticamente as colunas da tabela para propriedades e as chaves primárias para chaves de elementos de arestas. É possível modificar essa configuração das seguintes maneiras:

    • Criar novas propriedades:adicione novas propriedades, e o Spanner vai criar as colunas subjacentes na tabela.
    • Remover propriedades:remova todas as colunas mapeadas que não são necessárias para essa aresta.

Para arestas criadas em tabelas atuais, o Spanner não gera instruções DDL para otimizar as travessias de arestas. Consulte a prática recomendada de esquema para aplicar otimizações manualmente.

Modificar um gráfico

É possível carregar um gráfico de propriedades atual no Spanner Studio para atualizar a estrutura dele.

  1. No Explorador de objetos, encontre o gráfico que você quer editar e escolha Visualizar/modificar visualmente no Mais opções menu.
  2. Adicione novos nós ou arestas do zero ou mapeados de tabelas atuais.
  3. Atualize as propriedades dos nós e arestas atuais. É possível usar colunas disponíveis nas tabelas subjacentes ou adicionar novas propriedades. As colunas correspondentes são adicionadas automaticamente à tabela subjacente.
  4. Remova nós ou arestas da definição do gráfico.

Revisar e gerar DDL

Quando a modelagem estiver concluída, o Spanner vai gerar as seguintes instruções DDL com base no modelo.

  • CREATE OR REPLACE PROPERTY GRAPH: cria ou atualiza a definição do gráfico.
  • CREATE TABLE: cria as tabelas subjacentes para nós ou arestas criadas do zero.
  • ALTER TABLE ADD COLUMN: adiciona novas colunas de propriedade a nós ou arestas mapeadas de tabelas atuais.
  • ALTER TABLE ADD CONSTRAINT: cria restrições de chave externa para otimizar a travessia de arestas.
  • CREATE INDEX: cria índices de arestas inversas para otimizar a travessia de arestas inversas.

Confira as mudanças no gráfico seguindo estas etapas:

  1. Pressione o botão Gerar DDL para gerar o esquema. As instruções DDL necessárias descritas anteriormente são criadas.
  2. Revise as instruções DDL geradas no editor do Spanner Studio. As instruções são apresentadas na ordem correta para execução e incluem comentários explicando cada objeto de esquema. É possível editar qualquer instrução antes de continuar.
  3. Execute as instruções para confirmar as mudanças no banco de dados.

Limitações

  • Somente mudanças aditivas:por segurança, a ferramenta não gera instruções DROP TABLE ou DROP COLUMN. A remoção de um nó, aresta ou propriedade atualiza apenas a definição de PROPERTY GRAPH. Ela não descarta as tabelas e colunas subjacentes.
  • Alguns objetos de esquema não são compatíveis:essa ferramenta não gera automaticamente todos os objetos de esquema possíveis, tipos de dados de coluna ou qualificadores. No entanto, é possível editar manualmente as instruções DDL geradas no editor antes de confirmá-las.
  • Não há suporte para salvar rascunhos:ao modelar um gráfico, o progresso não será salvo se você fechar a página.
  • Não há suporte para dados sem esquema:essa ferramenta só gera gráficos com estrutura formal. Se o caso de uso exigir dados sem esquema, use este exemplo de esquema como base para criar o gráfico de dados sem esquema.
  • Não há suporte para visualizações e tabelas de esquema nomeadas:não é possível selecionar visualizações de banco de dados ou tabelas de esquema nomeadas como uma fonte de dados ao mapear nós e arestas para fontes de dados atuais.
  • Nenhuma restrição ou índice de aresta mapeada:a ferramenta não gera restrições de chave externa ou índices de arestas inversas para arestas mapeadas de tabelas atuais. Consulte as práticas recomendadas para criação manual.

A seguir