Spanner Graph データを挿入、更新、削除する

このドキュメントでは、Spanner Graph でデータを変更する方法について説明します。グラフデータの変更には、Spanner Graph でのノードとエッジの挿入、更新、削除が含まれます。

Spanner Graph は、テーブルからグラフノードとエッジにデータをマッピングします。グラフ内のデータを変更するには、対応する入力テーブルのデータを変更する必要があります。詳細については、Spanner Graph スキーマの概要をご覧ください。

始める前に

Spanner Graph を設定してクエリを実行します。

ノードまたはエッジを挿入する

ノードやエッジを挿入するには、Google Cloud コンソール、Google Cloud CLI、または Spanner クライアントライブラリを使用して、ノードテーブルまたはエッジテーブルに行を挿入します。

Google Cloud コンソールと Google Cloud CLI では、SQL データ操作言語（DML）を使用して挿入できます。Spanner クライアントライブラリでは、DML または Mutation API を使用できます。

エッジを挿入する前に、エッジで接続されたソースノードと宛先ノードが存在することを確認します。エッジで接続されているソースノードまたは宛先ノードが存在しないときにエッジを挿入すると、参照整合性違反エラーが発生することがあります。詳細については、ソースノードが存在しないため INTERLEAVE IN 関係に違反すると宛先ノードが存在しないため外部キー制約に違反するをご覧ください。

次の例では、Account ノードと Transfer エッジをグラフに挿入します。

Console

Google Cloud コンソールでステートメントを実行します。
Google Cloud コンソールで次の DML ステートメントを入力し、[クエリを実行] をクリックします。

-- Insert 2 Account nodes.
INSERT INTO Account (id, create_time, is_blocked)
VALUES (1, CAST('2000-08-10 08:18:48.463959-07:52' AS TIMESTAMP), false);
INSERT INTO Account (id, create_time, is_blocked)
VALUES (2, CAST('2000-08-12 07:13:16.463959-03:41' AS TIMESTAMP), true);

-- Insert 2 Transfer edges.
INSERT INTO AccountTransferAccount (id, to_id, create_time, amount)
VALUES (1, 2, CAST('2000-09-11 03:11:18.463959-06:36' AS TIMESTAMP), 100);
INSERT INTO AccountTransferAccount (id, to_id, create_time, amount)
VALUES (1, 1, CAST('2000-09-12 04:09:34.463959-05:12' AS TIMESTAMP), 200);

gcloud

gcloud CLI を使用してステートメントを実行します。
gcloud CLI で、次のコマンドを実行します。

gcloud spanner databases execute-sql example-db --instance=test-instance \
    --sql="INSERT INTO Account (id, create_time, is_blocked) VALUES (1, CAST('2000-08-10 08:18:48.463959-07:52' AS TIMESTAMP), false)"
gcloud spanner databases execute-sql example-db --instance=test-instance \
    --sql="INSERT INTO Account (id, create_time, is_blocked) VALUES (2, CAST('2000-08-12 07:13:16.463959-03:41'  AS TIMESTAMP), true)"
gcloud spanner databases execute-sql example-db --instance=test-instance \
    --sql="INSERT INTO AccountTransferAccount (id, to_id, create_time, amount) VALUES (1, 2, CAST('2000-09-11 03:11:18.463959-06:36' AS TIMESTAMP), 100)"
gcloud spanner databases execute-sql example-db --instance=test-instance \
    --sql="INSERT INTO AccountTransferAccount (id, to_id, create_time, amount) VALUES (1, 1, CAST('2000-09-12 04:09:34.463959-05:12' AS TIMESTAMP), 200)"

ノードまたはエッジを更新する

既存のノードやエッジを更新するには、Google Cloud コンソール、gcloud CLI、または Spanner クライアントライブラリ] を使用します。

Google Cloud コンソールと gcloud CLI では、SQL データ操作言語（DML）を使用して更新できます。Spanner クライアントライブラリでは、DML または Mutation API を使用できます。

次の例では、グラフの Account ノードと Transfer エッジを更新します。

Console

Google Cloud コンソールでステートメントを実行します。
Google Cloud コンソールで次の DML ステートメントを入力し、[クエリを実行] をクリックします。

-- Update Account node
UPDATE Account SET is_blocked = false WHERE id = 2;

-- Update Transfer edge
UPDATE AccountTransferAccount
SET amount = 300 
WHERE id = 1 AND to_id = 2;

gcloud

gcloud CLI を使用してステートメントを実行します。
gcloud CLI で、次のコマンドを実行します。

gcloud spanner databases execute-sql example-db --instance=test-instance \
    --sql="UPDATE Account SET is_blocked = false WHERE id = 2"
gcloud spanner databases execute-sql example-db --instance=test-instance \
    --sql="UPDATE AccountTransferAccount SET amount = 300 WHERE id = 1 AND to_id = 2"

次の例に示すように、Spanner Graph クエリを DML ステートメントと組み合わせることができます。

  -- Use Graph pattern matching to identify Account nodes to update:
  UPDATE Account SET is_blocked = false
  WHERE id IN {
    GRAPH FinGraph
    MATCH (a:Account WHERE a.id = 1)-[:TRANSFERS]->{1,2}(b:Account)
    RETURN b.id
  }

ノードまたはエッジを削除する

既存のノードまたはエッジを削除するには、Google Cloud コンソール、gcloud CLI、または Spanner クライアントライブラリを使用します。

Google Cloud コンソールと gcloud CLI では、SQL データ操作言語（DML）を使用して削除できます。Spanner クライアントライブラリでは、DML または Mutation API を使用できます。

ノードを削除する前に、ノードを参照するエッジがないことを確認してください。このようなタイプのエッジが存在する場合、参照整合性違反エラーが発生する可能性があります。詳細については、孤立した外向きエッジが親子関係に違反すると孤立した内向きエッジが親子関係に違反するをご覧ください。

次の例では、グラフから Transfer エッジと Account ノードを削除します。

Console

Google Cloud コンソールでステートメントを実行します。
Google Cloud コンソールで、次の DML ステートメントを入力し、[クエリを実行] をクリックします。

-- Delete Transfer edge
DELETE FROM AccountTransferAccount
WHERE id = 1 AND to_id = 2;

-- Delete Account node
DELETE FROM Account WHERE id = 2;

gcloud

gcloud CLI を使用してステートメントを実行します。
gcloud CLI で、次のコマンドを実行します。

gcloud spanner databases execute-sql example-db --instance=test-instance \
    --sql="DELETE FROM AccountTransferAccount WHERE id = 1 AND to_id = 2"
gcloud spanner databases execute-sql example-db --instance=test-instance \
    --sql="DELETE FROM Account WHERE id = 2"

次の例に示すように、Spanner Graph クエリを DML ステートメントと組み合わせることができます。

-- Use Graph pattern matching to identify Account nodes to delete:
DELETE FROM AccountTransferAccount
WHERE id IN {
  GRAPH FinGraph
  MATCH (a:Account WHERE a.id = 1)-[:TRANSFERS]->(b:Account)
  RETURN b.id
}

グラフデータを変更するオプション

グラフデータを自動的に変更するには、次の方法があります。

ON DELETE CASCADE アクションを使用して、グラフ内のエッジを自動的に削除します。
TTL ポリシーを使用して、グラフ内のノードとエッジを自動的に削除します。詳細については、ノードとエッジの TTL をご覧ください。

グラフ内のノードとエッジを一括で更新および削除するには、パーティション化 DML を使用します。

次のステップ

Spanner Graph クエリの概要を読む。
Spanner Graph クエリをチューニングするためのベストプラクティスを確認する。