データベース フラグを構成する

このページでは、Cloud SQL のデータベース フラグを構成する方法について説明し、インスタンスに設定できるフラグの一覧を示します。データベース フラグは、MySQL パラメータの調整、オプションの調整、インスタンスの構成や調整など、多くの操作で使用します。

場合によっては、目的の機能を完全に有効にするために、1 つのフラグの設定だけでなく、別のフラグの設定も必要になることがあります。たとえば、遅いクエリのログを有効にするためには、slow_query_log フラグを on に設定するだけでなく、Google Cloud Console Logs Explorer でログを利用できるように log_output フラグを FILE に設定する必要もあります。

データベース インスタンスのフラグを設定、削除、変更すると、データベースが再起動される場合があります。その場合、フラグの値はフラグを削除するまでインスタンスに対して保持されます。インスタンスがレプリカのソースで、インスタンスが再起動されると、レプリカはインスタンスの現在の構成に合わせて再起動します。

データベース フラグを構成する

データベース フラグを設定する

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": "user@example.com",
  "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": "user@example.com",
  "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": "user@example.com",
  "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": "user@example.com",
  "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": "user@example.com",
  "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": "user@example.com",
  "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

• db-f1-micro と db-g1-small の場合は 1。
• RAM が 7.5 GB 未満の場合は 1。
• RAM が 7.5 GB 以上 13 GB 未満の場合は 2。
• RAM が 13 GB 以上 26 GB 未満の場合は 4。
• RAM が 26 GB 以上の場合は 8。

サポートされているフラグ

Cloud SQL でサポートされている MySQL フラグは、最もよくリクエストされる MySQL フラグです。以下に記載のないフラグはサポートされていません。

各フラグについては、Cloud SQL でサポートされる値や範囲が、対応する MySQL のパラメータやオプションと異なる場合があります。

注記がある場合を除き、いずれのフラグも Google 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 のタイムゾーン テーブルを最新のデータで更新することが必要となる場合があります。たとえば、特定の国で DST タイムゾーン オフセットから STD オフセットに移行する場合や、新しいタイムゾーンを導入する場合などです。

Cloud SQL の重要なサービス エージェント（CSA）のリリースごとに、タイムゾーン テーブルが最新のデータで更新されます。この場合、メンテナンス以外の時間枠でレプリカ インスタンスが更新されます。その後、プライマリ インスタンスが、メンテナンスの時間枠で更新されます。

CSA リリースの定期メンテナンスの時間枠まで待つか、セルフサービス メンテナンスを実行してタイムゾーン テーブルを最新のデータで更新します。使用可能なメンテナンス バージョンの表示の詳細については、ターゲット メンテナンス バージョンを決定するをご覧ください。

フラグの使用に関するヒント

general_log、slow_query_log

general または slow query ログを使用可能にするには、対応するフラグを有効にして、log_output フラグを FILE に設定します。これにより、Google Cloud コンソールのログビューアでログ出力を閲覧できるようになります。Google Cloud Observability のロギング料金が適用されます。インスタンスのストレージ費用を最小限に抑えるために、インスタンス ディスク上の general ログと slow query ログは、ログファイルが 24 時間経過した（かつその時間内に変更がない）場合や、100 MB を超えた場合にはローテーションされます。古いログファイルは、ローテーション後に自動的に削除されます。

log_output が NONE に設定されている場合、ログにアクセスできません。log_output を TABLE に設定すると、ログ出力は mysql システム データベースのテーブルに格納されます。ディスク容量を大量に消費する可能性があります。このテーブルが大きくなると、インスタンスの再起動時間に影響を与える可能性があります。また、インスタンスが SLA の対象外になる可能性もあります。このため、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 はバッファプール サイズを自動的に調整します。このフラグは、3,840 MiB 未満の RAM のインスタンスでは有効にできません。

共有コア マシンタイプ（f1_micro と g1_small）ではこのフラグを構成できません。MySQL 5.6 でこのフラグを変更するには、再起動が必要です。

Cloud SQL では、innodb_buffer_pool_size フラグのデフォルト値、最小許容値、最大許容値は、インスタンスのメモリによって異なります。これらの値は、インスタンスの RAM のパーセンテージとしておおよそで計算されます。デフォルトでは、このフラグの値は、一般的には最大許容値の近くに設定されます。最大許容割り当て率は、インスタンスのサイズとともに増加します。最小許容値は、通常はインスタンスの RAM の約 20% です。

このフラグのおおよその値:

インスタンスの RAM 範囲	最小 %	デフォルト %	最大 %
0～4.0 GB の RAM		～34%
4.0 GB～7.5 GB	～20%	～34%	～34%
7.5 GB～12 GB	～20%	～52%	～52%
12 GB～24 GB	～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%）

SET GLOBAL FLAG_NAME=FLAG_VALUE

binlog_order_commits

binlog_order_commits フラグのデフォルト値は ON です。このフラグのデフォルト値を変更しないことをおすすめします。デフォルト値を OFF に変更した場合、同じバイナリロググループ内のトランザクションは、バイナリログに書き込まれたときとは異なる順序で commit されます。これは、バイナリログの順序でトランザクションを実行する次のオペレーションに影響します。

• レプリケーション: ソースとレプリカの間でデータの不整合が発生する可能性があります
• ポイントインタイム リカバリ: PITR の復元状態と履歴状態の間でデータの不整合が発生する可能性があります

optimizer_switch,optimizer_trace,optimizer_trace_features

オプティマイザー フラグにはカンマ区切り値があります。これらのフラグは、コンソールまたは gcloud を使用して設定できます。コンソールを使用してこのフラグを設定する方法については、データベース フラグを構成するをご覧ください。 gcloud を使用している場合は、次の 2 つの方法でこれらのフラグの値を指定できます。

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

1 つのコマンドで複数のオプティマイザーのサブフラグを設定するには、カンマで区切りを使用して各フラグ名を区切ります。gcloud コマンドを使用して 1 つのサブフラグ値を設定すると、以前に設定されたすべてのサブフラグが上書きされます。 たとえば、次のコマンドを実行すると、batched_key_access サブフラグの想定値が on に設定され、オプティマイザーのフラグのその他のサブフラグはすべてデフォルト値に設定されます。

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

これには、前のコマンドで on に設定された batched_key_access が含まれます。以前に設定したすべてのサブフラグを維持して新しいサブフラグを追加するには、新しいサブフラグを追加するときに、設定するすべてのサブフラグの値を追加する必要があります。

Cloud SQL で変更されたシステムフラグ

サポートされているフラグのリストにない他のデータベース システム フラグはマネージド フラグと呼ばれます。特定のマネージド フラグの場合、Cloud SQL はフラグにデフォルト以外の値に設定して、Cloud SQL インスタンスが確実に実行されるようにします。これらのシステムフラグの値は変更できません。

デフォルト以外の値を使用するマネージド フラグを以下に示します。

MySQL 8.0 以降の partial_revokes システムフラグ

partial_revokes フラグを使用すると、データベース スキーマに対するユーザー アクセスを制限できます。Cloud SQL for MySQL バージョン 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 以降では、複数のデータベースへのアクセス権を付与する方法が 2 つあります。

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 レプリカに対してのみ設定できます。各レプリケーション フィルタは、複数のデータベースに対する 1 つのフラグとして設定されます。各データベース名はカンマで区切って指定します。コンソールまたは次のコマンドを使用して、Cloud SQL レプリカにレプリケーション フィルタを設定できます。

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

レプリケーション フィルタは、カンマ値を含むデータベース名をサポートしていません。前述のコマンドの ^~^ 値は、カンマ区切り値であるデータベース フラグに必要です。

レプリケーション フィルタフラグを設定する場合は、次の点に注意してください。

• レプリカが異常な状態になると、Cloud SQL がプライマリのソースデータを使用してインスタンス レプリカを再構築するため、レプリケーション フィルタでフィルタリングされたデータがレプリカに表示されることがあります。
• mysql スキーマにはレプリケーション フィルタを設定できません。
• レプリケーション フィルタルールは、サーバーレス エクスポートには適用されません。

インデックス アドバイザーのフラグ

次に、Cloud SQL for MySQL がインデックス アドバイザー固有の機能を有効にして管理するために使用するデータベース フラグのリストを示します。

新しい名前が設定されたフラグ

Cloud SQL for MySQL バージョン 8.0.26 以降で変更されたフラグ名を以下に示します。

Cloud SQL インスタンスで非推奨フラグ名を使用している場合は、Cloud SQL インスタンスを編集して、非推奨フラグ名を削除し、新しいフラグをインスタンスに追加します。詳細については、データベース フラグを設定するをご覧ください。

トラブルシューティング

次のステップ

• MySQL のシステム変数の詳細。
• オペレーション ガイドラインの詳細。