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

このドキュメントでは、Google Cloudの AI を活用したコラボレーター��ある Gemini が、Cloud SQL Studio での次の作業にどのように役立つかを説明します。

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

このドキュメントは、SQL、データ������、Cloud SQL に精通しているデータベース管理者とデータ エンジニアを対象としています。Cloud SQL を初めて使用する場合は、Cloud SQL の概要をご覧ください。

始める前に

  1. このドキュメントのタスクを完了するには、必要な Identity and Access Management（IAM）権限があることを確認してください。
  2. Cloud SQL Studio へのアクセスを確認します。Cloud SQL Studio にアクセスできない場合は、Cloud SQL Studio に必要なロールと権限をご覧ください。

  3. 省略可: このドキュメントの例に従うには、次のスキーマを使用して Singers テーブルを作成します。

    CREATE TABLE
Singers (
  SingerId   BIGINT PRIMARY KEY,
  FirstName  VARCHAR(1024),
  LastName   VARCHAR(1024),
  SingerInfo MEDIUMBLOB,
  BirthDate  DATETIME
);

    Singers テーブルを作成した後に、refresh [更新] をクリックしてデータベース スキーマを更新します。

必要なロールと権限

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

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

また、クエリエディタで SQL ステートメントの説明を取得するには cloudaicompanion.companions.generateChat 権限、コーディング サポートを使用するには cloudaicompanion.companions.generateCode 権限も必要です。

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

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

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

スキーマが変化する（たとえば新しいテーブルや列の追加）場合は、Gemini を使用する前に、refresh [更新] をクリックしてスキーマを更新してください。

Cloud SQL で Gemini 支援機能を使用して SQL を生成する手順は次のとおりです。

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

    [Cloud SQL] に移動

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

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

  4. データベースの名前、ユーザー名、パスワードを使用��て Cloud SQL Studio にログインします。[エクスプローラ] ペインに、データベースにあるオブジェクトのリストが表示されます。

  5. タスクバーで [pen_sparkGemini] をクリックし、Cloud SQL の Gemini 機能を表示します。

  6. [コメントからクエリを生成] が有効になっていることを確認します。

  7. データベースにクエリを実行するには、 [新しい SQL エディタ] タブをクリックします。

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

    たとえば、次のプロンプトを入力します。

    -- add a row to table singers

    Return キーまたは Enter キーを押します。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'

  9. SQL の提案を確認し、次のいずれかの操作を行います。

    • Gemini によって生成された SQL を受け入れるためのオプションを表示するには、クエリの上にポインタを置きます。次のオプションが表示されます。
      • 同意: 提案されたクエリを受け入れるには、Tab キーを押してから [実行] をクリックします。
      • 単語を採用: 提案されたクエリを部分的に受け入れるには、Control+Right arrow（macOS では Command+Right arrow）キーを押してから [実行] をクリックします。
    • 元の SQL を編集するには、Tab キーを押し、SQL を編集してから、[実行] をクリックします。
    • 提案を受け入れない場合は、Esc キーを押すか、キーボードからの入力を続けます。

コーディングのサポートツール

コーディング サポート ツールを使用するには、次の手順で操作します。

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

    [Cloud SQL] に移動

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

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

  4. データベースの名前、ユーザー名、パスワードを使用して Cloud SQL Studio にログインします。[エクスプローラ] ペインに、データベースにあるオブジェクトのリストが表示されます。

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

  6. クエリエディタの横にある pen_spark [コーディングをサポート] をクリックします。

  7. [コーディングをサポート] ウィンドウで、プロンプトを入力します。たとえば、add a row to table singers と入力して [生成] をクリックします。

    Gemini によって次のような SQL が生成されます。

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

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

    • Gemini によって生成された SQL を受け入れるには、[挿入] をクリックしてそのステートメントをクエリエディタに挿入します。その後で、[実行] をクリックして提案された SQL を実行します。
    • 新しいクエリを生成するよう Gemini にリクエストするには、[編集] をクリックします。メッセージを編集したら、[更新] をクリックします。生成された新しいステートメントを受け入れるか、提案を閉じるを判断します。
    • 提案を受け入れない場合は、[コーディングをサポート] ウィンドウを閉じます。

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

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

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

    [Cloud SQL] に移動

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

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

  4. データベースの名前、ユーザー名、パスワードを使用して Cloud SQL Studio にログインします。[エクスプローラ] ペインに、データベースにあるオブジェクトのリストが表示されます。

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

  6. クエリエディタで、説明を取得したいクエリを貼り付けます。

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

    SQL クエリの説明が Gemini の [チャット] ウィンドウに表示されます。

Gemini を使用してクエリのエラーを修正する

Gemini に、Cloud SQL Studio を離れることなく Cloud SQL クエリのエラーを修正できる拡張機能が追加されました。

Gemini の AI を活用した機能が Cloud SQL Studio に統合され、次の利点があります。

  • Cloud SQL Studio エディタを使用して、元のクエリと推奨される変更を含む新しいクエリを 1 行ずつ比較します。
  • 問題の原因となっている可能性のある元のクエリのセグメントをハイライト表示し、変更の自然言語による概要を提供します。
  • クエリに関連付けられた正確なエラー メッセージとスキーマ情報を参照して、正確で関連性の高い修正を提供します。
  • ニュアンスの少ないヘルプを提供したり、データがセキュリティ リスクにさらされる可能性のあるサードパーティの汎用 LLM に依存する必要がなくなります。
  • 構文、スキーマ、ランタイム エラーなどの一般的な問題のトラブルシューティングをより迅速かつ効率的に行えます。

必要な権限

始める前に、次の権限があることを確認してください。

Gemini と Cloud SQL Studio を使用してクエリを修正する

Gemini の機能を使用して Cloud SQL Studio のクエリで特定のエラーを修正するには、次の操作を行います。

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

    [Cloud SQL] に移動

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

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

  4. データベースの名前、ユーザー名、パスワードを使用して Cloud SQL Studio にログインします。[エクスプローラ] ペインに、データベースにあるオブジェクトのリストが表示されます。

  5. タスクバーで [pen_sparkGemini] をクリックし、Cloud SQL の Gemini 機能を表示します。

  6. データベースに対してクエリを実行するために、 [新しいタブ] をクリックします。

  7. クエリエディタで、正しくないか不完全なクエリを入力します。

  8. [実行] をクリックします。

    クエリに問題がある場合は、エラーが返されます。

    たとえば、返されるメッセージは、[実行] タブの検証エラーや、[結果] タブのエラー メッセージなどです。

  9. [修正] をクリックします。

  10. クエリ ウィンドウのタブに差分エディタ（「diff エディタ」）が開き、既存のクエリと推奨される変更が 1 行ずつ比較されます。クエリエディタには、提案された編集内容の概要も表示されます。クエリに対する提案された変更を確認し、必要に応じて更新します。次に、新しいクエリを承認して実行します。

    [同意して実行] をクリックします。

制限事項

次のステップ