注
現在、この機能はパブリック プレビュー段階にあります。 このプレビュー版はサービス レベル アグリーメントなしで提供されています。運用環境のワークロードに使用することはお勧めできません。 特定の機能はサポート対象ではなく、機能が制限されることがあります。 詳細については、「 Microsoft Azure プレビューの追加使用条件」を参照してください。
このクイック スタートでは、2 つのノードと 1 つのエッジを含む基本的なグラフを作成し、クエリを実行します。 このプロセスには約 15 分かかります。
Adventure Works の完全なデータ モデルとより高度なシナリオに関する包括的なチュートリアルについては、 Graph のチュートリアルを参照してください。
[前提条件]
このクイック スタートを開始する前に、次のことを確認します。
Graph は Fabric テナントで有効になっています。
Fabric ワークスペースのメンバーであるか、ワークスペース内にアイテムを作成するアクセス許可を持っている。 詳細については、「 Microsoft Fabric のワークスペース」を参照してください。
Important
グラフのアクセス管理は、それをホストするワークスペースに制限されます。 ワークスペースの外部のユーザーはグラフにアクセスできません。 Lakehouse 内の基になるデータにアクセスできるワークスペース内のユーザーは、グラフをモデル化してクエリを実行できます。
サンプル データを読み込む
グラフを作成するには、まず、Fabric ワークスペースの Lakehouse にサンプル データを読み込みます。
サンプル データのダウンロード
GitHub の Fabric Graph GQL サンプル データセット に移動します。
adventureworks_docs_sample.zip ファイルを選択し、ローカル コンピューターにダウンロードします。
ヒント
GitHub からファイルをダウンロードするには、ファイルを選択し、[ 生ファイルのダウンロード ] アイコンを選択します。
ダウンロードした adventureworks_docs_sample.zip ファイルをローカル コンピューター上のフォルダーに抽出します。
ヒント
エクスプローラーで zip ファイルを右クリックし、[ すべて抽出] を選択し、コピー先フォルダーを選択します。
レイクハウスを作成する
Microsoft Fabric で、ワークスペースを選択します。
+ 新規アイテム を選択します。
[>Lakehouse] を選択します。
名前 ("AdventureWorksLakehouse" など) を入力し、[ Lakehouse スキーマ ] オプションをオフにして、[ 作成] を選択します。
Important
現在、Graph では、lakehouse スキーマ (プレビュー) を有効にした lakehouse はサポートされていません。
テーブルにデータを読み込む
このクイック スタートでは、 adventureworks_customersとadventureworks_orders の 2 つのテーブルのみが必要 です。 完全なサンプル データ フォルダーをアップロードし、これら 2 つのテーブルのみを読み込みます。
- レイクハウスで、[ ファイル] にカーソルを合わせ、省略記号 (...) を選択し、[ アップロード>アップロード フォルダー] を選択します。
- 抽出したフォルダーを参照してアップロードします。 この操作により、すべてのサンプル データ ファイルが Lakehouse にアップロードされます。
- [ ファイル] とアップロードしたフォルダーを展開して、サブフォルダーを表示します。 このクイック スタートでは、そのうちの 2 つのみをテーブルとして読み込む必要があります。
- adventureworks_customersサブフォルダーにカーソルを合わせ、省略記号 (...) を選択し、[テーブルに読み込む>新しいテーブル] を選択します。
- ファイルの種類を Parquet に設定し、[ 読み込み] を選択します。
- adventureworks_orders サブフォルダーに対して手順 4 から 5 を繰り返します。
グラフ モデルを作成する
Microsoft Fabric ワークスペースで、[+ 新しい項目] を選択します。
[ データの分析とトレーニング>グラフ モデル (プレビュー) を選択します。
ヒント
または、検索ボックスに「グラフ」と入力し、 Enter キーを押してグラフ項目を検索します。
名前 ("MyFirstGraph" など) を入力し、[ 作成] を選択します。
グラフ モデルを作成すると、グラフ ビューが表示され、既定のモードが [保存]、[データの取得]、[ノードの追加]、[エッジの追加] ボタンが上部にある [モデル] に設定されていることがわかります。
グラフを作成する
Microsoft Fabric でグラフを作成するには、グラフ ビューで次の手順を実行します。
[データの取得] を選択します。
OneLake カタログから、Adventure Works データを含むレイクハウスを選択します。
[接続] を選択します。
adventureworks_customersテーブルとadventureworks_ordersテーブルを選択し、[読み込み] を選択します。
2 つのノードを追加する
[ ノードの追加] を選択します。
最初のノードを構成します。
- ラベル: 顧客
- マッピング テーブル: adventureworks_customers
- マッピング列の ID: CustomerID_K
確認 を選択します。
[ ノードの追加] をもう一度選択します。
2 番目のノードを構成します。
- ラベル: 注文
- マッピング テーブル: adventureworks_orders
- マッピング列の ID: SalesOrderDetailID_K
確認 を選択します。
1 つのエッジを追加する
[ エッジの追加] を選択します。
エッジを構成します。
- ラベル: 購入
- マッピング テーブル: adventureworks_orders
- ソース ノード: 顧客
- ソース マッピング列: CustomerID_FK
- ターゲット ノード: 順序
- ターゲット マッピング列: SalesOrderDetailID_K
確認 を選択します。
[ 保存] を 選択してグラフを読み込みます。
グラフのクエリを実行する
GQL クエリを実行して、注文数で上位 5 人の顧客を検索します。
[クエリ モード] を選択します。
上部のメニューから [コード エディター ] を選択します。
入力ボックスに次の 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[ クエリの実行 ] を選択すると、上位 5 人の顧客が注文数別に表示されます。
次の図は、GQL クエリとその結果を示しています。
おめでとうございます! Microsoft Fabric で最初のグラフを作成し、それに対してクエリを実行しました。
次のステップ
- Graph チュートリアル - 複数のノード、エッジ、クエリを含む完全なグラフを作成する
- GQL 言語ガイド - GQL 構文について学習する
- Microsoft Fabric の Graph とは - グラフの概念について学習する