BigQuery Graph のビジュアル モデリング ツールを使用する

この機能のサポートをリクエストする場合やフィードバックを提供する場合は、 bq-graph-preview-support@google.comまでメールでお問い合わせください。

このドキュメントでは、BigQuery Studio のビジュアル モデリング ツールを使用して、BigQuery テーブルからノードとエッジを定義する方法、グラフデータを編集してクエリする方法について説明します。`CREATE PROPERTY GRAPH` ステートメントを使用してグラフを作成することもできます。

必要なロール

グラフの作成とクエリに必要な権限を取得するには、ノードテーブル、エッジテーブル、グラフを作成するデータセットに対するBigQuery データ編集者 （roles/bigquery.dataEditor）IAM ロールの付与を管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

必要な権限は、カスタム ロールや他の事前定義 ロールから取得することもできます。

グラフを作成する

ビジュアル モデリング ツールを使用してグラフを作成する手順は次のとおりです。

  1. コンソールで、[BigQuery] ページに移動します。 Google Cloud

    BigQuery に移動

  2. ギャラリーを開くには、エディタのタブバーで、 [SQL クエリ] の横にある 矢印 をクリックし、[グラフ] をクリックします。

  3. [グラフ名] フィールドに、グラフの名前を入力します。

  4. [データセット内のグラフの宛先] フィールドで、次のいずれかを行います。

    • [新しいデータセットを作成] をクリックして、新しい データセットを作成します。
    • 既存のデータセットを選択します。

  5. データソースとして使用するテーブルを選択します。

  6. [作成] をクリックします。BigQuery はグラフリソースを作成し、ビジュアル モデリング ツールに移動します。

グラフを表示する

既存のグラフを表示する手順は次のとおりです。

  1. コンソールで、[BigQuery] ページに移動します。 Google Cloud

    BigQuery に移動

  2. ナビゲーション パネルで、 [Explorer] をクリックします。

  3. [エクスプローラ] ペインでプロジェクトを開き、[データセット] をクリックします。

  4. グラフを含むデータセットをクリックします。

  5. [グラフ] タブをクリックします。

  6. 表示するグラフを選択します。

グラフを編集する

グラフを作成したら、ビジュアル モデリング ツールを使用してノードとエッジを追加、編集、削除できます。次のセクションでは、既存のグラフを編集する方法について説明します。

ノードを管理する

このセクションでは、グラフノードを管理する方法について説明します。

ノードを追加する

ノードを追加する手順は次のとおりです。変更を 公開するまで、変更は適用されません。

  1. コンソールで、[BigQuery] ページに移動します。 Google Cloud

    BigQuery に移動

  2. ナビゲーション パネルで、 [Explorer] をクリックします。

  3. [エクスプローラ] ペインでプロジェクトを開き、[データセット] をクリックします。

  4. グラフを含むデータセットをクリックします。

  5. [グラフ] タブをクリックします。

  6. 編集するグラフを選択します。

  7. グラフのアクションバーで [新しいノード] をクリックします。

  8. [ノードを追加] パネルで [テーブルを追加] をクリックします。

  9. [テーブルを選択] ペインで、追加するデータセット テーブルを選択し、[追加] をクリックします。

  10. [ [主キーを編集]] をクリックします。

  11. 主キーとして使用するフィールドを選択し、[追加] をクリックします。

  12. 省略可: [ラベルを追加] をクリックします。

    1. [名前] フィールドに、ラベルの名前を入力します。
    2. [説明] フィールドに、ラベルの説明を入力します。
    3. [同義語] フィールドに、最大 8 個の同義語を入力します。
    4. [プロパティを追加] をクリックします。

    5. [フィールドを選択] ペインで、ラベルに追加するすべてのプロパティを選択します。

      省略可: 指標を含むカスタム フィールドを追加できます。詳細については、グラフの指標をご覧ください。

    6. [追加] をクリックします。

    7. [完了] をクリックします。

  13. [完了] をクリックします。

ノードを編集する

ノードを編集する手順は次のとおりです。変更を 公開するまで、変更は適用されません。

  1. コンソールで、[BigQuery] ページに移動します。 Google Cloud

    BigQuery に移動

  2. ナビゲーション パネルで、 [Explorer] をクリックします。

  3. [エクスプローラ] ペインでプロジェクトを開き、[データセット] をクリックします。

  4. グラフを含むデータセットをクリックします。

  5. [グラフ] タブをクリックします。

  6. 編集するグラフを選択します。

  7. グラフで、編集するノードを選択します。

  8. [**ノード ウィンドウ**] で、[**編集**] をクリックします。

  9. [**ノードを編集**] パネルで、 [**主キーを編集**] をクリックします。

  10. 主キーとして使用するフィールドを選択し、[追加] をクリックします。

  11. 省略可: [ラベルを追加] をクリックします。

    1. [名前] フィールドに、ラベルの名前を入力します。
    2. [説明] フィールドに、ラベルの説明を入力します。
    3. [同義語] フィールドに、最大 8 個の同義語を入力します。
    4. [プロパティを追加] をクリックします。
    5. [フィールドを選択] ペインで、ラベルに追加するすべてのプロパティを選択します。
    6. [追加] をクリックします。
    7. 省略可: [**指標を追加**] をクリックして、グラフの指標で説明されているように、指標を含むカスタム フィールドを追加します。
    8. [完了] をクリックします。

  12. [完了] をクリックします。

ノードを削除する

ノードを削除する手順は次のとおりです。変更を 公開するまで、変更は適用されません。

  1. コンソールで、[BigQuery] ページに移動します。 Google Cloud

    BigQuery に移動

  2. ナビゲーション パネルで、 [Explorer] をクリックします。

  3. [エクスプローラ] ペインでプロジェクトを開き、[データセット] をクリックします。

  4. グラフを含むデータセットをクリックします。

  5. [グラフ] タブをクリックします。

  6. 編集するグラフを選択します。

  7. グラフで、削除するノードを選択します。

  8. [ノード ウィンドウ] で、 [削除] をクリックします。

  9. [削除] をクリックします。

エッジを管理する

このセクションでは、グラフエッジを管理する方法について説明します。

エッジを追加する

エッジを追加する手順は次のとおりです。変更を 公開するまで、変更は適用されません。

  1. コンソールで、[BigQuery] ページに移動します。 Google Cloud

    BigQuery に移動

  2. ナビゲーション パネルで、 [Explorer] をクリックします。

  3. [エクスプローラ] ペインでプロジェクトを開き、[データセット] をクリックします。

  4. グラフを含むデータセットをクリックします。

  5. [グラフ] タブをクリックします。

  6. 編集するグラフを選択します。

  7. グラフのアクションバーで [新しいエッジ] をクリックします。

  8. [エッジを追加] パネルで [テーブルを追加] をクリックします。

  9. [テーブルを選択] ペインで、データソースとして使用するテーブルを選択し、[追加] をクリックします。

  10. [ソースノード] リストで、ソースとして使用するノードを選択します。

  11. [ノードで参照される列を追加] をクリックします。

    1. 参照するフィールドを選択します。
    2. [追加] をクリックします。

  12. [ターゲット ノード] リストで、ターゲットとして使用するノードを選択します。

  13. [ノードで参照される列を追加] をクリックします。

    1. 参照するフィールドを選択します。
    2. [追加] をクリックします。

  14. [エッジで参照される列を追加] をクリックします。

    1. 参照するフィールドを選択します。これらのエッジ列の列数とデータ型は、ソースノードとターゲット ノードに選択した参照列と一致する必要があります。
    2. [追加] をクリックします。

  15. 省略可: [ラベルを追加] をクリックします。

    1. [名前] フィールドに、ラベルの名前を入力します。
    2. [説明] フィールドに、ラベルの説明を入力します。
    3. [同義語] フィールドに、最大 8 個の同義語を入力します。
    4. [プロパティを追加] をクリックします。
    5. [フィールドを選択] ペインで、ラベルに追加するすべてのプロパティを選択します。
    6. [追加] をクリックします。
    7. 省略可: [**指標を追加**] をクリックして、グラフの指標で説明されているように、指標を含むカスタム フィールドを追加します。
    8. [完了] をクリックします。

  16. [完了] をクリックします。

エッジを編集する

エッジを編集する手順は次のとおりです。変更を 公開するまで、変更は適用されません。

  1. コンソールで、[BigQuery] ページに移動します。 Google Cloud

    BigQuery に移動

  2. ナビゲーション パネルで、 [Explorer] をクリックします。

  3. [エクスプローラ] ペインでプロジェクトを開き、[データセット] をクリックします。

  4. グラフを含むデータセットをクリックします。

  5. [グラフ] タブをクリックします。

  6. 編集するグラフを選択します。

  7. グラフで、編集するエッジを選択します。

  8. [**ノード ウィンドウ**] で、[**編集**] をクリックします。

  9. [エッジを編集] パネルの [ソースノード] リストで、ソースとして使用するノードを選択します。

  10. [ノードで参照される列を追加] をクリックします。

    1. 参照するフィールドを選択します。
    2. [追加] をクリックします。

  11. [ターゲット ノード] リストで、ターゲットとして使用するノードを選択します。

  12. [ノードで参照される列を追加] をクリックします。

    1. 参照するフィールドを選択します。
    2. [追加] をクリックします。

  13. [エッジで参照される列を追加] をクリックします。

    1. 参照するフィールドを選択します。これらのエッジ列の列数とデータ型は、ソースノードとターゲット ノードに選択した参照列と一致する必要があります。
    2. [追加] をクリックします。

  14. 省略可: [ラベルを追加] をクリックします。

    1. [名前] フィールドに、ラベルの名前を入力します。
    2. [説明] フィールドに、ラベルの説明を入力します。
    3. [同義語] フィールドに、最大 8 個の同義語を入力します。
    4. [プロパティを追加] をクリックします。
    5. [フィールドを選択] ペインで、ラベルに追加するすべてのプロパティを選択します。
    6. [追加] をクリックします。
    7. 省略可: [**指標を追加**] をクリックして、グラフの指標で説明されているように、指標を含むカスタム フィールドを追加します。
    8. [完了] をクリックします。

  15. [完了] をクリックします。

エッジを削除する

エッジを削除する手順は次のとおりです。変更を 公開するまで、変更は適用されません。

  1. コンソールで、[BigQuery] ページに移動します。 Google Cloud

    BigQuery に移動

  2. ナビゲーション パネルで、 [Explorer] をクリックします。

  3. [エクスプローラ] ペインでプロジェクトを開き、[データセット] をクリックします。

  4. グラフを含むデータセットをクリックします。

  5. [グラフ] タブをクリックします。

  6. 編集するグラフを選択します。

  7. グラフで、削除するエッジを選択します。

  8. [ノード ウィンドウ] で、 [削除] をクリックします。

  9. 削除を確認します。

グラフの変更を公開する

変更を保存するには、グラフリソースに公開します。手順は次のとおりです。

  1. コンソールで、[BigQuery] ページに移動します。 Google Cloud

    BigQuery に移動

  2. ナビゲーション パネルで、 [Explorer] をクリックします。

  3. [エクスプローラ] ペインでプロジェクトを開き、[データセット] をクリックします。

  4. グラフを含むデータセットをクリックします。

  5. [グラフ] タブをクリックします。

  6. 編集するグラフを選択します。

  7. 編集が完了したら、[公開] をクリックします。

  8. [グラフを公開] ペインで CREATE PROPERTY GRAPH ステートメントを確認し、[公開] をクリックします。

次のステップ