Configurer des options de base de données

Cette page explique comment configurer des indicateurs de base de données pour Cloud SQL et répertorie les indicateurs que vous pouvez définir pour votre instance. Les indicateurs de base de données sont utilisés pour de nombreuses opérations, y compris l'ajustement des paramètres et des options MySQL, ainsi que la configuration et le réglage d'une instance.

Parfois, définir un indicateur implique d'en définir un autre, afin d'activer complètement la fonctionnalité souhaitée. Par exemple, pour activer la journalisation lente des requêtes, vous devez définir à la fois l'indicateur slow_query_log sur on et l'indicateur log_output sur FILE. Grâce à ces deux indicateurs, vos journaux seront disponibles à partir de l'explorateur de journaux de la console Google Cloud.

Lorsque vous définissez, supprimez ou modifiez un indicateur pour une instance de base de données, il peut être nécessaire de la redémarrer. La nouvelle valeur de l'indicateur est ensuite conservée pour l'instance, jusqu'à ce que vous la supprimiez. Si l'instance est la source d'une instance dupliquée et est redémarrée, elle est également redémarrée pour s'aligner sur la configuration actuelle de l'instance.

Configurer des options de base de données

Définir une option de base de données

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

Réinitialiser les valeurs par défaut des options

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

Afficher les valeurs actuelles des options de base de données

 SHOW VARIABLES;

Notez que vous ne pouvez modifier la valeur que des indicateurs compatibles (répertoriés ci-dessous).

Déterminer les options de base de données définies pour une instance

Pour savoir quelles options ont été définies pour une instance 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"
  }
}

Options gérées par Cloud SQL

Cloud SQL ajuste certaines options système en fonction du type de machine de l'instance.

innodb_buffer_pool_instances

• 1 pour db-f1-micro et db-g1-small.
• 1 si la mémoire RAM est inférieure à 7,5 Go.
• 2 si la mémoire RAM est comprise entre 7,5 Go et 13 Go
• 4 si la mémoire RAM est comprise entre 13 Go et 26 Go.
• 8 si la mémoire RAM est supérieure à 26 Go.

Indicateurs compatibles

Les indicateurs compatibles avec Cloud SQL correspondent aux indicateurs MySQL les plus courants. Les indicateurs qui n'apparaissent pas ci-dessous ne sont pas compatibles.

Pour un indicateur donné, Cloud SQL peut être compatible avec une valeur ou une plage différentes de celles du paramètre ou de l'option MySQL correspondants.

Les indicateurs s'appliquent à toutes les versions de MySQL prises en charge par Cloud SQL, sauf indication contraire.

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

Pour en savoir plus sur cette option, consultez la section Conseils.

Noms de fuseaux horaires

Dans cette section, vous allez découvrir les noms de fuseaux horaires compatibles avec Cloud SQL pour MySQL.

Le tableau de cette section affiche les éléments suivants :

• Nom de fuseau horaire : nom accepté par Cloud SQL pour MySQL.
• STD (Standard Time) : décalage de fuseau horaire à l'heure standard.
• DST (Daylight Savings Time) : décalage de fuseau horaire à l'heure d'été.
• Noms synonymes : noms des fuseaux horaires que vous souhaitez utiliser, mais qui ne sont pas pris en charge par Cloud SQL pour MySQL. Dans ce cas, utilisez le nom du fuseau horaire correspondant.

Il se peut que les tables de fuseau horaire de Cloud SQL aient besoin d'être actualisées avec les dernières données. Par exemple, un pays peut passer d'un fuseau horaire DST à un décalage DST ou un pays peut introduire un nouveau fuseau horaire.

Pour chaque version d'agent de service critique (CSA) de Cloud SQL, les tables de fuseau horaire sont actualisées avec les dernières données. Dans ce cas, les instances répliquées sont actualisées pendant l'intervalle hors maintenance. Les instances principales sont ensuite actualisées pendant l'intervalle de maintenance.

Vous pouvez attendre l'intervalle de maintenance standard de la version de l'agent de service critique ou procéder à une maintenance en libre-service pour actualiser les tables de fuseau horaire avec les dernières données. Pour en savoir plus sur l'affichage des versions de maintenance disponibles, consultez Déterminer la version de maintenance cible.

Conseils pour l'utilisation d'indicateurs

general_log, slow_query_log

Pour que vos journaux general ou slow query soient disponibles, activez l'option correspondante et définissez l'option log_output sur FILE. De cette façon, la sortie du journal sera disponible dans la visionneuse de journaux de la console Google Cloud. Notez que les frais de journalisation de Google Cloud Observability s'appliquent. Afin de réduire les coûts de stockage des instances, les journaux general et slow query stockés sur le disque de l'instance font l'objet d'une rotation lorsque l'âge du fichier journal dépasse 24 heures (et qu'aucune modification n'a été effectuée pendant cette période) ou sa taille est supérieure à 100 Mo. Les anciens fichiers journaux sont automatiquement supprimés après la rotation.

Si log_output est défini sur NONE, vous ne pouvez pas accéder aux journaux. Si vous définissez log_output sur TABLE, la sortie du journal est placée dans une table de la base de données système mysql. Cela peut conduire à utiliser une quantité considérable d'espace disque. Si cette table devient trop volumineuse, cela peut affecter le temps de redémarrage de l'instance ou compromettre sa couverture par le contrat de niveau de service. Pour cette raison, l'option TABLE n'est pas recommandée. De plus, le contenu de ces journaux n'est pas disponible dans l'explorateur de journaux et ne fait pas l'objet d'une rotation. Si nécessaire, vous pouvez tronquer vos tables de journal à l'aide de l'API. Pour plus d'informations, consultez la page de la documentation de référence sur la méthode instances.truncateLog.

expire_logs_days, binlog_expire_logs_seconds

Si vous activez la récupération à un moment précis, la période d'expiration de vos journaux binaires est déterminée par la valeur la plus faible entre la durée de conservation du journal des transactions et les valeurs de ces options. Vous pouvez utiliser ces options pour gérer la durée de stockage des journaux binaires sur vos instances dupliquées. L'option expire_logs_days est supprimée de MySQL 8.4 et versions ultérieures. Pour en savoir plus, consultez la page Conservation des journaux de transactions.

innodb_buffer_pool_size

La valeur de cet indicateur correspond à la taille, en octets, du pool de mémoire tampon. La taille du pool de tampons doit toujours être égale ou multiple de la valeur obtenue en multipliant innodb_buffer_pool_chunk_size par innodb_buffer_pool_instances. Si vous modifiez la taille du pool de mémoire tampon pour qu'elle soit égale à une valeur qui n'est pas un multiple de innodb_buffer_pool_chunk_size multiplié par innodb_buffer_pool_instances, Cloud SQL ajuste automatiquement la taille du pool de mémoire tampon. Vous ne pouvez pas activer cet indicateur sur des instances disposant de moins de 3 840 Mio de RAM.

Vous ne pouvez pas configurer cet indicateur pour les types de machines à cœur partagé (f1_micro et g1_small). La modification de cette option sur MySQL 5.6 nécessite un redémarrage.

Dans Cloud SQL, les valeurs par défaut, minimales et maximales autorisées de l'option "innodb_buffer_pool_size" dépendent de la mémoire de l'instance. Ces valeurs peuvent être calculées de manière approximative sous forme de pourcentage de la mémoire RAM de l'instance. Par défaut, la valeur de cette option est généralement définie sur la valeur maximale autorisée. Le pourcentage d'allocation maximal autorisé augmente avec la taille de l'instance. La valeur minimale autorisée correspond généralement à environ 20 % de la mémoire RAM de l'instance.

Valeurs approximatives pour cette option :

Plage de la mémoire RAM de l'instance	% min.	% par défaut	% max.
0 — 4,0 Go de RAM		~34 %
4,0 Go — 7,5 Go	~20 %	~34 %	~34 %
7,5 Go — 12 Go	~20 %	~52 %	~52 %
12 Go — 24 Go	~20 %	~67 %	~67 %
24 Go et plus	~20 %	~72 %	~72 %

Vos valeurs exactes peuvent varier. Pour calculer la valeur actuelle de votre instance, vous pouvez exécuter la requête suivante :

  show global variables like 'innodb_buffer_pool_size';
  

Pour référence, les valeurs par défaut, minimales et maximales autorisées sont fournies pour les types de machines ci-dessous.

Type de machine	RAM d'instance (Go)	Min. (Go) (% du total)	Par défaut (Go) (% du total)	Max. (Go) (% du total)
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

La valeur par défaut de l'option binlog_order_commits est ON. Cloud SQL recommande de ne pas modifier la valeur par défaut de cette option. Si la valeur par défaut est modifiée pour OFF, les transactions du même groupe de journaux binaires seront validées dans un ordre différent de celui dans lequel elles ont été écrites dans le journal binaire. Cela affecte les opérations suivantes qui exécutent des transactions dans l'ordre du journal binaire:

• Réplication : peut entraîner une incohérence des données entre la source et les instances répliquées
• Récupération à un moment précis : cette opération peut entraîner une incohérence dans les données entre l'état restauré de la récupération PITR et l'état historique.

optimizer_switch,optimizer_trace,optimizer_trace_features

Les options d'optimisation contiennent des valeurs séparées par une virgule. Vous pouvez définir ces options à l'aide de la console ou de gcloud. Pour en savoir plus sur la configuration de cette option à l'aide de la console, consultez la section Configurer des options de base de données. Si vous utilisez gcloud, vous pouvez spécifier la valeur de ces options de deux manières différentes :

• Fichier d'options de thème gcloud
• Fichier d'options d'échappe gcloud

Pour définir plusieurs sous-options d'optimiseur dans une même commande, utilisez la virgule pour séparer chaque nom d'option. Si vous définissez une seule valeur de sous-option à l'aide de la commande gcloud, elle remplace toutes les sous-options précédemment définies. Par exemple, si vous exécutez la commande suivante, la valeur attendue de la sous-option batched_key_access est définie sur on et toutes les autres sous-options de optimizer_flags sont définies sur leurs valeurs par défaut.

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

Si vous exécutez la commande suivante, la valeur de la sous-option block_nested_loop est définie sur on et toutes les autres sous-options de optimizer_switch sont écrasées et définies sur leurs valeurs par défaut.

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

Cela inclut batched_key_access, qui a été défini sur on par la commande précédente. Pour conserver toutes les sous-options précédemment définies et en ajouter de nouvelles, vous devez ajouter les valeurs de toutes les sous-options que vous souhaitez définir lorsque vous ajoutez une nouvelle sous-option.

Options système modifiées dans Cloud SQL

Toutes les autres options système de base de données qui ne sont pas répertoriées dans la section Options compatibles sont appelées "options gérées". Pour certaines options gérées, Cloud SQL définit l'option sur une valeur autre la valeur par défaut afin de garantir l'exécution fiable des instances Cloud SQL. Vous ne pouvez pas modifier les valeurs de ces options système.

Les options gérées ayant une valeur autre que la valeur par défaut sont répertoriées ci-dessous.

Option système partial_revokes dans MySQL 8.0 et versions ultérieures

L'option partial_revokes vous permet de limiter l'accès des utilisateurs sur un schéma de base de données. Dans Cloud SQL pour MySQL version 8.0 et versions ultérieures, l'option partial_revokes est définie sur ON. Cela limite l'utilisation des caractères génériques lors de l'attribution ou de la révocation des droits d'un utilisateur sur des schémas de base de données dans MySQL 8.0. Mettez à jour votre instruction GRANT pour utiliser le nom complet du schéma de base de données au lieu d'utiliser des caractères génériques.

Par exemple, si vous exécutez la commande suivante avec le caractère générique %\ pour accorder des droits à un utilisateur dans MySQL 5.7, celui-ci disposera de droits sur toutes les bases de données se terminant par _foobar.

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

Cependant, dans MySQL 8.0, les utilisateurs n'auront accès qu'à la base de données qui correspond exactement à %\_foobar.

Deux méthodes permettent d'accorder l'accès à plusieurs bases de données dans MySQL 8.0 et versions ultérieures.

1. Vous pouvez accorder des autorisations sur des bases de données spécifiques à l'aide de leur nom complet, comme indiqué dans la commande ci-dessous :

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

2. Avec partial_revokes, vous pouvez exécuter les commandes grant et revoke pour accorder des droits à un utilisateur sur tous les schémas de base de données, tout en limitant l'accès à quelques schémas de base de données.

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

   Cela fournit un accès à tous les schémas de base de données tout en limitant l'accès à test3_foobar.*.

Filtres de réplication

Les filtres de réplication ne peuvent être définis que sur des instances répliquées Cloud SQL. Chaque filtre de réplication est défini comme une option unique pour plusieurs bases de données où les noms des bases de données sont séparés par une virgule. Vous pouvez configurer un filtre de réplication sur une instance répliquée Cloud SQL à l'aide de la console ou de la commande suivante :

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

Les filtres de réplication ne sont pas compatibles avec les noms de bases de données contenant des valeurs de virgule. La valeur ^~^ de la commande précédente est nécessaire pour les options de base de données qui sont des valeurs séparées par une virgule.

Lorsque vous définissez une option de filtre de réplication, tenez compte des points suivants :

• Si l'instance répliquée n'est plus opérationnelle, les données filtrées par les filtres de réplication peuvent apparaître sur l'instance répliquée, car Cloud SQL utilise les données sources de l'instance principale pour reconstruire l'instance répliquée.
• Vous ne pouvez pas définir de filtres de réplication sur le schéma mysql.
• Les règles de filtre de réplication ne s'appliquent pas aux exportations sans serveur.

Options du conseiller d'index

Voici la liste des options de base de données que Cloud SQL pour MySQL utilise pour activer et gérer les fonctionnalités spécifiques au conseiller d'index.

Options avec alias

La liste suivante contient les noms d'option qui ont été modifiés par Cloud SQL pour MySQL versions 8.0.26 et ultérieures.

Si votre instance Cloud SQL utilise un nom d'option obsolète, modifiez-la, supprimez le nom d'option obsolète, puis ajoutez le nouveau nom d'option à votre instance. Pour en savoir plus, consultez la section Configurer une option de base de données.

Dépannage

Étape suivante

• En savoir plus sur les MySQL system variables.
• En savoir plus sur les Consignes opérationnelles