チュートリアル: エッジの種類をグラフに追加する

このチュートリアルの手順では、エッジの種類をグラフ モデルに追加します。 エッジは、 Customer purchases OrderEmployee sells Orderなどのノード間のリレーションシップを定義します。

Important

配信元とターゲット キーの互換性、データ型の配置など、標準のエッジ マッピング要件については、「 エッジの種類を選択する」を参照してください。

Adventure Works のエッジマッピング

Adventure Works データ モデルで、ノード間のリレーションシップを定義するエッジを作成します。 これらのエッジは、どの従業員がどの注文を販売し、どの顧客が購入を行い、どのベンダーがどの製品を供給するかなど、主要なビジネス関係を把握します。 エッジを追加すると、これらのリレーションシップ全体でクエリを実行して、「特定の顧客が購入した製品」や「どのベンダーがツーリング バイクを提供しているか」などの質問に回答できます。

次の表に、グラフで使用するエッジ マッピングを示します。

エッジラベル ソーステーブル 配信元ノード/配信元キー ターゲット ノード/ターゲット キー
sells adventureworks_orders Employee / EmployeeID_FK Order / SalesOrderDetailID_K
purchases adventureworks_orders Customer / CustomerID_FK Order / SalesOrderDetailID_K
contains adventureworks_orders Order / SalesOrderDetailID_K Product / ProductID_FK
isOfType adventureworks_products Product / ProductID_K ProductSubcategory / SubcategoryID_FK
belongsTo adventureworks_productsubcategories ProductSubcategory / SubcategoryID_K ProductCategory / CategoryID_FK
produces adventureworks_vendorproduct Vendor / VendorID_FK Product / ProductID_FK

グラフにエッジの種類を追加する

グラフにエッジを追加するには、次の手順に従います。

  1. 上部のリボンで、[ エッジの追加 ] を選択してノード間のリレーションシップを作成します。

  2. [ エッジの作成] で、 Adventure Works エッジ マッピング テーブルで適切な値を参照してエッジを構成します。

    • リレーションシップを説明する エッジ ラベル を入力します。
    • ソース テーブルを選択します。
    • [配信元] ノードとそれに関連付けられている [配信元] キー列を選択します。
    • ターゲット ノードとそれに関連付けられているターゲット キー列を選択します。

    [エッジの追加] ダイアログを示すスクリーンショット。

    たとえば、最初のエッジでは、次の値を使用します。

    • エッジ ラベル: sells
    • ソース テーブル: adventureworks_orders
    • 配信元ノード: Employee
    • オリジン キー: EmployeeID_FK
    • ターゲット ノード: Order
    • ターゲット キー: SalesOrderDetailID_K

    Important

    複合キー (複数の列で構成される ID) を使用してノード タイプを構成した場合は、対応する複合キー列もここで選択する必要があります。

  3. [ 作成] を選択して、グラフにエッジを追加します。

  4. Adventure Works エッジ マッピング テーブルに記載されている残りのすべてのエッジ タイプについて、このセクションの手順を繰り返します。

ヒント

プロパティは、ノードまたはエッジの種類には自動的には追加されません。 データがリレーションシップ自体 ( contains エッジの数量や価格など) を記述するときに、プロパティを追加できます。 エッジ プロパティは、リレーションシップ レベルのデータをフィルター処理、集計、または返す GQL クエリを記述する場合に最も便利です。 このチュートリアルでは、エッジ プロパティを追加する必要はありません。 詳細については、「 エッジの種類にプロパティを追加する」を参照してください

グラフには、6 種類のエッジがすべて表示されます。

グラフに追加されたすべてのエッジを示すスクリーンショット。

グラフを読み込む

すべてのノード タイプとエッジ タイプを追加した後、上部のリボンで [保存] を選択してグラフを読み込みます。 この操作では、グラフ モデルの検証、OneLake からのデータの読み込み、グラフの構築、クエリの準備を行います。 データのサイズによっては、このプロセスに時間がかかる場合があります。 グラフが正常に読み込まれると、 データの読み込みが完了したことを示すバナーが表示されます。

データ読み込みが完了したバナーを示すスクリーンショット。

Important

現時点では、モデルまたは基になるデータを変更するたびに ( [保存] を選択して) グラフを再読み込みする必要があります。

これで、すべてのノードタイプとエッジタイプがグラフに対して定義されました。 これらのノードの種類とエッジの種類は、グラフ モデルのスキーマを形成します。 データを取り込んでノードとエッジを形成すると、グラフでクエリを実行する準備が整います。

次のステップ