设置 Gemini in Databases

如需设置 Gemini in Databases,请执行本文档中的步骤:

  1. 在 Google Cloud 项目中启用 Gemini for Google Cloud API。 通常由管理员执行此步骤。

  2. 在 Google Cloud 项目中授予 Identity and Access Management (IAM) 角色。此步骤通常由管理员执行。

  3. 激活 Gemini in Databases

  4. 启用 Recommender API

  5. 开启索引顾问(仅适用于 AlloyDB for PostgreSQL、Cloud SQL for PostgreSQL 和 Cloud SQL for MySQL)。

准备工作

如需在数据库中启用 Gemini,您必须拥有 roles/billing.admin Identity and Access Management (IAM) 角色。

在 Google Cloud 项目中启用 Gemini for Google Cloud API

本部分介绍了在 Google Cloud 项目中启用 Gemini for Google Cloud API 所需的步骤。

控制台

  1. 如需启用 Gemini for Google Cloud API,请前往 Gemini for Google Cloud 页面。

    前往适用于 Google Cloud 的 Gemini

  2. 在项目选择器中,选择一个项目。

  3. 点击启用

    该页面会更新并显示已启用状态。 Gemini 现已支持所选的 将其分配给拥有所需 Google Cloud 项目访问权限的所有用户, IAM 角色。

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.
    

适用于 Google Cloud 的 Gemini 现已在 拥有该角色的所有用户 所需的 IAM 角色

在 Google Cloud 项目中授予 IAM 角色

本部分介绍了向用户授予 Gemini for Google Cloud User 和 Service Usage Consumer IAM 角色所需的步骤。

控制台

  1. 授予使用所需的 IAM 角色 请前往 IAM 和管理页面。

    进入“IAM 和管理”

  2. 主账号列中,找到 想授予 Gemini 访问权限,然后点击 在该行中 修改主账号

  3. 修改权限窗格中,点击  添加其他角色

  4. 选择角色中,选择 Gemini for Google Cloud User

  5. 点击添加其他角色,然后选择 Service Usage Consumer

  6. 点击保存

gcloud

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

    Activate Cloud Shell

  2. 在项目选择器菜单中,选择一个项目。

  3. 授予 Gemini for Google Cloud User 角色:

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

    PRINCIPAL 替换为主账号的标识符。标识符的格式为 user|group|serviceAccount:emaildomain:domain,例如 user:cloudysanfrancisco@gmail.comgroup:admins@example.comserviceAccount:test123@example.domain.comdomain:example.domain.com

    输出是一个政策绑定列表,其中包含以下内容:

    - members:
      - user:PRINCIPAL
      role: roles/cloudaicompanion.user
    
  4. 授予 Service Usage Consumer 角色:

    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

所有已被授予这些角色的用户都可以访问 Gemini in Google Cloud 的 在指定项目中的 Google Cloud 控制台中。如需了解详情,请参阅 Google Cloud 专用 Gemini 概览

激活 Gemini in Databases

如需在 Google Cloud 项目的“数据库”中启用 Gemini,请执行以下步骤。通常由管理员或项目所有者执行这些步骤。

  1. 在 Google Cloud 控制台中,前往 Gemini for Google Cloud 页面。

    Google Cloud 专用 Gemini

  2. 点击 Gemini in Databases

    系统随即会显示探索 Gemini 窗格。

  3. 点击获取 Gemini in Databases

    系统会显示 Gemini 的管理页面。

  4. 选择要为其启用“数据库中的 Gemini”的付款账号,然后点击继续前往“数据库中的 Gemini”页面

    系统随即会显示 Gemini in Databases 页面。

  5. 点击查看条款并启用

    系统随即会显示启用 Gemini in Databases 页面。

  6. 点击购买以激活 Gemini in Databases。

启用 Recommender API

Enable the Recommender API.

Enable the API

如果 Recommender API 未列出,则表明该 API 已针对 自己的项目

开启索引顾问

您可以为 AlloyDB for PostgreSQL 和 Cloud SQL for MySQL 8.0 启用索引顾问 实例,以及 Cloud SQL for PostgreSQL 12 及更高版本实例。

AlloyDB for PostgreSQL

以下步骤介绍了如何为 AlloyDB for PostgreSQL 开启索引顾问。

  1. 在启用索引顾问之前,请在实例上启用增强型 Query Insights
  2. 在 Google Cloud 控制台中,前往集群页面。

    转到集群

  3. 在集群和实例列表中,点击一个实例。
  4. 点击 Query Insights
  5. 选择数据库和用户。
  6. 点击 Edit Settings(修改设置)。
  7. 在集群的查询数据分析上启用索引创建建议 页面上,选择启用建议
  8. 保存更改。

如需详细了解如何在 AlloyDB for PostgreSQL 中使用索引顾问, 请参阅将索引顾问与 Query Insights 搭配使用

Cloud SQL for MySQL

以下步骤介绍了如何为 Cloud SQL for MySQL 启用索引顾问。Cloud SQL for MySQL 的索引顾问使用 MySQL 性能架构中的数据。默认情况下,Cloud SQL 会在所有 MySQL 8.0 上启用 MySQL 性能架构 内存超过 15 GB 的实例。

  1. 在启用索引顾问之前,请在实例上启用 Query Insights
  2. 如果您已在 Cloud SQL for MySQL 实例上启用 MySQL 性能架构,则如需启用索引顾问,请运行以下 gcloud CLI 命令:
  3. gcloud sql instances patch INSTANCE_NAME \
        --database-flags=cloudsql_index_advisor=on

    INSTANCE_NAME 替换为您的实例名称。

  4. 如果您没有在自己的服务器上启用 MySQL 性能架构, Cloud SQL for MySQL 实例,然后如需启用索引顾问,请运行以下命令 gcloud CLI 命令:
  5. 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 命令:
  3. gcloud sql instances patch INSTANCE_NAME \
       --database-flags=cloudsql.enable_index_advisor=on
        

    INSTANCE_NAME 替换为您的实例名称。

如需详细了解如何配置标志,请参阅 配置数据库标志