このドキュメントでは、Gemini in Databases を使用して、Spanner で次のことを AI を活用したアシスタンスで行う方法について説明します。
Gemini for Google Cloud がデータを使用する方法とタイミングについての説明をご確認ください。
このドキュメントは、Spanner、SQL、データ分析に精通したデータベース管理者とデータ エンジニアを対象としています。Spanner を初めて使用する場合は、Google Cloud コンソールを使用してデータベースを作成してクエリを実行するをご覧ください。
始める前に
- Gemini in Databases の設定が完了していることを確認します。
- このドキュメントのタスクを完了するには、必要な Identity and Access Management（IAM）権限があることを確認してください。
Google Cloud コンソールで、[Spanner] ページに移動します。
リストからインスタンスを選択します。
データベースを選択します。
ナビゲーション メニューで [Spanner Studio] をクリックします。
タスクバーで、pen_spark [Gemini] をクリックして Spanner の Gemini の機能を表示します。
有効にする Gemini 機能を選択します。たとえば、[SQL の補完] や [コメントからクエリを生成] です。プロジェクトで作業している他の人に影響を与えることなく、自分で機能を選択して試すことができます。
省略可: このドキュメントの例に従う場合は、まずデータベースのスキーマを作成するの説明に従って
Singersテーブルを作成してください。
Spanner で Gemini の機能を無効にするには、これらの手順を繰り返して無効にする Gemini 機能の選択を解除します。
必要なロール
このドキュメントのタスクを完了するのに必要な権限を取得するには、プロジェクトに対する Gemini for Google Cloud ユーザー （roles/cloudaicompanion.user）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。
必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
自然言語プロンプトを使用して SQL クエリを生成する
Gemini の自然言語コメント（またはプロンプト）を使用すると、スキーマに基づいてクエリを生成できます。たとえば、Gemini へのプロンプトを次のように指定すると、その応答として SQL が生成されます。
- 「顧客満足度調査の結果を追跡する表を作成します。」
- 「Singers テーブルに誕生日という日付列を追加します。」
- 「90 年代に生まれた歌手は何人ですか？」
Gemini のアシスト機能を使用して Spanner で SQL を生成する手順は以下のとおりです。
Google Cloud コンソールで、[Spanner] ページに移動します。
リストからインスタンスを選択します。
データベースを選択します。
ナビゲーション パネルで [Spanner Studio] をクリックします。[エクスプローラ] ペインに、データベースにあるオブジェクトのリストが表示されます。
データベースにクエリを実行するには、 [新しい SQL エディタ] タブをクリックします。SQL の生成が有効になっていることを確認します。
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'生成された SQL を確認して次のいずれかの操作を行います。
- Gemini によって生成された SQL を受け入れるには、
Tabを押してから [実行] をクリックして、推奨される SQL を実行します。 - Gemini によって生成された SQL を編集するには、
Tabを押し、SQL を編集してから [実行] をクリックします。 - 提案を閉じるには、
Escを押すか、入力を続けます。
- Gemini によって生成された SQL を受け入れるには、
クエリエディタで SQL ステートメントを完成する
SQL コードの記述に役立つように、Spanner の Gemini によって AI が支援するコード補完の提案が提供されています。Gemini が有効化されているときは、Spanner Studio のクエリエディタにテキストを入力すると、Gemini が SQL コードを予測して自動入力します。
インライン コードの提案
インライン コードの提案を使用するには、次の手順に従います。
Google Cloud コンソールで、[Spanner] ページに移動します。
リストからインスタンスを選択します。
データベースを選択します。
ナビゲーション パネルで [Spanner Studio] をクリックします。
データベースにクエリを実行するには、 [新しい SQL エディタ] タブをクリックします。SQL 完成が有効になっていることを確認します。
行の末尾にクエリと、スペースまたは改行を入力します。テキストを入力すると、Gemini が、選択したデータベースのスキーマでサポートされているオブジェクトに基づいた推奨される SQL を表示します。
たとえば、
Singersテーブルに行を追加するには、INSERT INTO Singersという SQL の記述を開始します。Gemini は、次のような SQL を提案します。
INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate) VALUES (1, 'Marc', 'Singer', '1970-03-24')SQL の提案を確認し、次のいずれかの操作を行います。
- Gemini によって生成された SQL を受け入れるには、
Tabを押してから [実行] をクリックして、推奨される SQL を実行します。 - Gemini によって生成された SQL を編集するには、
Tabを押し、SQL を編集してから [実行] をクリックします。 - 提案を閉じるには、
Escを押すか、入力を続けます。
- Gemini によって生成された SQL を受け入れるには、
コーディングのサポートツール
コーディング サポートツールを使用するには、次の手順を行います。
Google Cloud コンソールで、[Spanner] ページに移動します。
リストからインスタンスを選択します。
データベースを選択します。
ナビゲーション パネルで [Spanner Studio] をクリックします。
データベースにクエリを実行するには、 [新しいタブ] をクリックします。
クエリエディタの横にある pen_spark [コーディング サポート] をクリックします。
[コーディング サポート] ウィンドウで、プロンプトを入力します。たとえば、
add a row to table singersを入力して [生成] をクリックします。Gemini によって次のような SQL が生成されます。
INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate) VALUES (1, Alex, 'M.', '1977-10-16');生成された SQL を確認して次のいずれかの操作を行います。
- Gemini によって生成された SQL を受け入れるには、[挿入] をクリックしてそのステートメントをクエリエディタに挿入します。次に [実行] をクリックして、推奨される SQL を実行します。
- 新しいクエリを生成するよう Gemini にリクエストするには、[編集] をクリックします。プロンプトを編集したら、[更新] をクリックします。その後、生成された新しいステートメントを受け入れるか、提案を閉じるを決定できます。
- 提案を閉じるには、[コーディング サポート] ウィンドウを閉じます。
クエリエディタで SQL ステートメントを説明する
Spanner で Gemini を使用して SQL クエリを自然言語で説明することができます。この説明は、クエリが複雑な場合や長い場合に構文、基礎となるスキーマ、ビジネス コンテキストを理解するのに役立ちます。
Google Cloud コンソールで、[Spanner] ページに移動します。
リストからインスタンスを選択します。
データベースを選択します。
ナビゲーション パネルで [Spanner Studio] をクリックします。
データベースにクエリを実行するには、 [新しいタブ] をクリックします。
クエリエディタで、クエリを貼り付けます。
Gemini による説明を取得したいクエリをハイライト表示してから、spark [このクエリを説明する] をクリックします。
SQL の説明が [Gemini] ペインに表示されます。
次のステップ
- Gemini for Google Cloud の概要を読む。
- Gemini のデータの使用方法について学習する。