管理 Spanner Graph 架构

本文档全面介绍了如何管理 Spanner Graph 属性架构，详细说明了如何使用 DDL 语句创建、更新和删除架构。

如需详细了解属性图表架构，请参阅 Spanner Graph 架构概览。 如果您在创建属性图表架构时遇到错误，请参阅排查 Spanner Graph 问题。

创建属性图表架构

如需创建属性图表架构，请执行以下操作：

  1. 创建节点输入表。
  2. 创建边缘输入表。
  3. 定义属性图。

创建属性图表架构时，请务必考虑最佳实践。

以下部分展示了如何创建属性图表架构示例：

创建节点输入表

以下代码会创建两个节点输入表（Person 和 Account），这两个表用作示例属性图表中节点定义的输入：

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

创建边缘输入表

以下代码会创建两个边缘输入表（PersonOwnAccount 和 AccountTransferAccount），作为示例属性图表中边缘定义的输入：

  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 PROPERTY GRAPH 语句定义属性图表。此语句定义了一个名为 FinGraph 的属性图表，其中包含 Account 和 Person 节点以及 PersonOwnAccount 和 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
    );

更新属性图表架构

创建属性图表架构后，您可以使用 CREATE OR REPLACE PROPERTY GRAPH 语句更新该架构。此语句通过重新创建具有所需更新的图架构来应用更改。

您可以对属性图表架构进行以下更改：

  • 添加节点或边缘定义：为节点和边缘创建新的输入表，然后使用 CREATE OR REPLACE PROPERTY GRAPH 语句将新定义添加到图表中。

  • 更新节点或边缘定义：使用新的节点和边缘定义更新底层输入表。然后，使用 CREATE OR REPLACE PROPERTY GRAPH 语句更新图中的定义。

  • 移除节点或边缘定义：使用 CREATE OR REPLACE PROPERTY GRAPH 语句，并省略要从图表中移除的定义。

添加新的节点或边缘定义

如需添加新节点和新边缘定义，请按以下步骤操作：

  1. 添加新的节点定义输入表 Company 和新的边缘定义输入表 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;

  2. 通过添加新的 Company 节点定义和新的 PersonInvestCompany 边缘定义来更新 FinGraph 架构。

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

更新节点或边缘定义

如需更新现有节点或边缘定义，请先更改底层输入表，然后使用 CREATE OR REPLACE PROPERTY GRAPH 语句将架构更改应用到图。如需自定义通过输入表公开的属性，请使用 PROPERTIES clause。如需了解详情，请参阅自定义标签和属性。

以下步骤展示了如何更新架构的基础表，然后将更新应用到架构。

  1. 向 Person 基础输入表中添加 mailing_address 列。

    ALTER TABLE Person
ADD COLUMN mailing_address STRING(MAX);

  2. 将更改应用于 Person 表格的架构。使用 CREATE OR REPLACE PROPERTY GRAPH 语句。 由于输入表架构发生了更改，Person 节点定义会反映更新后的 Person 表定义。

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

移除节点或边缘定义

如需移除现有节点或边缘定义，请重新创建不包含这些节点或边缘表的属性图表。

以下示例通过在 CREATE OR REPLACE PROPERTY GRAPH 语句中省略 Person 节点定义和 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
    );

删除属性图表架构

如需从底层输入表中删除图表架构，请使用 DROP PROPERTY GRAPH DDL 语句。删除架构时，您无法删除基础表中的数据。

以下代码会删除 FinGraph 属性图表架构：

DROP PROPERTY GRAPH FinGraph;

后续步骤