Gemini の支援機能を使用してアクションを作成する

Dataform では、Gemini Google Cloud（AI を活用したコラボレーター）を使用して、.sqlx ファイル内に SQL と Dataform のコアコードを生成できます。

Gemini for がデータを使用する方法とタイミングに関する説明をご覧ください。 Google Cloud

Dataform の Gemini では、英語のプロンプトのみがサポートされます。

このドキュメントは、Dataform でワークフローを操作するデータ アナリスト、データ サイエンティスト、データ デベロッパーを対象としています。GoogleSQL の構文と Dataform ワークフロー アクションの作成方法を理解していることを前提としています。

始める前に

  1. コンソールで、プロジェクトの選択ページに移動します。 Google Cloud

    プロジェクト セレクタに移動

  2. プロジェクトの選択または作成 Google Cloud

    プロジェクトを選択または作成するために必要なロール

    • プロジェクトを選択する: プロジェクトの選択には特定の IAM ロールは必要ありません。ロールが付与されているプロジェクトを選択できます。
    • プロジェクトを作成する: プロジェクトを作成するには、プロジェクト作成者ロール （roles/resourcemanager.projectCreator）が必要です。これには resourcemanager.projects.create 権限が含まれています。ロールを付与する方法をご覧ください。
  3. BigQuery で Gemini を有効にする。

クエリを生成する

Gemini に自然言語ステートメント（または プロンプト）を提供し、リポジトリで定義された ワークフロー アクションに基づいて SQL または Dataform のコアクエリを生成できます。たとえば、Gemini を使用して、.sqlx テーブル定義ファイル内に SQL SELECT ステートメントを生成できます。

SQL または Dataform のコアクエリを生成するには、次の手順に沿って操作します。

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

    [Dataform] ページに移動

  2. リポジトリを作成または選択し、ワークスペースを作成します。

  3. [ファイル] ペインで、.sqlx ファイルを選択または作成します。

  4. ファイルタブで pen_spark Gemini をクリックします。

  5. Gemini ダイアログで、自然言語プロンプトを入力します

    使用する SQL アクションがわかっている場合は、アクション名をプロンプトのバッククォート（`）で囲んで指定できます。

  6. [生成] をクリックします。

    Gemini は、リポジトリで定義された SQL アクションを確認し、プロンプトに関連する可能性のあるアクションを見つけて、クエリを提案します。

  7. 省略可: フィードバックを送信するには、thumb_up [候補を高く評価]、thumb_down [提案を低く評価]、またはchat_info [詳細なフィードバックを送信] をクリックします。

  8. 提案を受け入れるには、[挿入] をクリックします。

クエリ生成のヒント

次のヒントを参考にして、Dataform の Gemini から提案される候補を改善してください。

  • SQL アクション名をバッククォート（`）で囲んで指定します（例: `action_name`）。
  • 列名またはその意味関係が不明瞭または複雑な場合は、プロンプトでコンテキストを指定することで、Gemini を必要な答えに導くことができます。この手法は、プロンプト エンジニアリングと呼ばれています。たとえば、生成されたクエリで列名を参照するようにするには、列名と、求める回答との関連性を記述します。生涯価値や売上総利益のような複雑な用語を参照する回答を促すには、コンセプトと、データとの関連性を記述して、SQL の生成結果を改善します。

Gemini と Dataform のデータ

Dataform の Gemini は、アクセス権限のあるテーブルのメタデータにアクセスできます。これには、テーブル名、列名、データ型、列の説明などが含まれます。Dataform の Gemini は、テーブル、ビュー、モデルのデータにアクセスできません。Gemini によるデータの使用方法の詳細については、 Google Cloud の Gemini によるデータの使用方法をご覧ください。

次のステップ