クイック スタート: Microsoft Fabric で最初のグラフを作成する

このクイック スタートでは、2 つのノードと 1 つのエッジを含む基本的なグラフを作成し、クエリを実行します。 このプロセスには約 15 分かかります。

Adventure Works の完全なデータ モデルとより高度なシナリオに関する包括的なチュートリアルについては、 Graph のチュートリアルを参照してください。

[前提条件]

このクイック スタートを開始する前に、次のことを確認します。

1. グラフは、お使いのリージョンで使用できます。

2. Graph は Fabric テナントで有効になっています。

   

3. Fabric ワークスペースのメンバーであるか、ワークスペース内にアイテムを作成するアクセス許可を持っている。 詳細については、「 Microsoft Fabric のワークスペース」を参照してください。

   Important

   グラフのアクセス管理は、それをホストするワークスペースに制限されます。 ワークスペースの外部のユーザーはグラフにアクセスできません。 Lakehouse 内の基になるデータにアクセスできるワークスペース内のユーザーは、グラフをモデル化してクエリを実行できます。

サンプル データを読み込む

グラフを作成するには、まず、Fabric ワークスペースの Lakehouse にサンプル データを読み込みます。

サンプル データのダウンロード

1. GitHub の Fabric Graph GQL サンプル データセット に移動します。

2. adventureworks_docs_sample.zip ファイルを選択し、ローカル コンピューターにダウンロードします。

   ヒント

   GitHub からファイルをダウンロードするには、ファイルを選択し、[ 生ファイルのダウンロード ] アイコンを選択します。

3. ダウンロードした adventureworks_docs_sample.zip ファイルをローカル コンピューター上のフォルダーに抽出します。

   ヒント

   エクスプローラーで zip ファイルを右クリックし、[ すべて抽出] を選択し、コピー先フォルダーを選択します。

レイクハウスを作成する

1. Microsoft Fabric で、ワークスペースを選択します。

2. + 新規アイテム を選択します。

3. [>Lakehouse] を選択します。

4. 名前 ("AdventureWorksLakehouse" など) を入力し、[ Lakehouse スキーマ ] オプションをオフにして、[ 作成] を選択します。

   Important

   現在、Graph では、lakehouse スキーマ (プレビュー) を有効にした lakehouse はサポートされていません。

テーブルにデータを読み込む

このクイック スタートでは、 adventureworks_customersとadventureworks_orders の 2 つのテーブルのみが必要 です。 完全なサンプル データ フォルダーをアップロードし、これら 2 つのテーブルのみを読み込みます。

1. レイクハウスで、[ ファイル] にカーソルを合わせ、省略記号 (...) を選択し、[ アップロード>アップロード フォルダー] を選択します。
2. 抽出したフォルダーを参照してアップロードします。 この操作により、すべてのサンプル データ ファイルが Lakehouse にアップロードされます。
3. [ ファイル] とアップロードしたフォルダーを展開して、サブフォルダーを表示します。 このクイック スタートでは、そのうちの 2 つのみをテーブルとして読み込む必要があります。
4. adventureworks_customersサブフォルダーにカーソルを合わせ、省略記号 (...) を選択し、[テーブルに読み込む>新しいテーブル] を選択します。
5. ファイルの種類を Parquet に設定し、[ 読み込み] を選択します。
6. adventureworks_orders サブフォルダーに対して手順 4 から 5 を繰り返します。

グラフ モデルを作成する

1. Microsoft Fabric ワークスペースで、[+ 新しい項目] を選択します。

2. [ データの分析とトレーニング>グラフ モデル (プレビュー) を選択します。

   

   ヒント

   または、検索ボックスに「グラフ」と入力し、 Enter キーを押してグラフ項目を検索します。

3. 名前 ("MyFirstGraph" など) を入力し、[ 作成] を選択します。

グラフ モデルを作成すると、グラフ ビューが表示され、既定のモードが [保存]、[データの取得]、[ノードの追加]、[エッジの追加] ボタンが上部にある [モデル] に設定されていることがわかります。

グラフを作成する

Microsoft Fabric でグラフを作成するには、グラフ ビューで次の手順を実行します。

1. [データの取得] を選択します。

2. OneLake カタログから、Adventure Works データを含むレイクハウスを選択します。

3. [接続] を選択します。

4. adventureworks_customersテーブルとadventureworks_ordersテーブルを選択し、[読み込み] を選択します。

   

2 つのノードを追加する

1. [ ノードの追加] を選択します。

2. 最初のノードを構成します。

   • ラベル: 顧客
   • マッピング テーブル: adventureworks_customers
   • マッピング列の ID: CustomerID_K

   

3. 確認 を選択します。

4. [ ノードの追加] をもう一度選択します。

5. 2 番目のノードを構成します。

   • ラベル: 注文
   • マッピング テーブル: adventureworks_orders
   • マッピング列の ID: SalesOrderDetailID_K

6. 確認 を選択します。

1 つのエッジを追加する

1. [ エッジの追加] を選択します。

2. エッジを構成します。

   • ラベル: 購入
   • マッピング テーブル: adventureworks_orders
   • ソース ノード: 顧客
   • ソース マッピング列: CustomerID_FK
   • ターゲット ノード: 順序
   • ターゲット マッピング列: SalesOrderDetailID_K

   

3. 確認 を選択します。

4. [ 保存] を 選択してグラフを読み込みます。

グラフのクエリを実行する

GQL クエリを実行して、注文数で上位 5 人の顧客を検索します。

1. [クエリ モード] を選択します。

2. 上部のメニューから [コード エディター ] を選択します。

3. 入力ボックスに次の GQL クエリを入力します。

   MATCH (c:Customer)-[:purchases]->(o:`Order`)
   RETURN c.fullName AS customer_name, count(o) AS num_orders
   GROUP BY customer_name
   ORDER BY num_orders DESC
   LIMIT 5
   

4. [ クエリの実行 ] を選択すると、上位 5 人の顧客が注文数別に表示されます。

次の図は、GQL クエリとその結果を示しています。

おめでとうございます! Microsoft Fabric で最初のグラフを作成し、それに対してクエリを実行しました。

次のステップ

• Graph チュートリアル - 複数のノード、エッジ、クエリを含む完全なグラフを作成する
• GQL 言語ガイド - GQL 構文について学習する
• Microsoft Fabric の Graph とは - グラフの概念について学習する