Gemini の支援機能を使用してクエリを作成する

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

Gemini for Google Cloud がいつどのようにデータを使用するのかについての説明をご確認ください。

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

このドキュメントは、Dataform の SQL ワークフローを扱うデータ アナリスト、データ サイエンティスト、データ開発者を対象としています。Google SQL 構文と Dataform SQL ワークフロー アクションの作成方法に関する知識があることを前提としています。

始める前に

  1. In the Google Cloud console, go to the project selector page.

    Go to project selector

  2. Select or create a Google Cloud project.

  3. Gemini in BigQuery を有効にします。

クエリを生成する

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

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

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

    [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 によるデータの使用方法をご覧ください。

次のステップ