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

בדף הזה מוסבר איך להגדיר פלאגים של מסד נתונים ב-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: הקיזוז מאזור הזמן בשעון קיץ (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

אם מפעילים שחזור מערכת מנקודה מסוימת בזמן (PITR), תקופת התפוגה של יומני הבינארי נקבעת לפי התקופה הקצרה מבין תקופת השמירה של יומן העסקאות והערכים של הדגלים האלה. אפשר להשתמש בדגלים האלה כדי לקבוע את משך הזמן שבו יומנים בינאריים מאוחסנים בעותקים. הסימון 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,840MiB‎ של RAM.

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

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

  show global variables like 'innodb_buffer_pool_size';
  

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

סוג מכונה	זיכרון 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 באופן זמני. מידע נוסף מופיע במאמר בנושא הפעלת מאגר חוצץ מנוהל. (תצוגה מקדימה)

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
• מידע נוסף על הנחיות תפעוליות