Gemini in Databases を設定する

コンソール

1. Gemini for Google Cloud API を有効にするには、[Gemini for Google Cloud] ページに移動します。

   [Gemini for Google Cloud] に移動

2. プロジェクト セレクタでプロジェクトを選択します。

3. [有効にする] をクリックします。

   ページが更新され、[有効] のステータスが表示されます。これで、必要な IAM ロールを持つすべてのユーザーが、選択した Google Cloud プロジェクトで Gemini を使用できるようになりました。

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

2. プロジェクト選択メニューで、プロジェクトを選択します。

3. gcloud services enable コマンドを使用して、Gemini 用の Gemini for Google Cloud API を有効にします。

   gcloud services enable cloudaicompanion.googleapis.com
   

   別の Google Cloud プロジェクトで Gemini for Google Cloud API を有効にする場合は、--project パラメータを追加します。

   gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID
   

   PROJECT_ID は、実際の Google Cloud プロジェクト ID に置き換えます。

   出力は次のようになります。

   Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
   Operation finished successfully.
   

コンソール

1. Gemini の使用に必要な IAM ロールを付与するには、[IAM と管理] ページに移動します。

   [IAM と管理] に移動

2. [プリンシパル] 列で、Gemini へのアクセスを許可するプリンシパルを見つけて、その行で edit [プリンシパルを編集] をクリックします。

3. 権限の編集ペインで、[add 別のロールを追加] をクリックします。

4. [ロールを選択] で、[Gemini for Google Cloud ユーザー] を選択します。

5. [別のロールを追加] をクリックし、[Service Usage ユーザー] を選択します。

6. [保存] をクリックします。

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

2. プロジェクト選択メニューで、プロジェクトを選択します。

3. Gemini for Google Cloud ユーザーロールを付与してください

   gcloud projects add-iam-policy-binding  PROJECT_ID \
       --member=PRINCIPAL --role=roles/cloudaicompanion.user
   

   PRINCIPAL は、プリンシパルの ID に置き換えます。識別子の形式は user|group|serviceAccount:email または domain:domain です（例えば、user:cloudysanfrancisco@gmail.com、group:admins@example.com、serviceAccount:test123@example.domain.com、domain:example.domain.com）。

   以下を含むポリシー バインディングのリストが出力されます。

   - members:
     - user:PRINCIPAL
     role: roles/cloudaicompanion.user
   

4. Service Usage ユーザーロールを付与する:

   gcloud projects add-iam-policy-binding  PROJECT_ID \
       --member=PRINCIPAL --role=roles/serviceusage.serviceUsageConsumer
   

   以下を含むポリシー バインディングのリストが出力されます。

   - members:
     - user:PRINCIPAL
     role: roles/serviceusage.serviceUsageConsumer
   

詳細については、単一のロールを付与すると gcloud projects add-iam-policy-binding をご覧ください。

AlloyDB for PostgreSQL

次の手順では、AlloyDB for PostgreSQL のインデックス アドバイザーを有効にする方法について説明します。

1. インデックス アドバイザーを有効にする前に、インスタンスで 強化された Query Insights を有効にする設定します。

2. Google Cloud コンソール で、[クラスタ] ページに移動します。

   クラスタに移動

3. クラスタとインスタンスのリストで、インスタンスをクリックします。
4. [Query Insights] をクリックします。
5. データベースとユーザーを選択します。
6. [Edit Settings] をクリックします。
7. クラスタの [Query Insights] ページでインデックス作成の推奨事項を有効にするには、[推奨事項を有効にする] を選択します。
8. 変更を保存します。

AlloyDB for PostgreSQL でインデックス アドバイザーを使用する方法について詳しくは、Query Insights でインデックス アドバイザーを使用するをご覧ください。

Cloud SQL for MySQL

次の手順では、Cloud SQL for MySQL のインデックス アドバイザーを有効にする方法について説明します。 Cloud SQL for MySQL のインデックス アドバイザーは、MySQL パフォーマンス スキーマのデータを使用します。デフォルトでは、Cloud SQL は 15 GB を超えるメモリを搭載したすべての MySQL 8.0 インスタンスで MySQL パフォーマンス スキーマを有効にします。

1. インデックス アドバイザーを有効にする前に、インスタンスで Query Insights を有効にします。
2. Cloud SQL for MySQL インスタンスで MySQL パフォーマンス スキーマをすでに有効にしている場合、インデックス アドバイザーを有効にするには、次の gcloud CLI コマンドを実行します。

gcloud sql instances patch INSTANCE_NAME \
    --database-flags=cloudsql_index_advisor=on

INSTANCE_NAME は実際のインスタンス名に置き換えます。

3. Cloud SQL for MySQL インスタンスで MySQL パフォーマンス スキーマを有効にしていない場合、インデックス アドバイザーを有効にするには、次の gcloud CLI コマンドを実行します。

gcloud sql instances patch INSTANCE_NAME \
   --database-flags=cloudsql_index_advisor=on,performance_schema=on

INSTANCE_NAME は実際のインスタンス名に置き換えます。

フラグの構成の詳細については、データベース フラグを構成するをご覧ください。

Cloud SQL for PostgreSQL

次の手順では、Cloud SQL for PostgreSQL でインデックス アドバイザーを有効にする方法について説明します。

1. インデックス アドバイザーを有効にする前に、インスタンスで Query Insights を有効にする設定します。
2. Cloud SQL for PostgreSQL インスタンスのインデックス アドバイザーを有効にするには、次の Google Cloud CLI コマンドを実行します。

gcloud sql instances patch INSTANCE_NAME \
   --database-flags=cloudsql.enable_index_advisor=on
    

INSTANCE_NAME は実際のインスタンス名に置き換えます。

フラグの構成の詳細については、データベース フラグを構成するをご覧ください。