Datenbank-Flags konfigurieren

Auf dieser Seite wird gezeigt, wie Sie Datenbank-Flags für Cloud SQL konfigurieren und welche Flags Sie für Ihre Instanz festlegen können. Sie können Datenbank-Flags für viele Vorgänge verwenden, z. B. für das Anpassen von MySQL-Parametern und Optionen sowie für das Konfigurieren und Optimieren einer Instanz.

In einigen Fällen muss vor dem Setzen eines Flags ein anderes Flag gesetzt werden, damit die Funktionalität in vollem Umfang genutzt werden kann. Beispiel: Wenn Sie das Logging langsamer Abfragen aktivieren möchten, müssen Sie sowohl das Flag slow_query_log auf on als auch das Flag log_output auf FILE setzen. Nur so sind die Logs im Log-Explorer der Google Cloud Console verfügbar.

Wenn Sie ein Flag für eine Datenbankinstanz festlegen, entfernen oder ändern, wird die Datenbank möglicherweise neu gestartet. Der Wert des Flags wird dann für die Instanz beibehalten, bis Sie es entfernen. Wenn die Instanz die Quelle für ein Replikat ist und neu gestartet wird, wird das Replikat ebenfalls neu gestartet, um es an die aktuelle Konfiguration der Instanz anzupassen.

Datenbankflags konfigurieren

Datenbank-Flag festlegen

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

Alle Flags auf Standardwerte zurücksetzen

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

Aktuelle Werte von Datenbank-Flags abrufen

 SHOW VARIABLES;

Sie können den Wert nur für unterstützte Flags ändern (wie unten aufgeführt).

Für eine Instanz festgelegte Datenbank-Flags ermitteln

So rufen Sie alle für eine Cloud SQL-Instanz festgelegten Flags auf:

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

Von Cloud SQL verwaltete Flags

Cloud SQL passt bestimmte System-Flags abhängig vom Maschinentyp der Instanz an.

innodb_buffer_pool_instances

• 1 für db-f1-micro und db-g1-small.
• 1 wenn RAM < 7,5 GB ist
• 2 wenn 7,5 GB <= RAM < 13 GB.
• 4 wenn 13 GB <= RAM < 26 GB.
• 8 wenn RAM >= 26 GB

Unterstützte Flags

Cloud SQL unterstützt die Flags, die in MySQL am häufigsten verwendet werden. Flags, die unten nicht erwähnt werden, werden nicht unterstützt.

Für bestimmte Flags unterstützt Cloud SQL eventuell einen anderen Wert oder Bereich als der entsprechende MySQL-Parameter oder die entsprechende MySQL-Option.

Die Flags gelten für alle Versionen von MySQL, die von Cloud SQL unterstützt werden, sofern nichts anderes angemerkt ist.

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

Weitere Informationen zu diesem Flag finden Sie im Abschnitt Tipps.

Zeitzonennamen

In diesem Abschnitt erfahren Sie mehr über die von Cloud SQL for MySQL unterstützten Zeitzonennamen.

Die Tabelle in diesem Abschnitt enthält Folgendes:

• Zeitzonenname: Der von Cloud SQL for MySQL unterstützte Name der Zeitzone.
• STD: Der Zeitzonenversatz in der Standardzeit (STD).
• DST: Die Zeitzonenverschiebung in der Sommerzeit.
• Synonymnamen: Die Namen für Zeitzonen, die Sie verwenden möchten. Diese werden von Cloud SQL for MySQL jedoch nicht unterstützt. In diesem Fall verwenden Sie den entsprechenden Zeitzonennamen.

Zeitzonentabellen in Cloud SQL müssen möglicherweise mit den neuesten Daten aktualisiert werden. Beispielsweise könnte ein Land von einer Sommerzeitverschiebung zu einer Winterzeitverschiebung wechseln oder ein Land könnte eine neue Zeitzone einführen.

Bei jedem Release eines kritischen Dienst-Agenten (Critical Service Agent, CSA) für Cloud SQL werden die Zeitzonentabellen mit den neuesten Daten aktualisiert. In diesem Fall werden die Replikinstanzen außerhalb des Wartungsfensters aktualisiert. Die primären Instanzen werden dann während des Wartungsfensters aktualisiert.

Sie können entweder warten, bis das reguläre Wartungsfenster für den CSA-Release installiert wurde, oder eine Selfservice-Wartung durchführen, um die Zeitzonentabellen mit den neuesten Daten zu aktualisieren. Weitere Informationen zum Aufrufen der verfügbaren Wartungsversionen finden Sie unter Zielwartungsversion ermitteln.

Tipps für die Arbeit mit Flags

general_log, slow_query_log

Wenn Sie die general- oder slow query-Logs anzeigen lassen möchten, aktivieren Sie das entsprechende Flag und setzen das Flag log_output auf FILE. Dadurch wird die Log-Ausgabe in der Log-Anzeige der Google Cloud Console verfügbar gemacht. Beachten Sie, dass Gebühren für das Google Cloud Observability-Logging anfallen. Um die Speicherkosten für Instanzen zu minimieren, werden die Logs general und slow query auf dem Instanzlaufwerk rotiert, wenn die Logdatei älter als 24 Stunden ist und in dieser Zeit keine Änderungen ausgeführt wurden oder wenn sie größer als 100 MB ist. Alte Logdateien werden nach der Rotation automatisch gelöscht.

Wenn für log_output der Wert NONE festgelegt ist, können Sie nicht auf die Logs zugreifen. Wenn Sie für log_output den Wert TABLE angeben, wird die Logausgabe in einer Tabelle in der MySQL-Systemdatenbank abgelegt. Möglicherweise wird eine Menge Speicherplatz belegt. Eine sehr große Tabelle kann sich auf die Zeitdauer auswirken, die für einen Neustart der Instanz benötigt wird, bzw. dazu führen, dass die Instanz nicht mehr vom SLA abgedeckt ist. Aus diesem Grund wird die Option TABLE nicht empfohlen. Darüber hinaus ist der Loginhalt nicht im Log-Explorer verfügbar und wird nicht rotiert. Bei Bedarf können Sie Ihre Logtabellen mithilfe der API kürzen. Weitere Informationen finden Sie auf der Referenzseite zu instances.truncateLog.

expire_logs_days, binlog_expire_logs_seconds

Wenn Sie die Wiederherstellung zu einer bestimmten Zeit aktivieren, wird die Ablaufzeit Ihrer binären Logs durch den kleineren Aufbewahrungszeitraum des Transaktionslogs und die Werte dieser Flags bestimmt. Mit diesen Flags können Sie verwalten, wie lange binäre Logs auf Ihren Replikaten gespeichert werden. Das Flag expire_logs_days wird ab MySQL 8.4 nicht mehr unterstützt. Weitere Informationen finden Sie auf der Seite Aufbewahrung von Transaktionslogs.

innodb_buffer_pool_size

Der Wert dieses Flags ist die Größe des Pufferpools in Byte. Die Größe des Pufferpools muss immer dem Wert entsprechen, der sich durch Multiplizieren von innodb_buffer_pool_chunk_size mit innodb_buffer_pool_instances ergibt, oder ein Vielfaches dieses Werts sein. Wenn Sie die Größe des Pufferpools auf einen Wert ändern, der nicht innodb_buffer_pool_chunk_size multipliziert mit innodb_buffer_pool_instances entspricht oder ein Vielfaches davon ist, passt Cloud SQL die Größe des Pufferpools automatisch an. Sie können dieses Flag nicht für Instanzen aktivieren,die weniger als 3.840 MiB RAM haben.

Das Flag kann aber nicht für Maschinentypen mit gemeinsam genutztem Kern (f1_micro und g1_small) konfiguriert werden. Das Ändern dieses Flags in MySQL 5.6 erfordert einen Neustart.

In Cloud SQL sind die standardmäßig zulässigen Mindest- und Höchstwerte für das Flag innodb_buffer_pool_size vom Arbeitsspeicher (RAM) der Instanz abhängig. Diese Werte können grob als Prozentsatz des RAM der Instanz berechnet werden. Standardmäßig wird der Wert dieses Flags in der Regel so nah wie möglich am maximal zulässigen Wert festgelegt. Der maximal für die Zuweisung zulässige Prozentsatz erhöht sich mit der Instanzgröße. Der kleinstmögliche Wert beträgt in der Regel etwa 20 % des Arbeitsspeichers der Instanz.

Ungefähre Werte für dieses Flag:

RAM-Bereich der Instanz	Min. %	Standardeinstellung %	Max. %
0 - 4.0 GB of 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 und höher	~20%	~72%	~72%

Die genauen Werte können variieren. Zum Berechnen des aktuellen Werts für die Instanz führen Sie die folgende Abfrage aus:

  show global variables like 'innodb_buffer_pool_size';
  

Als Referenz sind im Folgenden die minimal zulässigen, die Standard- und die maximal zulässigen Werte für die Maschinentypen angegeben.

Maschinentyp	Instanz-RAM (GB)	Minimum (GB) (% des Gesamtwerts)	Standard (GB) (% des Gesamtwerts)	Maximum (GB) (% des Gesamtwerts)
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

Der Standardwert für das Flag binlog_order_commits ist ON. Cloud SQL empfiehlt, den Standardwert dieses Flags nicht zu ändern. Wenn der Standardwert in OFF geändert wird, werden Transaktionen in derselben binären Loggruppe in einer anderen Reihenfolge als beim Schreiben im Binärlog übergeben. Dies wirkt sich auf die folgenden Vorgänge aus, in denen Transaktionen in der Reihenfolge des Binärelogs ausgeführt werden:

• Replikation: Kann zu Dateninkonsistenzen zwischen der Quelle und den Replikaten führen
• Wiederherstellung zu einem bestimmten Zeitpunkt: Kann zu Dateninkonsistenzen zwischen dem wiederhergestellten PITR-Zustand und dem früheren Zustand führen

optimizer_switch,optimizer_trace,optimizer_trace_features

Optimierungs-Flags enthalten kommagetrennte Werte. Sie können diese Flags über die Console oder gcloud festlegen. Weitere Informationen zum Festlegen dieses Flags über die Console finden Sie unter Datenbank-Flags konfigurieren. Wenn Sie gcloud verwenden, können Sie den Wert für diese Flags auf zwei verschiedene Arten angeben:

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

Wenn Sie mehrere Optimierer-Unterflags in einem Befehl festlegen möchten, verwenden Sie ein Komma als Trennzeichen zwischen den einzelnen Flag-Namen. Wenn Sie mit dem gcloud-Befehl einen einzelnen Unterflag-Wert festlegen, werden alle zuvor festgelegten untergeordneten Flags überschrieben. Wenn Sie beispielsweise den folgenden Befehl ausführen, wird der erwartete Wert für das Unter-Flag batched_key_access auf on gesetzt und alle anderen Unter-Flags für optimizer_flags werden auf ihre Standardwerte gesetzt.

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

Wenn Sie den folgenden Befehl ausführen, wird der Wert des Unter-Flags block_nested_loop auf ongesetzt. Alle anderen Unter-Flags für optimizer_switch werden überschrieben und auf ihre Standardwerte gesetzt.

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

Dazu gehört auch batched_key_access, das durch den vorherigen Befehl auf on festgelegt wurde. Wenn Sie alle zuvor festgelegten Unter-Flags beibehalten und neue hinzufügen möchten, müssen Sie beim Hinzufügen eines neuen Unterflags die Werte aller Unter-Flags angeben, die Sie festlegen möchten.

In Cloud SQL geänderte System-Flags

Alle anderen Datenbanksystem-Flags, die nicht im Abschnitt Unterstützte Flags aufgeführt sind, werden als verwaltete Flags bezeichnet. Für bestimmte verwaltete Flags setzt Cloud SQL das Flag auf einen anderen Wert als die Standardeinstellung. Dies sorgt dafür, dass Cloud SQL-Instanzen zuverlässig ausgeführt werden. Die Werte dieser System-Flags können nicht geändert werden.

Verwaltete Flags, die keine Standardeinstellung haben, sind unten aufgeführt.

System-Flag „partial_revokes“ ab MySQL 8.0

Mit dem Flag partial_revokes können Sie den Nutzerzugriff auf ein Datenbankschema einschränken. In Cloud SQL for MySQL ab Version 8.0 ist das partial_revokes-Flag auf ON gesetzt. Dadurch wird die Verwendung von Platzhalterzeichen beim Gewähren oder Entziehen von Nutzerberechtigungen für Datenbankschemata in MySQL 8.0 eingeschränkt. Aktualisieren Sie die GRANT-Anweisung, sodass anstelle von Platzhaltern der vollständige Name des Datenbankschemas verwendet wird.

Wenn Sie beispielsweise den folgenden Befehl mit dem Platzhalterzeichen %\ verwenden, um einem Nutzer in MySQL 5.7 Berechtigungen zu gewähren, erhält der Nutzer Berechtigungen für alle Datenbanken, die auf _foobar enden.

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

In MySQL 8.0 erhalten Nutzer jedoch nur Zugriff auf die Datenbank, die genau mit %\_foobar übereinstimmt.

Ab MySQL 8.0 gibt es zwei Möglichkeiten, Zugriff auf mehrere Datenbanken zu gewähren.

1. Sie können Berechtigungen für bestimmte Datenbanken gewähren, indem Sie die vollständigen Datenbanknamen verwenden, wie im folgenden Befehl gezeigt:

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

2. Mit partial_revokes können Sie mit den Befehlen grant und revoke Nutzerberechtigungen für alle Datenbankschemata gewähren und gleichzeitig den Zugriff auf einige Datenbankschemata einschränken.

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

   Dadurch wird Zugriff auf alle Datenbankschemata gewährt und der Zugriff auf test3_foobar.* eingeschränkt.

Replikationsfilter

Replikationsfilter können nur für Cloud SQL-Replikate festgelegt werden. Jeder Replikationsfilter wird als einzelnes Flag für mehrere Datenbanken festgelegt, wobei die einzelnen Datenbanknamen durch ein Komma getrennt sind. Sie können einen Replikationsfilter für ein Cloud SQL-Replikat mit der Console oder dem folgenden Befehl einrichten.

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

Replikationsfilter unterstützen Datenbanknamen, die Kommaswerte enthalten, nicht. Der ^~^-Wert im vorherigen Befehl ist für Datenbank-Flags erforderlich, die durch Kommas getrennte Werte sind.

Beachten Sie Folgendes, wenn Sie ein Replikatierungsfilter-Flag festlegen:

• Wird das Replikat fehlerhaft, können die von den Replikationsfiltern gefilterten Daten auf dem Replikat angezeigt werden, da Cloud SQL Quelldaten der primären Instanz verwendet, um das Instanzreplikat neu zu erstellen.
• Sie können für das mysql-Schema keine Replikationsfilter festlegen.
• Replikationsfilterregeln gelten nicht für serverlose Exporte.

Flags für den Indexberater

Im Folgenden finden Sie eine Liste der Datenbank-Flags, mit denen in Cloud SQL for MySQL Funktionen speziell für den Indexberater aktiviert und verwaltet werden.

Flags mit Alias

Die folgende Liste enthält die Flag-Namen, die in Cloud SQL for MySQL-Versionen 8.0.26 und neuer geändert wurden.

Wenn Ihre Cloud SQL-Instanz einen verworfenen Flag-Namen verwendet, bearbeiten Sie Ihre Cloud SQL-Instanz, löschen den verworfenen Flag-Namen und fügen das neue Flag Ihrer Instanz hinzu. Weitere Informationen finden Sie unter Datenbank-Flag einrichten.

Fehlerbehebung

Nächste Schritte

• Informationen zu den MySQL-Systemvariablen.
• Weitere Informationen zu Betriebsrichtlinien.