Duet AI の支援を受けてクエリを記述する

このプレビュー機能へのアクセスをリクエストするには、BigQuery の Duet AI プレビューフォームをご利用ください。この機能に関するフィードバックの提供や、サポートのリクエストについては、duet-ai-bq-feedback-external@google.com までメールをお送りください。

Google Cloud の AI コラボレーターである Duet AI を使用すると、BigQuery で次のことができます。

SQL クエリを生成する。
SQL クエリを完成させる。
SQL クエリについて説明する。

Duet AI がプロンプトやそのレスポンスをデータとして使用してモデルをトレーニングすることはありせん。詳細については、Google Cloud の Duet AI がデータを使用する方法をご覧ください。

このドキュメントは、SQL クエリを扱うデータアナリスト、データサイエンティスト、データデベロッパーを対象としています。BigQuery SQL ワークスペースでデータをクエリする方法に関する知識があることを前提としています。

始める前に

Google Cloud Console の [プロジェクトセレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

注: この手順で作成するリソースをそのまま保持する予定でない場合、既存のプロジェクトを選択するのではなく、新しいプロジェクトを作成してください。チュートリアルの終了後にそのプロジェクトを削除すれば、プロジェクトに関連するすべてのリソースを削除できます。

プロジェクトセレクタに移動
Duet AI が Google Cloud ユーザーアカウントとプロジェクト用に設定されていることを確認します。

SQL クエリを生成する

Duet AI に自然言語ステートメント（またはプロンプト）を提供して、データのスキーマに基づいて SQL クエリを生成できます。コード不要で始める場合や、データスキーマの知識や Google SQL 構文の基本的な知識しかない場合でも、Duet AI は 1 つ以上の SQL ステートメントを提案できます。

SQL の生成は、BigQuery クエリエディタで # 文字を使用して開始します。その後、プロンプトに従って、必要なデータに関する自然言語のステートメントまたは質問を行います。その後、Duet AI はデータの分析に役立つ 1 つ以上の SQL ステートメントを提案します。

次の例では、BigQuery 公開データセット bigquery-public-data.austin_bikeshare.bikeshare_trips に対するクエリを生成します。

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

BigQuery Studio に移動
残りの手順は Google Cloud コンソールに自動的に表示されます。
SQL クエリエディタで、[クエリを新規作成] をクリックします。
Duet AI が Google Cloud ユーザーアカウントとプロジェクト用に設定されていることを確認します。設定が完了するまで、Duet AI のボタンは表示されません。
タスクバーで、pen_spark [Duet AI] をクリックし、[自動生成] を選択します（まだ選択されていない場合）。

クエリエディタで、次の自然言語プロンプトを入力します。

# Using `bigquery-public-data.austin_bikeshare.bikeshare_trips`, calculate the
# average trip length by subscriber type.

Enter キーを押します（macOS では Return）。

Duet AI は次のような SQL クエリを提案します。

SELECT
subscriber_type,
AVG(duration_minutes) AS average_trip_length
FROM
`bigquery-public-data.austin_bikeshare.bikeshare_trips`
GROUP BY
subscriber_type

候補を採用するには、Tab キーを押します。

Duet AI は、プロンプトに応答する複数の SQL ステートメントを提案する場合があります。次に例を示します。

クエリエディタで、次の自然言語プロンプトを入力して、Enter（macOS では Return）を押します。
```
# Write a query that creates a table in the dataset `1234` with a string column called "name"
```
Duet AI が SQL クエリを提案します。
提案されている SQL クエリの上にポインタを置きます。
その他の候補をクリックして、次のいずれかを行います。
- Tab キーを押すと、提案を採用できます。
- 特定の単語を採用するには、Ctrl+右矢印（macOS では command+右矢印）を押します。
- 候補を閉じるには、Esc キーを押します。

SQL 生成のヒント

次のヒントを使用すると、BigQuery の Duet AI による提案を改善できます。

データスキーマを取得するには、Duet AI にデータセット名とテーブル名を指定する必要があります。先頭と末尾にはバッククォート（`）を付ける必要があります。
テーブルスキーマには列の説明を含めることができます。BigQuery の Duet AI は、自然言語ステートメントに付随するプロンプトのプリアンブルとともに、列の説明情報を使用します。
列名またはその意味関係が不明瞭または複雑な場合は、プロンプトでコンテキストを指定して、Duet AI を必要な答えに導くことができます。この手法は、プロンプトエンジニアリングと呼ばれています。たとえば、生成されたクエリで列名を参照するようにするには、列名と、求める回答との関連性を記述します。生涯価値や売上総利益のような複雑な用語を参照する回答を促すには、コンセプトと、データとの関連性を記述して、SQL の生成結果を改善します。
プロンプトはクエリエディタ内の複数行に記述できますが、各行の先頭は # 文字にする必要があります。

Duet AI と BigQuery のデータ

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

SQL クエリを完成させる

SQL の補完機能では、Query Editor のコンテンツに基づいて、コンテキストに応じた推奨事項の提供が試みられます。入力に応じて、Duet AI は現在のクエリのコンテキストに関連する論理的な次のステップを提案するか、クエリを反復処理できるようにします。

Duet AI で SQL の補完機能を試すには、次の手順で操作します。

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

BigQuery Studio に移動
残りの手順は Google Cloud コンソールに自動的に表示されます。
Duet AI が Google Cloud ユーザーアカウントとプロジェクト用に設定されていることを確認します。設定が完了するまで、Duet AI のボタンは表示されません。
タスクバーで、pen_spark [Duet AI] をクリックし、[オートコンプリート] を選択します（まだ選択されていない場合）。
クエリエディタで、次の内容をコピーします。
```
SELECT
  subscriber_type
  , EXTRACT(HOUR FROM start_time) AS hour_of_day
  , AVG(duration_minutes) AS avg_trip_length
FROM
  `bigquery-public-data.austin_bikeshare.bikeshare_trips`
```
エラーメッセージは、subscriber_type がグループ化も集計もされていないことを示しています。クエリを適切に実行するためにサポートが必要になることは珍しくありません。
Enter（macOS では Return）または Space キーを押します。

Duet AI は、次のようなテキストで終わるクエリの修正を提案します。
```
GROUP BY
subscriber_type, hour_of_day;
```
候補を採用するには、Tab キーを押すか、候補のテキストの上にポインタを置いて別の候補をクリックします。提案を拒否するには、Esc を押すか、入力を続けます。

SQL クエリについて説明する

BigQuery の Duet AI で、SQL クエリを自然言語で説明するように指示できます。この説明は、クエリの長さや複雑さが原因で、構文、基礎となるスキーマ、ビジネスコンテキストの評価が難しいクエリを理解するのに役立ちます。

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

BigQuery Studio に移動
残りの手順は Google Cloud コンソールに自動的に表示されます。
Duet AI が Google Cloud ユーザーアカウントとプロジェクト用に設定されていることを確認します。設定が完了するまで、Duet AI のボタンは表示されません。
タスクバーで、pen_spark [Duet AI] をクリックし、[説明] を選択します（まだ選択されていない場合）。
クエリエディタで、説明するクエリを開くか貼り付けます。
Duet AI に説明させるクエリをハイライト表示し、pen_spark [このクエリを説明する] をクリックします。

SQL の説明が [Duet AI] ペインに表示されます。

Duet AI の機能を無効にする

BigQuery で Duet AI の機能を無効にする手順は次のとおりです。

SQL クエリエディタのタスクバーで、pen_spark [Duet AI] をクリックします。
無効にする Duet AI の機能を解除します。

フィードバックを送信する

Duet AI の提案に関するフィードバックを送信できます。

フィードバックを送信するには、タスクバーで pen_spark [Duet AI] をクリックし、[フィードバックを送信] を選択します。

次のステップ

Google Cloud での Duet AI の詳細については、Duet AI in Google Cloud の概要をご覧ください。
Duet AI データポリシーの詳細については、Duet AI in Google Cloud によるデータの使用をご覧ください。