設定資料庫旗標

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

本頁面說明如何設定 Cloud SQL 的資料庫旗標，並列出可為執行個體設定的旗標。您可以使用資料庫標記執行許多作業，包括調整 MySQL 參數、調整選項，以及設定及調整執行個體。

在部分情況下，設定某一標記可能會需要您設定另一個標記，才能完整啟用想要的功能。舉例來說，如要啟用慢速查詢記錄，您必須將 slow_query_log 標記設為 on，並將 log_output 標記設為 FILE，才能透過 Google Cloud 控制台的記錄檔探索工具使用記錄。

設定、移除或修改資料庫執行個體的標記時，資料庫可能會重新啟動。移除之前，系統都會保留執行個體的旗標值。如果執行個體是備用資源的來源，且重新啟動執行個體，備用資源也會重新啟動，以便與執行個體的目前設定保持一致。

設定資料庫旗標

設定資料庫旗標

gcloud sql instances patch INSTANCE_NAME --database-flags=FLAG1=VALUE1,FLAG2=VALUE2

gcloud sql instances patch INSTANCE_NAME \
  --database-flags=general_log=on,skip_show_database=on,wait_timeout=200000

resource "google_sql_database_instance" "instance" {
  database_version = "MYSQL_8_0"
  name             = "mysql-instance"
  region           = "us-central1"
  settings {
    database_flags {
      name  = "general_log"
      value = "on"
    }
    database_flags {
      name  = "skip_show_database"
      value = "on"
    }
    database_flags {
      name  = "wait_timeout"
      value = "200000"
    }
    disk_type = "PD_SSD"
    tier      = "db-n1-standard-2"
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

{
  "settings":
  {
    "databaseFlags":
    [
      {
        "name": "flag_name",
        "value": "flag_value"
      }
    ]
  }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

{
  "settings":
  {
    "databaseFlags":
    [
      {
        "name": "general_log",
        "value": "on"
      }
    ]
  }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

{
  "settings":
  {
    "databaseFlags":
    [
      {
        "name": "flag_name",
        "value": "flag_value"
      }
    ]
  }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

{
  "settings":
  {
    "databaseFlags":
    [
      {
        "name": "general_log",
        "value": "on"
      }
    ]
  }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "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 sql instances patch INSTANCE_NAME \
--clear-database-flags

PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

{
  "settings":
  {
    "databaseFlags": []
  }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

{
  "settings":
  {
    "databaseFlags": []
  }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

查看資料庫標記的現行值

 SHOW VARIABLES;

請注意，您只能變更支援標記的值 (如下所示)。

判斷已為執行個體設定哪些資料庫標記

如要查看 Cloud SQL 執行個體設定了哪些旗標，請按照下列步驟操作：

gcloud sql instances describe INSTANCE_NAME

GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id" | Select-Object -Expand Content

{
  "settings":
  {
    "authorizedGaeApplications": [],
    "tier": "machine-type",
    "kind": "sql#settings",
    "availabilityType": "REGIONAL",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration":
    {
      "privateNetwork": "projects/project-id/global/networks/default",
      "authorizedNetworks": [],
      "ipv4Enabled": false
    },
    "locationPreference":
    {
      "zone": "zone",
      "kind": "sql#locationPreference"
    },
    "databaseFlags": [
      {
        "name": "general_log",
        "value": "on"
      }
    ],
    "dataDiskType": "PD_SSD",
    "maintenanceWindow":
    {
      "kind": "sql#maintenanceWindow",
      "hour": 0,
      "day": 0
    },
    "backupConfiguration":
    {
      "startTime": "03:00",
      "kind": "sql#backupConfiguration",
      "enabled": true,
      "binaryLogEnabled": true
    },
    "settingsVersion": "54",
    "storageAutoResizeLimit": "0",
    "storageAutoResize": true,
    "dataDiskSizeGb": "10"
  }
}

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

{
  "settings":
  {
    "authorizedGaeApplications": [],
    "tier": "machine-type",
    "kind": "sql#settings",
    "availabilityType": "REGIONAL",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration":
    {
      "privateNetwork": "projects/project-id/global/networks/default",
      "authorizedNetworks": [],
      "ipv4Enabled": false
    },
    "locationPreference":
    {
      "zone": "zone",
      "kind": "sql#locationPreference"
    },
    "databaseFlags": [
      {
        "name": "general_log",
        "value": "on"
      }
    ],
    "dataDiskType": "PD_SSD",
    "maintenanceWindow":
    {
      "kind": "sql#maintenanceWindow",
      "hour": 0,
      "day": 0
    },
    "backupConfiguration":
    {
      "startTime": "03:00",
      "kind": "sql#backupConfiguration",
      "enabled": true,
      "binaryLogEnabled": true
    },
    "settingsVersion": "54",
    "storageAutoResizeLimit": "0",
    "storageAutoResize": true,
    "dataDiskSizeGb": "10"
  }
}

由 Cloud SQL 管理的標記

Cloud SQL 會根據執行個體機器類型調整特定系統旗標。

innodb_buffer_pool_instances

• 1 個 db-f1-micro 和 db-g1-small。
• 如果 RAM 小於 7.5 GB，則為 1。
• 2：如果 RAM 介於 7.5 GB 和 13 GB 之間，
• 4，如果 RAM 介於 13 GB 到 26 GB 之間。
• 如果 RAM 大於或等於 26 GB，則為 8。

支援的標記

Cloud SQL 中支援的標記是最常要求的 MySQL 標記。不支援下方未提及的標記。

對於特定標記，Cloud SQL 的支援值或範圍可能會與對應的 MySQL 參數或選項不同。

除非另外註明，否則標記適用於 Cloud SQL 支援的所有 MySQL 版本。

A | B | C | D | E | F | G | H | I | L | M | N | O | P | Q | R | S | T | U | W

如要進一步瞭解此標記，請參閱「提示」一節。

時區名稱

在本節中，您將瞭解 Cloud SQL for MySQL 支援的時區名稱。

本節的資料表會顯示以下內容：

• 時區名稱：Cloud SQL for MySQL 支援的名稱。
• STD：標準時間 (STD) 中的時區偏移。
• DST：日光節約時間 (DST) 中的時區偏移。
• 同義字名稱：您可能想使用的時區名稱，但 Cloud SQL for MySQL 不支援這些時區。如果發生這種情況，請使用對應的時區名稱。

Cloud SQL 中的時區表可能需要重新整理，以便取得最新資料。舉例來說，某個國家/地區可能會從夏令時間時區偏移改為標準時間偏移，或是引進新的時區。

每當 Cloud SQL 推出重大服務代理程式 (CSA) 版本，時區表都會更新最新資料。發生這種情況時，系統會在非維護期間重新整理備用資源執行個體。主要執行個體會在維護期間重新整理。

您可以等到 CSA 版本的定期維護時段，也可以執行自助維護，以最新資料更新時區表。如要進一步瞭解如何查看可用的維護版本，請參閱「決定目標維護版本」。

使用標記的提示

general_log、slow_query_log

如要能夠使用 general 或 slow query 記錄，請啟用對應標記並將 log_output 標記設為 FILE。這會讓使用者能夠透過 主控台中的記錄檢視器使用記錄輸出。 Google Cloud 請注意，這會產生 Google Cloud Observability 記錄費用。為盡量降低執行個體儲存空間成本，當記錄檔超過 24 小時 (且在該期間內未進行任何變更) 或大小超過 100 MB 時，系統會輪替執行個體磁碟上的 general 和 slow query 記錄。舊的記錄檔會在輪替後自動刪除。

如果 log_output 設為 NONE，您就無法存取記錄檔。如果您將 log_output 設為 TABLE，系統會將記錄輸出內容放入 MySQL 系統資料庫中的資料表。可能會占用大量磁碟空間。如果資料表變得很大，可能會影響執行個體重新啟動的時間，或導致執行個體喪失其服務水準協議的保障。因此，我們不建議使用 TABLE 選項。此外，記錄檔探索工具無法提供記錄檔內容，且不會輪替顯示。如有需要，您可以使用 API 截斷記錄資料表。詳情請參閱 instances.truncateLog 參考資料頁面。

expire_logs_days、binlog_expire_logs_seconds

如果您啟用即時復原功能，二進位記錄的到期期限會根據交易記錄保留期限和這些標記的值，取較短者。您可以使用這些標記來管理二進位記錄在副本上儲存的時間長度。expire_logs_days 標記已從 MySQL 8.4 以上版本中移除。詳情請參閱「 交易記錄保留」頁面。

innodb_buffer_pool_size

這個標記的值是緩衝區的大小 (以位元組為單位)。緩衝區大小必須一律等於或為 innodb_buffer_pool_chunk_size 乘以 innodb_buffer_pool_instances 後所得值的倍數。如果您將緩衝區集區大小變更為不等於 innodb_buffer_pool_chunk_size 乘以 innodb_buffer_pool_instances 的值或倍數，Cloud SQL 會自動調整緩衝區集區大小。在 RAM 小於 3,840 MiB 的執行個體上，您無法啟用這個標記。

您無法為共用核心機器類型 (f1_micro 和 g1_small) 設定這個標記。如要在 MySQL 5.6 上變更這個旗標，必須重新啟動。

在 Cloud SQL 中，innodb_buffer_pool_size 旗標的預設值、允許的下限值與允許的上限值皆取決於執行個體的記憶體。這些值可大致計算為執行個體的 RAM 百分比。根據預設，這個標記的值通常會設為接近允許的最大值。允許的最大分配百分比會隨著執行個體大小而增加。允許的最低值通常是執行個體 RAM 的 20%。

此旗標的近似值：

執行個體 RAM 範圍	百分比下限	預設 %	百分比上限
0 - 4.0 GB RAM		約 34%
4.0GB - 7.5GB	約 20%	約 34%	約 34%
7.5GB - 12GB	約 20%	約 52%	約 52%
12GB - 24GB	約 20%	約 67%	約 67%
24 GB 以上	約 20%	~72%	~72%

實際值可能會有所不同。如要計算執行個體的目前值，您可以執行以下查詢：

  show global variables like 'innodb_buffer_pool_size';
  

以下為機器類型的允許最小值、預設值和最大值，供您參考。

機器類型	執行個體 RAM (GB)	最少 (GB) (占總量的 %)	預設 (GB) (總量的百分比)	上限 (GB) (占總量的 %)
db-f1-micro	0.6	-	0.053	-
db-g1-small	1.7	-	0.625	-
db-custom-1-3840	3.75	0.875 (23%)	1.375 (37%)	1.375 (37%)
db-custom-2-7680	7.5	1.5 (20%)	4 (53%)	4 (53%)
db-custom-4-15360	15	3 (20%)	10.5 (70%)	10.5 (70%)
db-custom-8-30720	30	6 (20%)	22 (73%)	22 (73%)
db-custom-16-61440	60	12 (20%)	44 (73%)	44 (73%)
db-custom-32-122880	120	24 (20%)	87 (73%)	87 (73%)
db-custom-64-245760	240	48 (20%)	173 (72%)	173 (72%)
db-custom-96-368640	360	72 (20%)	260 (72%)	260 (72%)
db-custom-2-13312	13	3 (23%)	9 (69%)	9 (69%)
db-custom-4-26624	26	6 (23%)	19 (73%)	19 (73%)
db-custom-8-53248	52	11 (21%)	38 (73%)	38 (73%)
db-custom-16-106496	104	21 (20%)	75 (72%)	75 (72%)
db-custom-32-212992	208	42 (20%)	150 (72%)	150 (72%)
db-custom-64-425984	416	84 (20%)	300 (72%)	300 (72%)
db-custom-96-638976	624	125 (20%)	450 (72%)	450 (72%)

gcloud sql instances patch INSTANCE_NAME \
 --database-flags="innodb_cloudsql_optimized_write=OFF"

SET GLOBAL FLAG_NAME=FLAG_VALUE

binlog_order_commits

binlog_order_commits 標記的預設值為 ON。Cloud SQL 建議您不要變更這個旗標的預設值。如果預設值變更為 OFF，同一個二進位記錄檔群組中的交易會以與在二進位記錄檔中寫入時不同的順序提交。這會影響以下以二進位記錄順序執行交易的作業：

• 複製：可能會導致來源和備份之間的資料不一致
• Point-in-time-recovery：可能導致 PITR 還原狀態與歷史狀態之間的資料不一致

optimizer_switch,optimizer_trace,optimizer_trace_features

最佳化器旗標含有以半形逗號分隔的值。您可以使用控制台或 gcloud 設定這些標記。如要進一步瞭解如何使用控制台設定此旗標，請參閱「設定資料庫旗標」。如果使用 gcloud，您可以透過兩種方式指定這些標記的值：

• gcloud topic flags-file
• gcloud topic escaping-file

如要在單一指令中設定多個最佳化器子旗標，請使用半形逗號分隔每個旗標名稱。如果您使用 gcloud 指令設定單一子旗標值，系統會覆寫先前設定的所有子旗標。舉例來說，如果您執行下列指令，batched_key_access 子旗標的預期值會設為 on，optimizer_flags 的所有其他子旗標則會設為預設值。

gcloud sql instances patch my-instance --database-flags=^~^optimizer_switch=batched_key_access=on

如果您執行下列指令，block_nested_loop 子旗標的值會設為 on，optimizer_switch 的所有其他子旗標則會遭到覆寫並設為預設值。

gcloud sql instances patch my-instance --database-flags=^~^optimizer_switch=block_nested_loop=on

這包括 batched_key_access，這是先前指令將其設為 on 的項目。如要保留先前設定的所有子旗標並新增子旗標，您必須在新增子旗標時，加入所有要設定的子旗標值。

Cloud SQL 中的系統旗標已變更

所有未列在「支援的標記」一節中的資料庫系統標記，都稱為「受管理的標記」。針對特定的受管理旗標，Cloud SQL 會將旗標設為預設設定以外的值，確保 Cloud SQL 執行個體可靠執行。您無法變更這些系統標記的值。

下方列出非預設設定的受管理標記。

MySQL 8.0 以上版本中的 partial_revokes 系統標記

partial_revokes 旗標可讓您限制資料庫結構定義的使用者存取權。在 MySQL 適用的 Cloud SQL 8.0 以上版本中，partial_revokes 標記會設為 ON。這樣一來，在 MySQL 8.0 中授予或撤銷資料庫結構定義的使用者權限時，就無法使用萬用字元。請更新 GRANT 陳述式，使用資料庫結構定義的完整名稱，而非萬用字元。

舉例來說，如果您使用下列指令搭配 %\ 萬用字元，在 MySQL 5.7 中授予使用者權限，則會為使用者授予所有結尾為 _foobar 的資料庫權限。

GRANT ALL PRIVILEGES ON `%\_foobar`.*  TO  'testuser'@'%';

不過，在 MySQL 8.0 中，使用者只能存取與 %\_foobar 完全相符的資料庫。

在 MySQL 8.0 以上版本中，您可以透過兩種方式授予多個資料庫的存取權。

1. 您可以使用完整資料庫名稱授予特定資料庫權限，如以下指令所示：

     grant select on test1_foobar.* to 'testuser'@'%';
     grant select on test2_foobar.* to 'testuser'@'%';
     grant select on test3_foobar.* to 'testuser'@'%';
   

2. 使用 partial_revokes 時，您可以使用 grant 和 revoke 指令，為所有資料庫結構定義授予使用者權限，同時限制對部分資料庫結構定義的存取權。

     grant select on *.* to 'testuser'@'%';
     revoke select on test3_foobar.* from 'testuser'@'%';
   

   這麼做可授予所有資料庫結構定義的存取權，同時限制對 test3_foobar.* 的存取權。

複製篩選器

複製篩選器只能套用至 Cloud SQL 備用資源。每個複製篩選器都會設為多個資料庫的單一標記，其中每個資料庫名稱以半形逗號分隔。您可以使用控制台或下列指令，在 Cloud SQL 複本上設定複製篩選器：

gcloud sql instances patch REPLICA_NAME --database-flags=^~^REPLICATION_FILTER_NAME=DATABASE_NAME1,DATABASE_NAME, etc

複製篩選器不支援含有逗號值的資料庫名稱。對於以逗號分隔的資料庫旗標，上述指令中的 ^~^ 值是必要的。

設定複製篩選器旗標時，請注意下列事項：

• 如果備用資源失效，Cloud SQL 會使用主要執行個體的來源資料重建執行個體備用資源，因此備用資源上可能會出現經過複製篩選器篩選的資料。
• 您無法在 mysql 結構定義上設定複製作業篩選器。
• 複製篩選器規則不適用於無伺服器匯出作業。

索引建議工具旗標

以下是 MySQL 適用的 Cloud SQL 用於啟用及管理索引顧問專屬功能的資料庫旗標清單。

別名旗標

下列清單包含 Cloud SQL for MySQL 8.0.26 以上版本變更的標記名稱。

如果 Cloud SQL 執行個體使用已淘汰的旗標名稱，請編輯 Cloud SQL 執行個體、刪除已淘汰的旗標名稱，然後將新旗標新增至執行個體。詳情請參閱「設定資料庫標記」。

疑難排解

後續步驟

• 進一步瞭解 MySQL 系統變數。
• 進一步瞭解操作指南。