配置托管式连接池

控制台

1. 前往集群页面。

   转到集群

2. 在资源名称列中点击相应集群。

3. 在概览页面中，前往集群中的实例。

4. 点击修改主实例或修改读取池。

5. 在托管式连接池下，勾选启用托管式连接池对应的复选框。

6. 可选：如需配置托管式连接池选项，请点击高级池选项。

   您可以自定义托管式连接池选项，以满足实例的需求。如需了解详情，请参阅高级配置选项。

7. 点击保存更改。

gcloud

如需为现有主实例或读取池实例启用托管式连接池，请使用以下 gcloud alpha alloydb instances update 命令：

gcloud alpha alloydb instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --enable-connection-pooling

替换以下内容：

• INSTANCE_ID：您要为其启用托管式连接池的 AlloyDB 实例的 ID。
• PROJECT_ID：项目的 ID。
• REGION_ID：区域的 ID。
• CLUSTER_ID：集群的 ID。

启用托管式连接池后，您可以通过设置高级配置选项来自定义托管式连接池选项，以满足实例的需求。如需详细了解如何设置配置选项，请参阅为实例修改托管式连接池。

REST

如需为现有的主实例或读取池实例启用托管式连接池，请使用以下命令并设置 connectionPoolConfig：

在使用任何请求数据之前，请先进行以下替换：

• PROJECT_ID：项目的 ID。
• LOCATION_ID：集群区域的 ID。
• CLUSTER_ID：集群的 ID。它必须以小写字母开头，可以包含小写字母、数字和连字符。
• INSTANCE_ID：实例的 ID。

HTTP 方法和网址：

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

请求 JSON 正文：

{
  "connectionPoolConfig": {
    "enabled": true
  }
}

控制台

1. 前往集群页面。

   转到集群

2. 在资源名称列中点击相应集群。

3. 在概览页面中，前往集群中的实例。

4. 点击您要修改的实例对应的修改实例或修改读取池。

5. 在托管式连接池下，展开高级池选项。

6. 修改您要更新的高级池选项。您可以修改以下选项：

   • 连接模式
   • 池大小上限
   • 池大小下限
   • 客户端连接数上限
   • 空闲客户端连接超时（秒）
   • 空闲服务器连接超时（秒）
   • 查询等待超时（秒）
   • 预处理语句数上限
   • 忽略启动参数
   • 服务器生命周期（秒）

7. 点击更新实例。

gcloud

如需为现有实例修改托管式连接池配置选项，请使用以下 gcloud alpha alloydb instances update 命令：

  gcloud alpha alloydb instances update INSTANCE_ID \
    --project=PROJECT_ID \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    { \
      --connection-pooling-pool-mode=CONNECTION_MODE \
      | --connection-pooling-max-pool-size=MAX_POOL_SIZE \
      | --connection-pooling-min-pool-size=MIN_POOL_SIZE \
      | --connection-pooling-max-client-connections=MAX_CLIENT_CONNECTION \
      | --connection-pooling-server-idle-timeout=SERVER_IDLE_TIMEOUT_PERIOD \
      | --connection-pooling-query-wait-timeout=QUERY_WAIT_TIMEOUT_PERIOD \
      | --connection-pooling-ignore-startup-parameters=IGNORE_STARTUP_PARAMETERS \
    }

替换以下内容：

• INSTANCE_ID：您要为其停用托管式连接池的 AlloyDB 实例的名称。
• PROJECT_ID：项目的 ID。
• REGION_ID：区域的 ID。
• CLUSTER_ID：集群的 ID。

• 您可以配置以下选项：

  • --connection-pooling-pool-mode。此选项必须是 session 或 transaction 之一。
  • --connection-pooling-max-pool-size
  • --connection-pooling-min-pool-size
  • --connection-pooling-max-client-connections
  • --connection-pooling-server-idle-timeout
  • --connection-pooling-query-wait-timeout
  • --connection-pooling-ignore-startup-parameters

REST

如需为现有读取池实例修改托管式连接池配置选项，请使用以下命令并设置 connectionPoolConfig：

在使用任何请求数据之前，请先进行以下替换：

• PROJECT_ID：项目的 ID。
• LOCATION_ID：集群区域的 ID。
• CLUSTER_ID：您创建的集群的 ID。它必须以小写字母开头，可以包含小写字母、数字和连字符。
• INSTANCE_ID：您创建的实例的 ID。

• 您可以配置以下选项：

  • POOL_MODE。此选项必须是 session 或 transaction 之一。
  • MAX_POOL_SIZE
  • MIN_POOL_SIZE
  • MAX_CLIENT_CONNECTION
  • SERVER_IDLE_TIMEOUT
  • QUERY_WAIT_TIMEOUT
  • IGNORE_STARTUP_PARAMETERS

HTTP 方法和网址：

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

请求 JSON 正文：

{
  "connectionPoolConfig": {
    "enabled": true,
    "flags": {
      "pool_mode": "POOL_MODE",
      "max_pool_size": "MAX_POOL_SIZE",
      "min_pool_size": "MIN_POOL_SIZE",
      "max_client_connection": "MAX_CLIENT_CONNECTION",
      "server_idle_timeout": "SERVER_IDLE_TIMEOUT",
      "query_wait_timeout": "QUERY_WAIT_TIMEOUT",
      "ignore_startup_parameters": "IGNORE_STARTUP_PARAMETERS"
    },
  }
}

控制台

1. 前往集群页面。

   转到集群

2. 在资源名称列中点击相应集群。

3. 在概览页面中，找到您要查看其托管式连接池的状态的实例。托管式连接池字段显示其处于启用状态还是处于停用状态。

gcloud

如需查看现有实例的托管式连接池的状态，请使用以下 gcloud alpha alloydb instances describe 命令：

gcloud alpha alloydb instances describe INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --format="value(connectionPoolConfig.enabled)"

替换以下内容：

• INSTANCE_ID：您要为其修改托管式连接池选项的 AlloyDB 实例的名称。
• PROJECT_ID：项目的 ID。
• REGION_ID：区域的 ID。
• CLUSTER_ID：集群的 ID。

如果启用了托管式连接池，系统会返回以下响应：

True

REST

如需查看 AlloyDB 实例的托管式连接池的状态，请使用以下命令并查找 connectionPoolConfig：

在使用任何请求数据之前，请先进行以下替换：

• PROJECT_ID：项目的 ID。
• LOCATION_ID：集群区域的 ID。
• CLUSTER_ID：您创建的集群的 ID。它必须以小写字母开头，可以包含小写字母、数字和连字符。
• INSTANCE_ID：您创建的实例的 ID。

HTTP 方法和网址：

GET https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

控制台

1. 前往集群页面。

   转到集群

2. 在资源名称列中点击相应集群。

3. 在概览页面中，前往集群中的实例。

4. 点击您要为其停用托管式池连接的实例对应的修改实例或修改读取池。

5. 在托管式连接池下，清除启用托管式连接池对应的复选框。

6. 点击更新实例。

gcloud

如需为现有实例停用托管式连接池，请使用以下 gcloud alpha alloydb instances update 命令：

gcloud alpha alloydb instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --no-enable-connection-pooling

替换以下内容：

• INSTANCE_ID：您要为其停用托管式连接池的 AlloyDB 实例的名称。
• PROJECT_ID：项目的 ID。
• REGION_ID：区域的 ID。
• CLUSTER_ID：集群的 ID。

REST

如需为现有读取池实例停用托管式连接池，请使用以下命令并将 connectionPoolConfig 设置为 false：

在使用任何请求数据之前，请先进行以下替换：

• PROJECT_ID：项目的 ID。
• LOCATION_ID：集群区域的 ID。
• CLUSTER_ID：您创建的集群的 ID。它必须以小写字母开头，可以包含小写字母、数字和连字符。
• INSTANCE_ID：您创建的实例的 ID。

HTTP 方法和网址：

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

请求 JSON 正文：

{
  "connectionPoolConfig": {
    "enabled": false
  }
}