讀取集區自動調度資源

讀取集區自動調度資源功能會根據應用程式的工作負載需求，自動在讀取集區中新增或移除讀取集區節點。

您可以透過限制讀取集區的平均 CPU 使用率，或限制允許存取讀取集區的用戶端連線數量，控管讀取集區自動調度資源，方法是使用下列其中一個目標指標：

  • 平均 CPU 使用率：可設定讀取集區的平均 CPU 使用率。讀取集區會根據應用程式工作負載的 CPU 使用率，自動擴大或縮小。
  • 平均資料庫連線數：可指定每個節點應服務的平均用戶端資料庫連線數。讀取集區會根據用戶端連線數量，自動擴充或縮減。

如要套用這些目標指標，您也必須設定讀取集區節點計數的下限和上限。

如要啟用讀取集區自動調度資源，您可以在執行個體上設定一或兩項目標指標。如果這兩項指標都處於啟用狀態，Cloud SQL 會套用這兩項指標所指出的最大讀取集區節點數。

下表列出各目標指標的限制：

目標指標名稱 限制 相關公開指標
平均 CPU 使用率 介於 0.1 和 0.9 之間。 讀取集區中讀取集區節點的平均 CPU 使用率 (cloudsql.googleapis.com/database/cpu/utilization)。
平均資料庫連線數 介於 10 到 262,142 之間。 注意：可接受的上限值與 max_connections 資料庫旗標設定的上限值相關。 代表讀取集區中讀取集區節點的資料庫用戶端連線平均數 (cloudsql.googleapis.com/database/postgresql/num_backends)。注意：在執行個體上啟用代管連線集區時，構成連線集區的個別連線不會分開計算，也不會納入 AVERAGE_DB_CONNECTIONS 指標。如果啟用代管連線集區，建議只使用 AVERAGE_CPU_UTILIZATION 指標來控管讀取集區自動調度資源功能。

符合調整讀取集區大小的條件時，您可以透過 Google Cloud 控制台查看讀取集區自動調度資源作業。讀取集區和主要執行個體的所有其他作業都會遭到封鎖，直到讀取集區自動調整大小完成為止。

讀取集區自動調度資源特性

須符合下列特徵：

  • 縮減作業一次只會移除一個節點。
  • 向外擴充作業，並行新增所需節點。
  • 根據預設，系統會套用縮減和擴充作業。您可以選擇手動停用縮減作業 (disableScaleIn)，藉此封鎖這類作業。
  • 根據預設，連續讀取集區自動調度資源作業之間會套用 600 秒的等待期。無論是擴大或縮減規模，都必須有至少 60 秒的冷卻期。
  • 設定目標指標時，您也必須定義要使用的讀取集區節點數量下限 (minNodeCount) 和上限 (maxNodeCount)。如果為現有讀取集區啟用自動調度資源功能，目前的讀取集區大小必須在您設定的範圍內。

限制

限制如下：

  • 讀取集區自動調度資源功能每 24 小時最多可執行 10 次自動調度資源作業。
  • 如要建立新的讀取集區或擴充現有讀取集區，請等待先前的建立和擴充作業完成。這適用於與讀取集區相關聯的作業，以及與相同主要執行個體相關聯的其他讀取集區。如果嘗試執行並行作業，可能會收到下列錯誤訊息：
    Operation failed because another operation was already in progress.

事前準備

  • 請務必為 max_wal_senders 和 max_replication_slots 設定適當的值。詳情請參閱「讀取集區特性」。

建立啟用自動調度資源功能的讀取集區

如果為 AVERAGE_CPU_UTILIZATION 指定 0.50 的目標值，系統會從讀取集區新增或移除讀取集區節點，讓讀取集區的平均 CPU 使用率維持在 0.50 以下。

gcloud

如要建立啟用自動調度資源功能的讀取集區，請執行下列指令：

  gcloud sql instances create READ_POOL_NAME \
  --tier=MACHINE_TIER --edition=ENTERPRISE_PLUS \
  --instance-type=READ_POOL_INSTANCE --node-count=NODE_COUNT \
  --database-version=DATABASE_VERSION \
  --master-instance-name=PRIMARY_INSTANCE_NAME \
  --region=REGION --network=NETWORK_NAME \
  --no-assign-ip \
  --auto-scale-enabled \
  --auto-scale-max-node-count=MAX_NODE_COUNT \
  --auto-scale-min-node-count=MIN_NODE_COUNT \
  --auto-scale-target-metrics=TARGET_METRIC_1=VALUE_1

更改下列內容：

  • READ_POOL_NAME：您要指派給讀取集區的名稱。
  • MACHINE_TIER：要使用的機器層級，例如 db-perf-optimized-N-2。
  • NODE_COUNT：您想從這個讀取集區節點數量開始。
  • DATABASE_VERSION：您要使用的資料庫版本，例如 POSTGRES_16。
  • PRIMARY_INSTANCE_NAME：要使用的主要執行個體名稱。
  • REGION：要使用的區域，例如 us-east1。
  • NETWORK_NAME：要使用的網路名稱。
  • MAX_NODE_COUNT：讀取集區要使用的讀取集區節點數量上限，例如 5。
  • MIN_NODE_COUNT：讀取集區要使用的讀取集區節點數量下限，例如 1。
  • TARGET_METRIC_1：您要使用的目標指標，例如：
    • AVERAGE_CPU_UTILIZATION
    • AVERAGE_DB_CONNECTIONS
    您必須定義至少一項可用指標。
  • VALUE_1：您要為先前指定的目標指標指派的值。舉例來說，您可以為 AVERAGE_CPU_UTILIZATION 目標指標指派 0.50 值。

Terraform

如要建立啟用自動調度資源功能的讀取集區，請使用 Terraform 資源。

下列範例包含主要執行個體和讀取集區的資源。


resource "google_sql_database_instance" "primary" {
  name             = "postgres-primary"
  database_version = "POSTGRES_17"
  region           = "europe-west4"

  instance_type = "CLOUD_SQL_INSTANCE"

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"

    backup_configuration {
      enabled = true
    }

    ip_configuration {
      ipv4_enabled = true
    }
  }
}

resource "google_sql_database_instance" "replica" {
  name             = "postgres-replica"
  database_version = "POSTGRES_17"
  region           = "europe-west4"

  master_instance_name = google_sql_database_instance.primary.name
  instance_type        = "READ_POOL_INSTANCE"
  node_count           = 2

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"

    ip_configuration {
      ipv4_enabled = true
    }
    read_pool_auto_scale_config {
      enabled                    = true
      disable_scale_in           = false
      max_node_count             = 20
      min_node_count             = 2
      scale_in_cooldown_seconds  = 600
      scale_out_cooldown_seconds = 600
      target_metrics {
        metric       = "AVERAGE_CPU_UTILIZATION"
        target_value = 0.5
      }
    }
  }
}

套用變更

如要在 Google Cloud 專案中套用 Terraform 設定，請完成下列各節的步驟。

準備 Cloud Shell

  1. 啟動 Cloud Shell。

  2. 設定要套用 Terraform 設定的預設 Google Cloud 專案。

    每個專案只需要執行一次這個指令，而且可以在任何目錄中執行。

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    如果您在 Terraform 設定檔中設定明確值，環境變數就會遭到覆寫。

準備目錄

每個 Terraform 設定檔都必須有自己的目錄 (也稱為根模組)。

  1. 在 Cloud Shell 中建立目錄，並在該目錄中建立新檔案。檔案名稱的副檔名必須是 .tf，例如 main.tf。在本教學課程中，這個檔案稱為 main.tf。
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. 如果您正在學習教學課程，可以複製每個章節或步驟中的範例程式碼。

    將範例程式碼複製到新建立的 main.tf 中。

    視需要從 GitHub 複製程式碼。如果 Terraform 代码片段是端對端解決方案的一部分，建議您使用這個方法。

  3. 查看並修改範例參數，套用至您的環境。
  4. 儲存變更。
  5. 初始化 Terraform。每個目錄只需執行一次這項操作。 
    terraform init

    如要使用最新版 Google 供應商，請加入 -upgrade 選項： 

    terraform init -upgrade

套用變更

  1. 檢查設定，確認 Terraform 即將建立或更新的資源符合您的預期：
    terraform plan

    視需要修正設定。

  2. 執行下列指令，然後在提示中輸入 yes，套用 Terraform 設定： 
    terraform apply

    等待 Terraform 顯示「Apply complete!」訊息。

  3. 開啟 Google Cloud 專案即可查看結果。在 Google Cloud 控制台中，前往 UI 中的資源，確認 Terraform 已建立或更新這些資源。

刪除變更

如要刪除變更，請按照下列步驟操作：

  1. 如要停用防刪除功能，請在 Terraform 設定檔中將 deletion_protection 引數設為 false。 
    deletion_protection =  "false"
  2. 執行下列指令，並在提示中輸入 yes，套用更新的 Terraform 設定： 
    terraform apply

  1. 執行下列指令，並在提示中輸入 yes，移除先前透過 Terraform 設定套用的資源：

    terraform destroy

REST v1

如要建立啟用自動調度資源功能的讀取集區，請使用 instances:insert 方法發出 POST 要求。

使用任何要求資料之前，請先替換以下項目：

  • READ_POOL_NAME：您要指派給讀取集區的名稱。
  • REGION：您希望執行個體所在的區域，例如 us-central1。
  • PRIMARY_INSTANCE_ID：要使用的主要執行個體 ID。
  • PROJECT_ID：您要將讀取集區放置在其中的專案 ID，例如 my-project-name。
  • DATABASE_VERSION：您要使用的資料庫版本，例如 POSTGRES_16。
  • MACHINE_TIER：要使用的機器層級，例如 db-perf-optimized-N-2。
  • FULL_NETWORK_NAME：要使用的網路名稱。
  • MAX_NODE_COUNT：讀取集區要使用的讀取集區節點數量上限，例如 10。
  • MIN_NODE_COUNT：讀取集區要使用的讀取集區節點數量下限，例如 2。
  • TARGET_METRIC_1：您要使用的目標指標，例如 AVERAGE_CPU_UTILIZATION 或 AVERAGE_DB_CONNECTIONS。您必須定義至少一項可用指標。
  • VALUE_1：您要為先前指定的目標指標指派的值。舉例來說，您可以為 AVERAGE_CPU_UTILIZATION 目標指標指派 0.50 值。
  • NODE_COUNT：您要開始使用的讀取集區節點計數，例如 3。

HTTP 方法和網址：

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

JSON 要求主體：

{
  "name":"READ_POOL_NAME",
  "region":"REGION",
  "masterInstanceName":"PRIMARY_INSTANCE_ID",
  "project":"PROJECT_ID",
  "databaseVersion":"DATABASE_VERSION",
  "settings":{
    "tier":"MACHINE_TIER",
    "edition":"ENTERPRISE_PLUS",
    "ipConfiguration":{
      "privateNetwork":"FULL_NETWORK_NAME",
      "ipv4Enabled": false
    },
    "readPoolAutoScaleConfig":{
      "enabled": true,
      "minNodeCount": MIN_NODE_COUNT,
      "maxNodeCount": MAX_NODE_COUNT,
      "targetMetrics": [
        {
          "metric":"TARGET_METRIC_1",
          "targetValue": VALUE_1
        }
      ]
    }
  },
  "instanceType":"READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_ID",
  "status": "RUNNING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "2023-06-14T18:48:35.499Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "PRIMARY_INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

如要建立啟用自動調度資源功能的讀取集區，請使用 instances:insert 方法發出 POST 要求。

使用任何要求資料之前，請先替換以下項目：

  • READ_POOL_NAME：您要指派給讀取集區的名稱。
  • REGION：您希望執行個體所在的區域，例如 us-central1。
  • PRIMARY_INSTANCE_ID：要使用的主要執行個體 ID。
  • PROJECT_ID：您要將讀取集區放置在其中的專案 ID，例如 my-project-name。
  • DATABASE_VERSION：您要使用的資料庫版本，例如 POSTGRES_16。
  • MACHINE_TIER：要使用的機器層級，例如 db-perf-optimized-N-2。
  • FULL_NETWORK_NAME：要使用的網路名稱。
  • MAX_NODE_COUNT：讀取集區要使用的讀取集區節點數量上限，例如 10。
  • MIN_NODE_COUNT：讀取集區要使用的讀取集區節點數量下限，例如 2。
  • TARGET_METRIC_1：您要使用的目標指標，例如：
    • AVERAGE_CPU_UTILIZATION
    • AVERAGE_DB_CONNECTIONS
    您必須定義至少一項可用指標。
  • VALUE_1：您要為先前指定的目標指標指派的值。在本範例中，請為 AVERAGE_CPU_UTILIZATION 目標指標指派 0.50 值。
  • NODE_COUNT：您要開始使用的讀取集區節點計數，例如 3。

HTTP 方法和網址：

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances

JSON 要求主體：

{
  "name":"READ_POOL_NAME",
  "region":"REGION",
  "masterInstanceName":"PRIMARY_INSTANCE_ID",
  "project":"PROJECT_ID",
  "databaseVersion":"DATABASE_VERSION",
  "settings":{
    "tier":"MACHINE_TIER",
    "edition":"ENTERPRISE_PLUS",
    "ipConfiguration":{
      "privateNetwork":"FULL_NETWORK_NAME",
      "ipv4Enabled": false
    },
    "readPoolAutoScaleConfig":{
      "enabled": true,
      "minNodeCount": MIN_NODE_COUNT,
      "maxNodeCount": MAX_NODE_COUNT,
      "targetMetrics": [
        {
          "metric":"TARGET_METRIC_1",
          "targetValue": VALUE_1
        }
      ]
    }
  },
  "instanceType":"READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/PRIMARTY_INSTANCE_ID",
  "status": "RUNNING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "2023-06-14T18:48:35.499Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "PRIMARTY_INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

在現有讀取集區上啟用讀取集區自動調度資源功能

如果您已建立讀取集區，可以指出要使用的自動調度設定，藉此啟用自動調度功能。

舉例來說，如果您為 AVERAGE_DB_CONNECTIONS 指定目標值 50，系統就會在讀取集區中新增或移除節點，讓集區的平均資料庫連線數量維持在 50 以下。

gcloud

如要為現有讀取集區啟用自動調度資源功能，請執行下列指令。

  gcloud sql instances patch INSTANCE
  --auto-scale-enabled
  --auto-scale-max-node-count=MAX_NODE_COUNT
  --auto-scale-min-node-count=MIN_NODE_COUNT
  --auto-scale-out-cooldown-seconds=COOLDOWN_SECONDS_SCALE_OUT
  --auto-scale-in-cooldown-seconds=COOLDOWN_SECONDS_SCALE_IN
  --auto-scale-target-metrics=TARGET_METRIC_1=VALUE_1

更改下列內容：

  • INSTANCE_NAME：與要修改的讀取集區相關聯的執行個體名稱。
  • MAX_NODE_COUNT：讀取集區要使用的讀取集區節點數量上限，例如 10。
  • MIN_NODE_COUNT：讀取集區要使用的讀取集區節點數量下限，例如 2。
  • COOLDOWN_SECONDS_SCALE_OUT：選用：讀取集區節點建立或刪除之間的冷卻或等待時間 (以秒為單位)，例如 180。等待期至少須為 60 秒。預設值為 600 秒。
  • COOLDOWN_SECONDS_SCALE_IN：選用：讀取集區節點建立或刪除之間的冷卻或等待時間 (以秒為單位)，例如 180。 等待期至少須為 60 秒。預設值為 600 秒。
  • TARGET_METRIC_1：您要使用的目標指標，例如：
    • AVERAGE_CPU_UTILIZATION
    • AVERAGE_DB_CONNECTIONS
    您必須定義至少一個可用指標。
  • VALUE_1：您要為先前指定的目標指標指派的值。在本範例中，請為 AVERAGE_DB_CONNECTIONS 目標指標指派 50 值。

REST v1

如要為現有讀取集區啟用自動調度資源功能，請使用 PATCH 方法。

使用任何要求資料之前，請先替換以下項目：

  • PROJECT_ID：包含執行個體的 Google Cloud 專案 ID 或專案編號。
  • INSTANCE_ID：與讀取集區相關聯的執行個體 ID。
  • MAX_NODE_COUNT：讀取集區要使用的讀取集區節點數量上限，例如 10。
  • MIN_NODE_COUNT：讀取集區要使用的讀取集區節點數量下限，例如 2。
  • COOLDOWN_SECONDS：選用：讀取集區節點建立或刪除作業之間的冷卻或等待時間 (以秒為單位)，例如 180。
  • SCALE_IN_DISABLED：選用：可停用讀取集區縮減行為。如要停用讀取集區縮減，請將值設為 true。
  • TARGET_METRIC_1：您要使用的目標指標，例如：
    • AVERAGE_CPU_UTILIZATION
    • AVERAGE_DB_CONNECTIONS
    您必須定義至少一項可用指標。
  • VALUE_1：您要為先前指定的目標指標指派的值。在本範例中，請為 AVERAGE_DB_CONNECTIONS 目標指標指派 50 值。

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 要求主體：

{
  "settings": {
    "readPoolAutoScaleConfig": {
      "enabled": true,
      "minNodeCount": MIN_NODE_COUNT,
      "maxNodeCount": MAX_NODE_COUNT,
      "scaleOutCooldownSeconds": COOLDOWN_SECONDS,
      "disableScaleIn": SCALE_IN_DISABLED,
      "targetMetrics": [
        {
          "metric": "TARGET_METRIC_1",
          "targetValue": VALUE_1
        }
      ]
    }
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "RUNNING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "2023-06-14T18:48:35.499Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

如要為現有讀取集區啟用自動調度資源功能，請使用 PATCH 方法。

使用任何要求資料之前，請先替換以下項目：

  • PROJECT_ID：包含執行個體的 Google Cloud 專案 ID 或專案編號。
  • INSTANCE_ID：與讀取集區相關聯的執行個體 ID。
  • MAX_NODE_COUNT：讀取集區要使用的讀取集區節點數量上限，例如 10。
  • MIN_NODE_COUNT：讀取集區要使用的讀取集區節點數量下限，例如 2。
  • COOLDOWN_SECONDS：選用：讀取集區節點建立或刪除作業之間的冷卻或等待時間 (以秒為單位)，例如 180。
  • SCALE_IN_DISABLED：選用：可停用讀取集區縮減行為。如要停用讀取集區縮減，請將值設為 true。
  • TARGET_METRIC_1：您要使用的目標指標，例如：
    • AVERAGE_CPU_UTILIZATION
    • AVERAGE_DB_CONNECTIONS
    您必須定義至少一項可用指標。
  • VALUE_1：您要為先前指定的目標指標指派的值。在本範例中，請為 AVERAGE_DB_CONNECTIONS 目標指標指派 50 值。

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 要求主體：

{
  "settings": {
    "readPoolAutoScaleConfig": {
      "enabled": true,
      "minNodeCount": MIN_NODE_COUNT,
      "maxNodeCount": MAX_NODE_COUNT,
      "scaleOutCooldownSeconds": COOLDOWN_SECONDS,
      "disableScaleIn": SCALE_IN_DISABLED,
      "targetMetrics": [
        {
          "metric": "TARGET_METRIC_1",
          "targetValue": VALUE_1
        }
      ]
    }
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "RUNNING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "2023-06-14T18:48:35.499Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

在讀取集區上停用讀取集區自動調度資源

如要停用讀取集區自動調度，請完成下列步驟。

gcloud

如要停用讀取集區自動調度資源功能，請執行下列指令。

  gcloud sql instances patch INSTANCE_NAME
  --no-auto-scale-enabled

更改下列內容：

  • INSTANCE_NAME：與要修改的讀取集區相關聯的執行個體名稱。

REST v1

如要停用讀取集區自動調度資源功能，請使用 PATCH 方法。

使用任何要求資料之前，請先替換以下項目：

  • PROJECT_ID：包含執行個體的 Google Cloud 專案 ID 或專案編號。
  • INSTANCE_ID：與讀取集區相關聯的執行個體 ID。

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 要求主體：

{
  "settings":{
    "readPoolAutoScaleConfig":{
      "enabled": false
    }
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "RUNNING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "2023-06-14T18:48:35.499Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

如要停用讀取集區自動調度資源功能，請使用 PATCH 方法。

使用任何要求資料之前，請先替換以下項目：

  • PROJECT_ID：包含執行個體的 Google Cloud 專案 ID 或專案編號。
  • INSTANCE_ID：與讀取集區相關聯的執行個體 ID。

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 要求主體：

{
  "settings":{
    "readPoolAutoScaleConfig":{
      "enabled": false
    }
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "RUNNING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "2023-06-14T18:48:35.499Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

查看指標

使用系統洞察查看讀取集區的相關指標。

如要瞭解 AVERAGE_CPU_UTILIZATION，請參閱 CPU 使用率 主要指標圖表。

如需 AVERAGE_DB_CONNECTIONS，請參閱每個資料庫的連線 主要指標圖表。

監控讀取集區自動調度資源作業

符合觸發讀取集區自動調度資源事件的條件時，系統會在執行個體上執行 UPDATE 作業。您可以在 Google Cloud 控制台查看這項作業。

讀取集區自動調度作業可能需要 10 分鐘以上，才能套用至執行個體。現有連線不會轉移至新加入的讀取集區節點，因此只有新連線會受到讀取集區自動調整大小的影響。

在讀取集區上執行自動調整規模作業時，您必須等待作業完成，才能在讀取集區或主要執行個體上執行其他更新。如果嘗試執行並行要求，可能會收到下列錯誤訊息：

  Operation failed because another operation was already in progress.

您可以檢查讀取集區執行個體，並查看節點數量變化：

  gcloud sql instances describe READ_POOL_NAME
  | grep nodeCount

更改下列內容：

  • READ_POOL_NAME：要取得資訊的讀取集區名稱。

系統事件稽核記錄

您也可以查看與方法 cloudsql.instances.readPoolAutoScale 相關聯的系統事件稽核記錄訊息，其中包含新舊節點計數。

後續步驟