Gemini の支援機能を使用して SQL を記述する

このドキュメントでは、Gemini Code Assist を使用し、AI による支援を受けながら Spanner で次のことを行う方法について説明します。

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

このドキュメントは、Spanner、SQL、データ分析に精通したデータベース管理者とデータ エンジニアを対象としています。Spanner を初めて使用する場合は、 Google Cloud コンソールでデータベースを作成してクエリを実行するをご覧ください。

始める前に

  1. 省略可: Gemini Code Assist を設定します。

  2. このドキュメントのタスクを完了するには、必要な Identity and Access Management（IAM）権限があることを確認してください。

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

    Spanner に移動

  4. リストからインスタンスを選択します。

  5. データベースを選択します。

  6. ナビゲーション メニューで [Spanner Studio] をクリックします。

  7. タスクバーで、[pen_spark Gemini] をクリックして Spanner の Gemini 機能を表示します。

  8. 有効にする Gemini 機能を選択します。たとえば、[コメントからクエリを生成] を選択します。プロジェクトで作業している他の人に影響を与えることなく、機能を選択して試すことができます。

  9. 省略可: このドキュメントの例を使用する場合は、まずデータベースのスキーマを作成するの説明に従って Singers テーブルを作成してください。

Spanner で Gemini 機能を無効にするには、これらの手順を繰り返して、無効にする Gemini 機能の選択を解除します。

必要なロール

このドキュメントのタスクを完了するのに必要な権限を取得するには、プロジェクトに対する Gemini for Google Cloud ユーザー（roles/cloudaicompanion.user）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

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

自然言語プロンプトを使用して SQL クエリを生成する

Gemini に自然言語でのコメント（プロンプトともいいます）を与えて、スキーマに基づくクエリを生成できます。たとえば、Gemini へのプロンプトを次のように指定すると、その応答として SQL が生成されます。

  • 「顧客満足度アンケートの結果を追跡する表を作成します。」
  • 「Singers テーブルに誕生日という日付列を追加します。」
  • 「90 年代に生まれた歌手は何人ですか？」

Gemini のアシスト機能を使用して Spanner で SQL を生成する手順は以下のとおりです。

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

    Spanner に移動

  2. リストからインスタンスを選択します。

  3. データベースを選択します。

  4. ナビゲーション パネルで [Spanner Studio] をクリックします。[エクスプローラ] ペインに、データベースにあるオブジェクトのリストが表示されます。

  5. データベースにクエリを実行するには、[ New SQL editor tab] をクリックします。SQL の生成が有効になっていることを確認します。

  6. SQL を生成するには、クエリエディタに -- で始まり単一行コメントが続くコメントを入力してから、Return を押します。

    たとえば、「-- add a row to table singers」というプロンプトを入力して Return を押すと、Gemini により次のような SQL が生成されます。

    INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
VALUES (1, Alex, 'M.', '1977-10-16');

    Singers テーブルを使用して続行するために、「-- show all singers born in the 70s」というプロンプトを入力すると、Gemini により次のような SQL が生成されます。

    SELECT *
FROM Singers
WHERE Singers.BirthDate
BETWEEN '1970-01-01' AND '1979-12-31'

  7. 生成された SQL を確認して、次のいずれかを行います。

    • Gemini によって生成された SQL を受け入れるには、Tab を押してから [実行] をクリックして、推奨された SQL を実行します。
    • Gemini によって生成された SQL を編集するには、Tab を押し、SQL を編集してから [実行] をクリックします。
    • 提案を受け入れない場合は、Esc キーを押すか、キーボードからの入力を続けます。

クエリエディタで SQL ステートメントの説明を取得する

Spanner で Gemini を使用すると、SQL クエリを自然言語で説明することができます。クエリが複雑な場合や長い場合に、構文、基礎となるスキーマ、ビジネス コンテキストを理解するのにこの説明が役立ちます。

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

    Spanner に移動

  2. リストからインスタンスを選択します。

  3. データベースを選択します。

  4. ナビゲーション パネルで [Spanner Studio] をクリックします。

  5. データベースをクエリするため、[ 新しいタブ] をクリックします。

  6. クエリエディタで、クエリを貼り付けます。

  7. Gemini による説明を取得したいクエリをハイライト表示してから、[spark このクエリを説明する] をクリックします。

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

次のステップ