Esta página foi traduzida pela API Cloud Translation.

Criar, atualizar ou excluir um esquema do Spanner Graph

Este documento mostra como criar, atualizar ou excluir um gráfico de propriedades no Spanner Graph usando o esquema de exemplo criado em Configurar e consultar o Spanner Graph.

Com o Spanner, é possível fazer atualizações de esquema sem tempo de inatividade. É possível atualizar o esquema de um banco de dados atual das seguintes maneiras:

Console do Google Cloud

Envie um comando na página do Spanner Studio.

Para acessar a página do Spanner Studio, clique em Spanner Studio na visão geral do banco de dados ou na tabela página de visão geral. Para mais informações sobre como acessar o Spanner Studio, consulte Gerenciar seus dados usando o console do Google Cloud.
Ferramenta de linha de comando gcloud spanner

Envie um comando usando o gcloud spanner databases ddl update kubectl.
as bibliotecas de cliente
A API REST projects.instances.databases.updateDdl
O API RPC UpdateDatabaseDdl

Criar um esquema de gráfico de propriedades

Para mais informações sobre esquemas de gráficos de propriedades, consulte a Visão geral do esquema do Spanner Graph.

Para criar um esquema de gráfico de propriedades, siga estas etapas:

Crie as tabelas de entrada de nó Person e Account. Essas tabelas são usadas como tabelas de entrada para as definições de nó no gráfico de propriedades de exemplo.

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);

Crie as tabelas de entrada de borda PersonOwnAccount e AccountTransferAccount. Essas tabelas são usadas como tabelas de entrada para as definições de aresta no exemplo de gráfico de propriedade.

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;

Defina o gráfico de propriedades usando o CREATE PROPERTY GRAPH de exemplo instrução.

O exemplo a seguir define um gráfico de propriedades chamado FinGraph com nós Account e Person, e arestas PersonOwnAccount e AccountTransferAccount.

CREATE 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
  );

Este exemplo segue estas práticas recomendadas:

Para mais informações, consulte Práticas recomendadas para design de esquema de gráfico.

Para informações sobre erros comuns de esquema do Spanner Graph, consulte Resolver problemas do Spanner Graph.

Atualizar um esquema de gráfico de propriedades

É possível atualizar um esquema de gráfico de propriedades das seguintes maneiras:

Adicione novas definições de nó ou aresta.
Atualize as definições de nó ou aresta.
Remova as definições atuais de nó ou borda.

Em cada caso, é necessário recriar o gráfico de propriedades com o esquema atualizado.

Adicionar novas definições de nó ou aresta

Para adicionar um novo nó e uma nova definição de borda, siga estas etapas:

adicionar novas tabelas de entrada.

Definir as tabelas de entrada associadas com as novas definições de elementos do gráfico. Confira o exemplo abaixo, adiciona duas novas tabelas de entrada, Company e PersonInvestCompany:

CREATE TABLE Company (
  id INT64 NOT NULL,
  name STRING(MAX)
) PRIMARY KEY (id);

CREATE TABLE PersonInvestCompany (
  id INT64 NOT NULL,
  company_id INT64 NOT NULL,
  FOREIGN KEY (company_id) REFERENCES Company (id)
) PRIMARY KEY (id, company_id),
  INTERLEAVE IN PARENT Person ON DELETE CASCADE;

Atualize o gráfico com CREATE OR REPLACE PROPERTY GRAPH. O o exemplo a seguir atualiza o esquema FinGraph adicionando um novo nó. a definição Company e uma nova definição de borda PersonInvestCompany:

CREATE OR REPLACE PROPERTY GRAPH FinGraph
  NODE TABLES (
    Person,
    Account,
    Company
  )
  EDGE TABLES (
    AccountTransferAccount
      SOURCE KEY (id) REFERENCES Account
      DESTINATION KEY (to_id) REFERENCES Account
      LABEL Transfers,
    PersonOwnAccount
      SOURCE KEY (id) REFERENCES Person
      DESTINATION KEY (account_id) REFERENCES Account
      LABEL Owns,
    PersonInvestCompany
      SOURCE KEY (id) REFERENCES Person
      DESTINATION KEY (company_id) REFERENCES Company
      LABEL Invests
  );

Atualizar definições de nó ou borda

Para atualizar definições de nó ou borda, siga estas etapas:

Atualize o esquema da tabela de entrada. O exemplo a seguir adiciona a coluna mailing_address à tabela de entrada Person.
```
ALTER TABLE Person
ADD COLUMN mailing_address STRING(MAX);
```
Atualize o esquema do gráfico de propriedades com CREATE OR REPLACE PROPERTY GRAPH. O exemplo a seguir adiciona uma nova propriedade mailing_address ao Definição do nó Person usando o CREATE OR REPLACE PROPERTY GRAPH instrução. Neste exemplo, a definição do nó Person seleciona automaticamente a definição da tabela Person alterada porque o esquema da tabela de entrada foi alterado.
```
CREATE OR REPLACE PROPERTY GRAPH FinGraph
  NODE TABLES (
    Person,
    Account
  )
  EDGE TABLES (
    AccountTransferAccount
      SOURCE KEY (id) REFERENCES Account
      DESTINATION KEY (to_id) REFERENCES Account
      LABEL Transfers,
    PersonOwnAccount
      SOURCE KEY (id) REFERENCES Person
      DESTINATION KEY (account_id) REFERENCES Account
      LABEL Owns
  );
```
Também é possível usar o PROPERTIES clause() para personalizar as propriedades exibidas nas tabelas de entrada. Para mais informações, consulte Personalize rótulos e propriedades.

Remover definições de nó ou aresta

Para remover definições de nó ou aresta, recrie o gráfico de propriedades sem essas tabelas.

O exemplo a seguir remove a definição do nó Person e o PersonOwnAccount.

CREATE OR REPLACE PROPERTY GRAPH FinGraph
  NODE TABLES (
    Account
  )
  EDGE TABLES (
    AccountTransferAccount
      SOURCE KEY (id) REFERENCES Account
      DESTINATION KEY (to_id) REFERENCES Account
      LABEL Transfers
  );

Remover um esquema de gráfico de propriedades

É possível usar a instrução DDL DROP PROPERTY GRAPH para descartar o esquema do gráfico.

O exemplo a seguir descarta o esquema de gráfico de propriedade FinGraph:

DROP PROPERTY GRAPH FinGraph;