GRAPH_ID_FROM_EDGE_ID(Transact-SQL)

適用対象: Sql Server 2017 (14.x) 以降のバージョン Azure SQL DatabaseAzure SQL Managed InstanceSQL データベース

SQLグラフテーブルでは、 GRAPH_ID_FROM_EDGE_ID 関数は特定のエッジIDの内部グラフIDを返します。

構文

GRAPH_ID_FROM_EDGE_ID ( edge_id )

引数

edge_id

エッジ テーブルの $edge_id 擬似列の文字表現 (JSON)。

戻り値

内部グラフ ID を bigint で返します。

注釈

  • 指定したエッジの文字表現 (JSON) の解析と検証によるパフォーマンス オーバーヘッドのため、GRAPH_ID_FROM_EDGE_ID は必要な場合にのみ使う必要があります。 ほとんどの場合、グラフ テーブルのクエリには MATCH で十分です。
  • GRAPH_ID_FROM_EDGE_ID から値が返されるためには、指定した文字の JSON が有効であり、JSON 内で指定した schema.table が有効なエッジ テーブルである必要があります。
  • 関数からグラフ ID が返された場合、それが有効な整数であることだけが保証されます。 グラフ ID がエッジ テーブルに存在するかどうかのチェックは行われません。
  • グラフ ID のデータ型と動作は実装に固有の詳細であり、変更される可能性があります。 たとえば、特定のエッジ テーブル内のグラフ ID が連番であると想定すべきではありません。

グラフテーブルはSQL Server 2017で導入されました。 GRAPH_ID_FROM_EDGE_ID機能は2016年SQL ServerおよびFabric Data Warehouseでは利用できません。

例

次の例では、friendOf エッジ テーブル内のエッジの内部グラフ ID が返されます。

SELECT GRAPH_ID_FROM_EDGE_ID($edge_id)
FROM friendOf;

結果は次のようになります。

...
25073
98943
69725
68781
30354
...