配置托管式连接池

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

控制台

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
  }
}