הגדרת דגלים של מסד נתונים

בדף הזה מוסבר איך להגדיר דגלים של מסד נתונים ב-Cloud SQL, ומופיעה רשימה של הדגלים שאפשר להגדיר למופע. משתמשים בדגלים של מסד הנתונים כדי לבצע פעולות רבות, כולל התאמת פרמטרים של MySQL, התאמת אפשרויות והגדרה וכוונון של מופע.

במקרים מסוימים, כדי להפעיל באופן מלא את הפונקציונליות שרוצים להשתמש בה, יכול להיות שיהיה צורך להגדיר דגל אחד ואז להגדיר דגל נוסף. לדוגמה, כדי להפעיל רישום ביומן של שאילתות איטיות, צריך להגדיר את הדגל slow_query_log לערך on ואת הדגל log_output לערך FILE כדי שהיומנים יהיו זמינים באמצעות Logs Explorer במסוף Cloud de Confiance .

כשמגדירים, מסירים או משנים דגל של מופע מסד נתונים, יכול להיות שמסד הנתונים יופעל מחדש. הערך של הדגל נשמר עבור המופע עד שמסירים אותו. אם המכונה היא המקור של העתק, והיא מופעלת מחדש, גם העותק מופעל מחדש כדי להתאים להגדרה הנוכחית של המכונה.

הגדרת דגלים של מסד נתונים

בקטעים הבאים מפורטות משימות נפוצות לניהול דגלים.

הגדרת סימון של מסד נתונים

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

• ‫1 עבור db-f1-micro ו-db-g1-small.
• ‫1 אם RAM < 7.5 GB.
• ‫2 אם 7.5GB <= RAM < 13GB.
• ‫4 אם 13GB <= RAM < 26GB.
• ‫8 אם זיכרון ה-RAM הוא ‎26 GB או יותר.

דגלים נתמכים

הדגלים שנתמכים ב-Cloud SQL הם הדגלים המבוקשים ביותר ל-MySQL. אין תמיכה בדגלים שלא מוזכרים בהמשך.

יכול להיות ש-Cloud SQL תומך בערך או בטווח שונים של דגל מסוים בהשוואה לפרמטר או לאפשרות התואמים ב-MySQL.

הדגלים חלים על כל הגרסאות של MySQL שנתמכות על ידי Cloud SQL, אלא אם צוין אחרת.

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

מידע נוסף על הדגל הזה זמין בקטע טיפים.

שמות של אזורי זמן

בקטע הזה מוסבר על שמות אזורי הזמן שנתמכים ב-Cloud SQL ל-MySQL.

בטבלה שבקטע הזה מוצגים הנתונים הבאים:

• שם אזור הזמן: השם שנתמך ב-Cloud SQL ל-MySQL.
• STD: ההפרש מאזור הזמן בשעון רגיל (STD).
• שעון קיץ: ההסטה של אזור הזמן בשעון קיץ (DST).
• שמות נרדפים: שמות של אזורי זמן שאולי תרצו להשתמש בהם, אבל הם לא נתמכים ב-Cloud SQL ל-MySQL. במקרה כזה, צריך להשתמש בשם של אזור הזמן המתאים.

יכול להיות שצריך לרענן את טבלאות אזורי הזמן ב-Cloud SQL כדי לקבל את הנתונים העדכניים. לדוגמה, יכול להיות שמדינה מסוימת תעבור מהפרש אזור זמן של שעון קיץ להפרש אזור זמן של שעון רגיל, או שמדינה מסוימת תציג אזור זמן חדש.

בכל מהדורה של סוכן שירות קריטי (CSA) ל-Cloud SQL, טבלאות אזורי הזמן מתעדכנות עם הנתונים האחרונים. במצב כזה, במהלך חלון הזמן שאינו מיועד לתחזוקה, מתבצע רענון של מופעי הרפליקה. לאחר מכן, המערכת מרעננת את המופעים הראשיים במהלך חלון הזמנים לתחזוקה.

אפשר לחכות עד לחלון זמן לתחזוקה הרגיל של גרסת ה-CSA או לבצע תחזוקה בשירות עצמי כדי לרענן את טבלאות אזורי הזמן עם הנתונים העדכניים. מידע נוסף על צפייה בגרסאות התחזוקה הזמינות מופיע במאמר איך קובעים את גרסת התחזוקה של היעד.

טיפים לעבודה עם סימונים

general_log, slow_query_log

כדי שהיומנים של general או slow query יהיו זמינים, מפעילים את הדגל המתאים ומגדירים את הדגל log_output לערך FILE. כך פלט היומן יהיה זמין באמצעות כלי הצפייה ביומנים במסוף Cloud de Confiance . חשוב לזכור שחלים חיובים על רישום ביומן ב-Google Cloud Observability. כדי לצמצם את עלות האחסון של המופע, יומני general ו-slow query בדיסק של המופע מוחלפים כשהקובץ של היומן ישן מ-24 שעות (ולא בוצעו שינויים במהלך הזמן הזה) או גדול מ-100MB. קבצי יומן ישנים נמחקים אוטומטית אחרי הרוטציה.

אם הערך של log_output מוגדר כ-NONE, לא תהיה לכם גישה ליומנים. אם מגדירים את log_output לערך TABLE, פלט היומן מוצב בטבלה במסד הנתונים של מערכת mysql. יכול להיות שהם יתפסו נפח אחסון משמעותי. אם הטבלה הזו גדלה, היא יכולה להשפיע על זמן ההפעלה מחדש של המופע או לגרום לכך שהמופע לא יעמוד בדרישות של הסכם רמת השירות (SLA). לכן לא מומלץ להשתמש באפשרות TABLE. בנוסף, תוכן היומן לא זמין ב-Logs Explorer והוא לא עובר רוטציה. אם צריך, אפשר לקצץ את טבלאות היומן באמצעות ה-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,840MiB‎.

אי אפשר להגדיר את הדגל הזה לסוגי מכונות עם ליבה משותפת (f1_micro ו-g1_small). כדי לשנות את הדגל הזה ב-MySQL 5.6, צריך להפעיל מחדש את המערכת.

ב-Cloud SQL, ערכי ברירת המחדל, הערכים המינימליים והערכים המקסימליים המותרים של הדגל innodb_buffer_pool_size תלויים בזיכרון של המופע. אפשר לחשב את הערכים האלה בקירוב כאחוז מזיכרון ה-RAM של המופע. כברירת מחדל, הערך של הדגל הזה מוגדר בדרך כלל קרוב לערך המקסימלי המותר. אחוז ההקצאה המקסימלי המותר עולה עם גודל המופע. הערך המינימלי המותר הוא בדרך כלל כ-20% מזיכרון ה-RAM של המופע.

ערכים משוערים של הדגל הזה:

טווח זיכרון RAM של מכונה	מינימום %	אחוז ברירת המחדל	מקסימום %
‫0 עד 4.0GB של זיכרון RAM		‫~34%
‫4.0GB - 7.5GB	‫~20%	‫~34%	‫~34%
‫7.5GB – 12GB	‫~20%	‫~52%	‫~52%
‫12GB – 24GB	‫~20%	‫~67%	‫~67%
‫24GB ומעלה	‫~20%	‫‎~72%	‫‎~72%

הערכים המדויקים עשויים להיות שונים. כשהאפשרות מאגר זמני מנוהל מופעלת, מתבצעות התאמות ב-innodb_buffer_pool_size שלא משתקפות במסוף Cloud de Confiance . כדי לחשב את הערך הנוכחי של מופע, אפשר להריץ את השאילתה:

  show global variables like 'innodb_buffer_pool_size';
  

לעיון, בהמשך מפורטים ערכי המינימום, ברירת המחדל והמקסימום המותרים לסוגי המכונות.

סוג מכונה	Instance RAM (GB)	‫Min (GB) (% of total)	ברירת מחדל (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%)

אם השימוש בזיכרון גבוה במופע שלכם ואתם נתקלים באירועים של חוסר זיכרון (OOM), אתם יכולים להפעיל את הדגל innodb_cloudsql_managed_buffer_pool כדי להקטין את הערך של innodb_buffer_pool_size באופן זמני. מידע נוסף מופיע במאמר בנושא הפעלת מאגר חוצץ מנוהל.

show global variables like 'innodb_buffer_pool_size';

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 יפעלו בצורה מהימנה. אי אפשר לשנות את הערכים של דגלי המערכת האלה.

בהמשך מפורטים סימונים מנוהלים עם הגדרה שאינה ברירת המחדל.

דגל המערכת partial_revokes ב-MySQL 8.0 ואילך

הדגל partial_revokes מאפשר להגביל את גישת המשתמשים לסכימת מסד נתונים. ב-Cloud SQL ל-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 ואילך.

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.
• כללי סינון של שכפול לא חלים על ייצוא ללא שרת.

סימונים של Index advisor

בהמשך מפורטות פקודות מאפיינים של מסד נתונים שמשמשות את Cloud SQL ל-MySQL כדי להפעיל ולנהל תכונות שספציפיות ליועץ האינדקסים.

דגלים עם כינוי

הרשימה הבאה כוללת את שמות הדגלים ששונו על ידי Cloud SQL ב-MySQL בגרסאות 8.0.26 ואילך.

אם במכונת Cloud SQL שלכם נעשה שימוש בשם דגל שהוצא משימוש, צריך לערוך את מכונת Cloud SQL, למחוק את שם הדגל שהוצא משימוש ולהוסיף את הדגל החדש למכונה. מידע נוסף זמין במאמר בנושא הגדרת דגל מסד נתונים.

פתרון בעיות

המאמרים הבאים

• מידע נוסף על משתני מערכת של MySQL
• מידע נוסף על הנחיות תפעוליות