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

‫MySQL   |  PostgreSQL   |  SQL Server

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

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

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

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

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

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

המסוף

1. במסוףGoogle Cloud , בוחרים את הפרויקט שמכיל את המכונה של Cloud SQL שרוצים להגדיר לה דגל לניהול מסד נתונים.
2. פותחים את המכונה ולוחצים על Edit.
3. עוברים לקטע דגלים.
4. כדי להגדיר דגל שלא הוגדר במכונה בעבר, לוחצים על Add item, בוחרים את הדגל מהתפריט הנפתח ומגדירים את הערך שלו.
5. לוחצים על Save כדי לשמור את השינויים.
6. מאשרים את השינויים בקטע סימונים בדף הסקירה הכללית.

gcloud

עורכים את המכונה:

gcloud sql instances patch INSTANCE_NAME --database-flags=FLAG1=VALUE1,FLAG2=VALUE2

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

לדוגמה, כדי להגדיר את הדגלים log_connections ו-log_min_error_statement, אפשר להשתמש בפקודה הבאה:

gcloud sql instances patch INSTANCE_NAME \
  --database-flags=log_connections=on,log_min_error_statement=error

Terraform

כדי להוסיף דגלים לניהול מסד נתונים, משתמשים במשאב של Terraform.

resource "google_sql_database_instance" "instance" {
  name             = "postgres-instance"
  region           = "us-central1"
  database_version = "POSTGRES_14"
  settings {
    database_flags {
      name  = "log_connections"
      value = "on"
    }
    database_flags {
      name  = "log_min_error_statement"
      value = "error"
    }
    tier = "db-custom-2-7680"
  }
  # 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
}

החלה של השינויים

כך מחילים את ההגדרות של Terraform בפרויקט ב- Google Cloud :

הכנת Cloud Shell

1. מפעילים את Cloud Shell.

2. מגדירים את פרויקט ברירת המחדל ב- Google Cloud שבו רוצים להחיל את ההגדרות של Terraform.

   תצטרכו להריץ את הפקודה הזו רק פעם אחת לכל פרויקט, ותוכלו לעשות זאת בכל ספרייה.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

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

הכנת הספרייה

לכל קובץ תצורה של Terraform צריכה להיות ספרייה משלו (שנקראת גם מודול ברמה הבסיסית).

1. יוצרים ספרייה חדשה ב-Cloud Shell ובה יוצרים קובץ חדש. שם הקובץ חייב לכלול את הסיומת .tf, למשל main.tf. במדריך הזה, הקובץ נקרא main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

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

   מעתיקים את הקוד לדוגמה בקובץ main.tf החדש שיצרתם.

   לחלופין, אפשר גם להעתיק את הקוד מ-GitHub. כדאי לעשות את זה כשקטע הקוד של Terraform הוא חלק מפתרון מקצה לקצה.

3. בודקים את הפרמטרים לדוגמה ומשנים אותם בהתאם לסביבה שלכם.
4. שומרים את השינויים.
5. מפעילים את Terraform. צריך לעשות זאת רק פעם אחת לכל ספרייה.

   terraform init

   אופציונלי: תוכלו לכלול את האפשרות -upgrade, כדי להשתמש בגרסה העדכנית ביותר של הספק של Google:

   terraform init -upgrade

החלה של השינויים

1. בודקים את ההגדרות ומוודאים שהמשאבים שמערכת Terraform תיצור או תעדכן תואמים לציפיות שלכם:

   terraform plan

   מתקנים את ההגדרות לפי הצורך.

2. מריצים את הפקודה הבאה ומזינים yes בהודעה שמופיעה, כדי להחיל את הגדרות Terraform:

   terraform apply

   ממתינים עד שב-Terraform תוצג ההודעה "Apply complete!‎".

3. פותחים את הפרויקט ב- Google Cloud כדי להציג את התוצאות. במסוף Google Cloud , נכנסים למשאבים בממשק המשתמש כדי לוודא שהם נוצרו או עודכנו ב-Terraform.

הערה: בדרך כלל הנחת העבודה בדוגמאות של Terraform היא שממשקי ה-API הנדרשים מופעלים בפרויקט ב- Google Cloud .

למחוק את השינויים

כדי למחוק את השינויים:

1. כדי להשבית את ההגנה מפני מחיקה, בקובץ התצורה של Terraform מגדירים את הארגומנט deletion_protection לערך false.

   deletion_protection =  "false"

2. מריצים את הפקודה הבאה ומזינים yes בהודעה שמופיעה, כדי להחיל את הגדרות Terraform המעודכנות:

   terraform apply

3. כדי להסיר משאבים שהוחלו בעבר על הגדרות Terraform, מריצים את הפקודה הבאה ומזינים yes בהודעה שמופיעה:

   terraform destroy

REST v1

כדי להגדיר דגל למסד נתונים קיים:

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫project-id: מזהה הפרויקט
• ‫instance-id: מזהה המכונה

ה-method של ה-HTTP וכתובת ה-URL:

PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

תוכן בקשת JSON:

{
  "settings":
  {
    "databaseFlags":
    [
      {
        "name": "flag_name",
        "value": "flag_value"
      }
    ]
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

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"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$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

אתם אמורים לקבל תגובת JSON שדומה לזו:

תשובה

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "[e-mail]",
  "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 מחליפה את הדגלים הקיימים בדגלים שצוינו בבקשה.

REST v1beta4

כדי להגדיר דגל למסד נתונים קיים:

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫project-id: מזהה הפרויקט
• ‫instance-id: מזהה המכונה

ה-method של ה-HTTP וכתובת ה-URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

תוכן בקשת JSON:

{
  "settings":
  {
    "databaseFlags":
    [
      {
        "name": "flag_name",
        "value": "flag_value"
      }
    ]
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

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"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$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

אתם אמורים לקבל תגובת JSON שדומה לזו:

תשובה

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "[e-mail]",
  "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 מחליפה את הדגלים הקיימים בדגלים שצוינו בבקשה.

איפוס כל הדגלים לערכי ברירת המחדל שלהם

המסוף

1. במסוףGoogle Cloud , בוחרים את הפרויקט שמכיל את המכונה של Cloud SQL שרוצים לנקות את כל הדגלים שלה.
2. פותחים את המכונה ולוחצים על Edit.
3. פותחים את הקטע Database flags.
4. לוחצים על ה-X לצד כל הסימונים שמוצגים.
5. לוחצים על Save כדי לשמור את השינויים.

gcloud

איפוס כל הדגלים לערכי ברירת המחדל שלהם במכונה:

gcloud sql instances patch INSTANCE_NAME \
--clear-database-flags

תתבקשו לאשר את ההפעלה מחדש של המכונה.

REST v1

כדי לנקות את כל הדגלים של מכונה קיימת:

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫project-id: מזהה הפרויקט
• ‫instance-id: מזהה המכונה

ה-method של ה-HTTP וכתובת ה-URL:

PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

תוכן בקשת JSON:

{
  "settings":
  {
    "databaseFlags": []
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

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"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$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

אתם אמורים לקבל תגובת JSON שדומה לזו:

תשובה

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "[e-mail]",
  "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"
}

REST v1beta4

כדי לנקות את כל הדגלים של מכונה קיימת:

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫project-id: מזהה הפרויקט
• ‫instance-id: מזהה המכונה

ה-method של ה-HTTP וכתובת ה-URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

תוכן בקשת JSON:

{
  "settings":
  {
    "databaseFlags": []
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

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"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$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

אתם אמורים לקבל תגובת JSON שדומה לזו:

תשובה

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "[e-mail]",
  "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"
}

הצגת הערכים הנוכחיים של דגלים לניהול מסדי נתונים

כדי לראות את כל הערכים הנוכחיים של הגדרות PostgreSQL, נכנסים למכונה באמצעות הלקוח psql ומזינים את ההצהרה הבאה:

 SELECT name, setting FROM pg_settings;

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

איך בודקים אילו דגלים לניהול מסד נתונים הוגדרו למכונה

כדי לראות אילו דגלים הוגדרו למכונה של Cloud SQL:

המסוף

1. במסוףGoogle Cloud , בוחרים את הפרויקט שמכיל את המכונה של Cloud SQL שרוצים לראות את דגלי ניהול מסד הנתונים שהוגדרו לה.
2. בוחרים את המכונה כדי לפתוח את הדף Instance Overview.

   הדגלים שהוגדרו למסד הנתונים מופיעים בקטע Database flags.

gcloud

בודקים את מצב המכונה:

gcloud sql instances describe INSTANCE_NAME

בפלט, הדגלים לניהול מסד הנתונים מופיעים בקולקציה databaseFlags, מתחת ל-settings. למידע נוסף על ייצוג הדגלים בפלט, ראו ייצוג משאבים של מכונות.

REST v1

כדי להציג רשימה של דגלים שהוגדרו למכונה:

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫project-id: מזהה הפרויקט
• ‫instance-id: מזהה המכונה

ה-method של ה-HTTP וכתובת ה-URL:

GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

$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

אתם אמורים לקבל תגובת JSON שדומה לזו:

תשובה

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

בפלט, מחפשים את השדה databaseFlags.

REST v1beta4

כדי להציג רשימה של דגלים שהוגדרו למכונה:

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫project-id: מזהה הפרויקט
• ‫instance-id: מזהה המכונה

ה-method של ה-HTTP וכתובת ה-URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

$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

אתם אמורים לקבל תגובת JSON שדומה לזו:

תשובה

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

בפלט, מחפשים את השדה databaseFlags.

דגלים נתמכים

אין תמיכה בדגלים שלא מוזכרים בטבלה הבאה.

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

א | ב | ג | ד | ה | ו | ז | ח | ט | י | כ | ל | מ | נ | ס | ע | פ | צ | ק | ר | ש | ת

דגל של Cloud SQL	סוג ערכים קבילים והערות	נדרשת הפעלה מחדש?
anon.algorithm	String ערך ברירת המחדל הוא sha256.	לא
anon.maskschema	String ערך ברירת המחדל הוא mask.	לא
anon.restrict_to_trusted_schemas	boolean on | off ברירת המחדל היא מושבת.	לא
anon.salt	String אין ערך ברירת מחדל.	לא
anon.sourceschema	String ברירת המחדל היא public.	לא
auto_explain.log_analyze	boolean on | off ברירת המחדל היא off.	לא
auto_explain.log_buffers	boolean on | off ברירת המחדל היא מושבת.	לא
auto_explain.log_min_duration	Integer -1 ... 2147483647 ערך ברירת המחדל הוא -1.	לא
auto_explain.log_format	String text|xml|json|yaml ברירת המחדל היא text.	לא
auto_explain.log_level	String debug5|debug4|debug3|debug2|debug1|debug| info|notice|warning|log ערך ברירת המחדל הוא log. נתמך ב-PostgreSQL מגרסה 12 ואילך.	לא
auto_explain.log_nested_statements	boolean on | off ברירת המחדל היא מושבת.	לא
auto_explain.log_settings	boolean on | off ברירת המחדל היא off. נתמך ב-PostgreSQL מגרסה 12 ואילך.	לא
auto_explain.log_timing	boolean on | off ברירת המחדל היא on.	לא
auto_explain.log_triggers	boolean on | off ברירת המחדל היא מושבת.	לא
auto_explain.log_wal	boolean on | off ברירת המחדל היא off. נתמך ב-PostgreSQL מגרסה 13 ואילך.	לא
auto_explain.log_verbose	boolean on | off ברירת המחדל היא מושבת.	לא
auto_explain.sample_rate	Float 0 ... 1 ערך ברירת המחדל הוא 1.	לא
autovacuum	boolean on | off ברירת המחדל היא מופעל. למידע על השימוש שעשוי להשפיע על הסכם רמת השירות, קראו את ההנחיות התפעוליות למכונות של Cloud SQL ל-PostgreSQL.	לא
autovacuum_analyze_scale_factor	float 0 ... 100 ערך ברירת המחדל הוא 0.1.	לא
autovacuum_analyze_threshold	integer 0 ... 2147483647 ערך ברירת המחדל הוא 50.	לא
autovacuum_freeze_max_age	integer 100000 ... 2000000000 ערך ברירת המחדל הוא 200000000. למידע על השימוש שעשוי להשפיע על הסכם רמת השירות, קראו את ההנחיות התפעוליות למכונות של Cloud SQL ל-PostgreSQL.	כן
autovacuum_max_workers	integer 1 ... varies (see note) ברירת המחדל היא 3. הערה: כדי לקבוע את הערך המקסימלי שאפשר להגדיר לדגל הזה, קודם צריך לחשב את מספר החיבורים לקצה העורפי שכבר נמצאים בשימוש. החישוב הזה הוא הסכום של הערכים של max_connections (המספר המקסימלי של חיבורי לקוחות), ‏autovacuum_max_workers (המספר המקסימלי של תהליכי autovacuum) ו-max_worker_processes. הסכום לא יכול להיות גבוה מ-262142.	כן
autovacuum_multixact_freeze_max_age	integer 10000 ... 2000000000 ערך ברירת המחדל הוא 400000000. למידע על השימוש שעשוי להשפיע על הסכם רמת השירות, קראו את ההנחיות התפעוליות למכונות של Cloud SQL ל-PostgreSQL.	כן
autovacuum_naptime	integer 1 ... 2147483s ערך ברירת המחדל הוא 60s.	לא
autovacuum_vacuum_cost_delay	‫integer 0 ... 100 אלפיות השנייה, או -1 כדי להשתמש בערך vacuum_cost_delay ב-PostgreSQL בגרסאות 9.6, 10 ו-11, ערך ברירת המחדל הוא 2 אלפיות השנייה.	לא
autovacuum_vacuum_cost_limit	‫integer 0 … 10000, או -1 כדי להשתמש בערך vacuum_cost_limit ערך ברירת המחדל הוא -1.	לא
autovacuum_vacuum_insert_scale_factor	float 0 ... 100 ערך ברירת המחדל הוא 0.2.	לא
autovacuum_vacuum_insert_threshold	integer -1 ... 2147483647 ערך ברירת המחדל הוא 1000.	לא
autovacuum_vacuum_max_threshold	integer -1 ... 2147483647 ערך ברירת המחדל הוא 100000000. נתמך ב-PostgreSQL מגרסה 18 ואילך.	לא
autovacuum_vacuum_scale_factor	float 0 ... 100 ערך ברירת המחדל הוא 0.2.	לא
autovacuum_vacuum_threshold	integer 0 ... 2147483647 ערך ברירת המחדל הוא 50.	לא
autovacuum_work_mem	‫integer 0 ... 2147483647 KB, או -1 כדי להשתמש בערך של maintenance_work_mem ערך ברירת המחדל הוא -1.	לא
autovacuum_worker_slots	integer 1 ... 262143 ברירת המחדל היא 16. נתמך ב-PostgreSQL מגרסה 18 ואילך.	כן
backend_flush_after	integer 0 ... 256 היחידה היא 8KB. ערך ברירת המחדל הוא 0.	לא
bgwriter_delay	integer 10 ... 10000 אלפיות השנייה ברירת המחדל היא 200.	לא
bgwriter_flush_after	integer 0 ... 256 היחידה היא 8KB. ערך ברירת המחדל הוא 64.	לא
bgwriter_lru_maxpages	integer 0 ... 1073741823 ערך ברירת המחדל הוא 100.	לא
bgwriter_lru_multiplier	Float 0 ... 10 ברירת המחדל היא 2.	לא
checkpoint_completion_target	float 0.0 ... 1.0 ברירת המחדל היא 0.9.	לא
checkpoint_flush_after	integer 0 ... 256 היחידה היא 8KB. ערך ברירת המחדל הוא 32.	לא
checkpoint_timeout	integer 30 ... 86,400s ערך ברירת המחדל הוא 300s. למידע על השימוש שעשוי להשפיע על הסכם רמת השירות, קראו את ההנחיות התפעוליות למכונות של Cloud SQL ל-PostgreSQL.	לא
checkpoint_warning	integer 0 ... 2147483647s ברירת המחדל היא 30 שניות.	לא
client_connection_check_interval	integer 0 ... 2147483647 ערך ברירת המחדל הוא 0.	לא
cloudsql.allow_passwordless_local_connections	boolean on | off ברירת המחדל היא off. הערה: הדגל הזה ספציפי ל-Cloud SQL. בנוסף, Cloud SQL לא תומך בדגל של משתמשי ניהול זהויות והרשאות גישה (IAM).	לא
cloudsql.enable_anon	boolean on | off ברירת המחדל היא off. הערה: הדגל הזה ספציפי ל-Cloud SQL.	לא
cloudsql.enable_auto_explain	boolean on | off ברירת המחדל היא off. הערה: הדגל הזה ספציפי ל-Cloud SQL.	כן
cloudsql.enable_index_advisor	boolean on | off ברירת המחדל היא off. הערה: הדגל הזה ספציפי ל-Cloud SQL.	כן
cloudsql.enable_maintenance_mode	boolean on | off ברירת המחדל היא off. הערה: הדגל הזה ספציפי ל-Cloud SQL. למידע נוסף על הדגל הזה, קראו את המאמר התגברות על גלישה של מזהה עסקה (TXID).	כן
cloudsql.enable_parameterized_secure_views	boolean on | off ברירת המחדל היא off. הערה: הדגל הזה ספציפי ל-Cloud SQL. מידע נוסף על הדגל הזה זמין במאמר תצוגות מאובטחות עם פרמטרים ב-Cloud SQL.	כן
cloudsql.enable_pgaudit	boolean on | off ערך ברירת המחדל הוא off. הערה: הדגל הזה ספציפי ל-Cloud SQL. למידע נוסף על הדגל הזה, ראו ביקורת ל-PostgreSQL באמצעות pgAudit.	כן
cloudsql.enable_pg_bigm	boolean on | off default: off הערה: הדגל הזה ספציפי ל-Cloud SQL. מידע נוסף על הדגל הזה זמין במאמר pg_bigm.	כן
cloudsql.enable_pg_cron	boolean on | off ברירת המחדל היא off. נתמך ב-PostgreSQL מגרסה 10 ואילך. הערה: הדגל הזה ספציפי ל-Cloud SQL.	כן
cloudsql.enable_pg_hint_plan	boolean on | off ברירת המחדל היא off. הערה: הדגל הזה ספציפי ל-Cloud SQL.	כן
cloudsql.enable_pglogical	boolean on | off ברירת המחדל היא off. הערה: הדגל הזה ספציפי ל-Cloud SQL. מידע נוסף על הדגל הזה זמין במאמר הגדרה של רפליקציה לוגית ופענוח.	כן
cloudsql.enable_pg_squeeze	boolean on | off ברירת המחדל היא off. הערה: הדגל הזה ספציפי ל-Cloud SQL.	כן
cloudsql.enable_pg_textsearch	boolean on | off ברירת המחדל היא off. הערה: הדגל הזה ספציפי ל-Cloud SQL.	כן
cloudsql.enable_pg_wait_sampling	boolean on | off הערה: הדגל הזה ספציפי ל-Cloud SQL.	כן
cloudsql.enable_vector_assist	boolean on | off ברירת המחדל היא off. הערה: הדגל הזה ספציפי ל-Cloud SQL. מידע נוסף על הדגל הזה מופיע ב סקירה הכללית על Vector assist.	כן
cloudsql.iam_authentication	boolean on | off ברירת המחדל היא off. הערה: הדגל הזה ספציפי ל-Cloud SQL.	לא
cloudsql.logical_decoding	boolean on | off ברירת המחדל היא off. הערה: הדגל הזה ספציפי ל-Cloud SQL. מידע נוסף על הדגל הזה זמין במאמר הגדרה של רפליקציה לוגית ופענוח.	כן
cloudsql.max_failed_attempts_user	integer 0 ... 10000 ערך ברירת המחדל הוא 10. הערה: הדגל הזה ספציפי ל-Cloud SQL. היא קובעת את מספר המשתמשים שיכולים להגדיר את ההגבלה נעילה אחרי ניסיונות כושלים במדיניות הסיסמאות של המשתמשים. ההגבלה הזו מציינת את מספר הפעמים שמשתמש יכול לנסות להזין סיסמה שגויה לפני שהחשבון שלו יינעל.	כן
cloudsql.pgaudit_mask_literals	boolean on | off ברירת המחדל היא off. הערה: הדגל הזה ספציפי ל-Cloud SQL.	לא
cloudsql.pg_authid_select_role	string הערה: הדגל הזה ספציפי ל-Cloud SQL. למידע נוסף על הדגל הזה, קראו את המאמר גישה לתצוגה pg_shadow ולטבלה pg_authid.	לא
commit_delay	integer 0 ... 100000 ערך ברירת המחדל הוא 0.	לא
commit_siblings	integer 0 ... 1000 ברירת המחדל היא 5.	לא
constraint_exclusion	enumeration partition | on | off ברירת המחדל היא partition.	לא
cpu_index_tuple_cost	float 0.0 ... inf ערך ברירת המחדל הוא 0.005.	לא
cpu_operator_cost	float 0.0 ... inf ערך ברירת המחדל הוא 0.0025.	לא
cpu_tuple_cost	float 0.0 ... inf ברירת המחדל היא 0.01.	לא
cron.database_name	String. נתמך ב-PostgreSQL מגרסה 10 ואילך.	כן
cron.log_statement	boolean on | off ברירת המחדל היא on. נתמך ב-PostgreSQL מגרסה 10 ואילך.	כן
cron.log_run	boolean on | off ברירת המחדל היא מופעל. נתמך ב-PostgreSQL מגרסה 10 ואילך.	כן
cron.max_running_jobs	Integer 0 ... varies ערך ברירת המחדל הוא 5. נתמך ב-PostgreSQL מגרסה 10 ואילך.	כן
cron.log_min_messages	String debug5|debug4|debug3|debug2|debug1|debug| info|notice|warning|error|log|fatal|panic ברירת המחדל היא warning. נתמך ב-PostgreSQL מגרסה 10 ואילך.	לא
cursor_tuple_fraction	float 0.0 ... 1.0 ערך ברירת המחדל הוא 0.1.	לא
deadlock_timeout	integer 1 ... 2147483647 אלפיות השנייה ברירת המחדל היא 1000 אלפיות השנייה.	לא
default_statistics_target	integer 1 ... 10000 ערך ברירת המחדל הוא 100.	לא
default_tablespace	string	לא
default_toast_compression	string ערך ברירת המחדל הוא pglz.	לא
default_transaction_deferrable	boolean on | off ברירת המחדל היא off.	לא
default_transaction_isolation	enumeration serializable | 'repeatable read' | 'read committed' | 'read uncommitted' ברירת המחדל היא 'read committed'.	לא
effective_cache_size	integer טווח הגודל הוא בין 10% ל-70% מהזיכרון של המכונה. היחידה היא 8KB. ברירת המחדל היא 40% מזיכרון ה-VM. לדוגמה, במכונה עם זיכרון של 45GB, ערך ברירת המחדל הוא 18537160KB.	לא
effective_io_concurrency	integer 0 ... 1000 ברירת המחדל היא 1.	לא
enable_async_append	boolean on | off ברירת המחדל היא on.	לא
enable_bitmapscan	boolean on | off ברירת המחדל היא on.	לא
enable_distinct_reordering	boolean on | off ברירת המחדל היא on. נתמך ב-PostgreSQL מגרסה 18 ואילך.	לא
enable_gathermerge	boolean on | off ברירת המחדל היא מופעל.	לא
enable_incremental_sort	boolean on | off ברירת המחדל היא מופעל.	לא
enable_memoize	boolean on | off ברירת המחדל היא מופעל.	לא
enable_parallel_append	boolean on | off ברירת המחדל היא on.	לא
enable_parallel_hash	boolean on | off ברירת המחדל היא מופעל.	לא
enable_partition_pruning	boolean on | off ברירת המחדל היא on.	לא
enable_partitionwise_aggregate	boolean on | off ברירת המחדל היא off.	לא
enable_partitionwise_join	boolean on | off ברירת המחדל היא מושבת.	לא
enable_hashagg	boolean on | off ברירת המחדל היא on.	לא
enable_hashjoin	boolean on | off ברירת המחדל היא on.	לא
enable_indexonlyscan	boolean on | off ברירת המחדל היא on.	לא
enable_indexscan	boolean on | off ברירת המחדל היא on.	לא
enable_material	boolean on | off ברירת המחדל היא מופעל	לא
enable_mergejoin	boolean on | off ברירת המחדל היא on.	לא
enable_nestloop	boolean on | off ברירת המחדל היא on.	לא
enable_self_join_elimination	boolean on | off ברירת המחדל היא on. נתמך ב-PostgreSQL מגרסה 18 ואילך.	לא
enable_seqscan	boolean on | off ברירת המחדל היא on.	לא
enable_sort	boolean on | off ברירת המחדל היא on.	לא
enable_tidscan	boolean on | off ברירת המחדל היא on.	לא
force_parallel_mode	enumeration off | on | regress ברירת המחדל היא off. הערה: ב-PostgreSQL 16 ואילך, הדגל הזה נקרא debug_parallel_query.	לא
from_collapse_limit	integer 1 ... 2147483647 ברירת המחדל היא 8.	לא
geqo	boolean on | off ברירת המחדל היא on.	לא
geqo_effort	integer 1 ... 10 ברירת המחדל היא 5.	לא
geqo_generations	integer 0 ... 2147483647 ערך ברירת המחדל הוא 0.	לא
geqo_pool_size	integer 0 ... 2147483647 ערך ברירת המחדל הוא 0.	לא
geqo_seed	float 0.0 ... 1.0 ערך ברירת המחדל הוא 0.	לא
geqo_selection_bias	float 1.5 ... 2.0 ערך ברירת המחדל הוא 2.	לא
geqo_threshold	integer 2 ... 2147483647 ערך ברירת המחדל הוא 12.	לא
gin_fuzzy_search_limit	integer 0 ... 2147483647 ערך ברירת המחדל הוא 0.	לא
gin_pending_list_limit	integer 64 ... 2147483647KB ברירת המחדל היא 4096KB.	לא
hash_mem_multiplier	float 1 ... 1000 ברירת המחדל היא 2.	לא
hot_standby_feedback	boolean on | off ברירת המחדל היא off.	לא
huge_pages	enumeration try | off ערך ברירת המחדל הוא try.	כן
idle_in_transaction_session_timeout	integer 0 ... 2147483647 אלפיות השנייה ברירת המחדל היא 0.	לא
io_max_concurrency	integer -1 ... 1024 ערך ברירת המחדל הוא ‎-1. נתמך ב-PostgreSQL מגרסה 18 ואילך.	כן
io_method	string sync, worker ערך ברירת המחדל הוא worker. נתמך ב-PostgreSQL מגרסה 18 ואילך.	כן
io_workers	integer -1 ... 32 ברירת המחדל היא 3. נתמך ב-PostgreSQL מגרסה 18 ואילך.	לא
ivfflat.probes	integer 1 ... varies ערך ברירת המחדל הוא 1. נתמך ב-PostgreSQL מגרסה 11 ואילך.	לא
join_collapse_limit	integer 1 ... 2147483647 ברירת המחדל היא 8.	לא
local_preload_libraries	String הדגל הזה מאפשר לציין ספרייה משותפת אחת או יותר שנטענות מראש בתחילת החיבור למסד הנתונים, ברשימה שמופרדת בפסיקים.	לא
lock_timeout	integer 0 ... 2147483647 אלפיות השנייה ברירת המחדל היא 0.	לא
log_autovacuum_min_duration	‫integer 0 ... 2147483647 אלפיות השנייה, או -1 כדי להשבית ברירת המחדל היא 0.	לא
log_checkpoints	boolean on | off ברירת המחדל היא off.	לא
log_connections	boolean on | off ברירת המחדל היא off.	לא
log_disconnections	boolean on | off ברירת המחדל היא off.	לא
log_duration	boolean on | off ברירת המחדל היא off.	לא
log_error_verbosity	enumeration terse | default | verbose ערך ברירת המחדל הוא default.	לא
log_executor_stats	boolean on | off ברירת המחדל היא off.	לא
log_hostname	boolean on | off ברירת המחדל היא off.	לא
log_line_prefix	String מחרוזת בסגנון printf שנוצרת בתחילת כל שורה בקובץ יומן. ברירת המחדל היא %m [%p]: [%l-1] db=%d,user=%u, שמתעדת חותמת זמן, מזהה תהליך, מסד נתונים ושם משתמש.	לא
log_lock_failures	boolean on | off ברירת המחדל היא off. נתמך ב-PostgreSQL מגרסה 18 ואילך.	לא
log_lock_waits	boolean on | off ברירת המחדל היא off.	לא
log_min_duration_statement	integer -1 ... 2147483647 אלפיות השנייה ברירת המחדל היא -1.	לא
log_min_error_statement	enumeration debug5 | debug4 | debug3 | debug2 | debug1 | info | notice | warning | error | log | fatal | panic ברירת המחדל היא error.	לא
log_min_messages	enumeration debug5 | debug4 | debug3 | debug2 | debug1 | info | notice | warning | error | log | fatal | panic ברירת המחדל היא warning.	לא
log_parameter_max_length	integer -1 ... 1073741823 ערך ברירת המחדל הוא ‎-1. נתמך ב-PostgreSQL מגרסה 13 ואילך.	לא
log_parameter_max_length_on_error	integer -1 ... 1073741823 ערך ברירת המחדל הוא 0. נתמך ב-PostgreSQL מגרסה 13 ואילך.	לא
log_parser_stats	boolean on | off ברירת המחדל היא off.	לא
log_planner_stats	boolean on | off ברירת המחדל היא off.	לא
log_recovery_conflict_waits	boolean on | off ברירת המחדל היא off.	לא
log_replication_commands	boolean on | off ברירת המחדל היא off.	לא
log_statement	enumeration none | ddl | mod | all מגדירים את הערך mod כדי לתעד את כל ההצהרות של שפת הגדרת נתונים (DDL), וגם הצהרות לשינוי נתונים כמו INSERT, ‏ UPDATE, ‏ DELETE, ‏ TRUNCATE ערך ברירת המחדל הוא none. אם לא מגדירים את הערך none, יכול להיות ש-PostgreSQL יתעד פקודות רישום ביומן שמכילות סיסמאות. מומלץ להשתמש ב-pgAudit במקום ב-log_statement.	לא
log_statement_stats	boolean on | off אי אפשר להפעיל את המדיניות הזו יחד עם log_parser_stats,‏ log_planner_stats או log_executor_stats. ברירת המחדל היא מושבת.	לא
log_temp_files	‫integer 0 ... 2147483647 ק"ב, או -1 כדי להשבית ברירת המחדל היא 0.	לא
log_timezone	string הדגל הזה מאפשר למשתמשי Cloud SQL ל-PostgreSQL להגדיר את אזור הזמן שמשמש לחותמות זמן שנכתבות ביומן השרת. אתם מציינים את אזורי הזמן לפי השם שלהם. לדוגמה, Europe/London הוא שם אזור הזמן של לונדון. כדי להביא זאת בחשבון, צריך לעדכן את הדגל הזה באופן ידני במכונה הראשית ובכל הרפליקות לקריאה בלבד. שמות של אזורי זמן הם לא תלויי-רישיות. אפשר לציין את שם אזור הזמן בכל אותיות רישיות או קטנות. אנחנו תומכים ב-UTC+X כפורמט תקין לדגל הזה, כאשר X הוא +/-HH:MM. בשלב הזה אנחנו לא תומכים במפרטים של אזורי זמן ב-POSIX.	כן
logical_decoding_work_mem	integer 64 ... 2147483647 ברירת המחדל היא 65536.	לא
maintenance_io_concurrency	integer 0 ... 1000 ערך ברירת המחדל הוא 10.	לא
maintenance_work_mem	integer 1024 ... 2147483647 KB ברירת המחדל היא 64 MB.	לא
max_active_replication_origins	integer 0 ... 262143 ערך ברירת המחדל הוא 10. צריך להגדיר את הדגל הזה כשמשתמשים במאגרי קריאה. נתמך ב-PostgreSQL מגרסה 18 ואילך.	כן
max_connections	integer 14 ... varies (see note) ערך ברירת המחדל תלוי בכמות הזיכרון של המכונה הגדולה ביותר בשרשרת המכונות הראשיות (המכונה הזו, ואם היא עותק לקריאה בלבד, המכונה הראשית שלה, המכונה הראשית של המכונה הראשית שלה וכו', עד לשורש של עץ השכפול). זיכרון (GB) במכונה הגדולה ביותר ערך ברירת המחדל קטן מאוד (כ-0.5) 25 קטן (‎~1.7) 50 מ-3.75 עד פחות מ-6 100 מ-6 עד פחות מ-7.5 200 מ-7.5 עד < 15 400 מ-15 עד פחות מ-30 500 מ-30 עד פחות מ-60 600 מ-60 עד פחות מ-120 800 >=120 1,000 הערה: כדי לקבוע את הערך המקסימלי שאפשר להגדיר לדגל הזה, קודם צריך לחשב את מספר החיבורים לקצה העורפי שכבר נמצאים בשימוש. החישוב הזה הוא הסכום של הערכים של max_connections (המספר המקסימלי של חיבורי לקוחות), ‏autovacuum_max_workers (המספר המקסימלי של תהליכי autovacuum) ו-max_worker_processes. הסכום לא יכול להיות גבוה מ-262142. הערך ברפליקות חייב להיות גדול מהערך בראשי או שווה לו. שינויים במופע הראשי מועברים לרפליקות שהערך שלהן נמוך מהערך החדש במופע הראשי, או שהערך שלהן לא שונה מערך ברירת המחדל. שינויים כאלה במופע הראשי גורמים להפעלה מחדש של הרפליקה.	כן
max_locks_per_transaction	integer 10 ... 2,147,483,647 ברירת המחדל היא 64. הערך ברפליקות חייב להיות גדול מהערך בראשי או שווה לו. שינויים במופע הראשי מועברים לרפליקות שהערך שלהן נמוך מהערך החדש במופע הראשי, או שהערך שלהן לא שונה מערך ברירת המחדל. שינויים כאלה במופע הראשי גורמים להפעלה מחדש של הרפליקה.	כן
max_logical_replication_workers	integer 4 ... 8192 ברירת המחדל היא 4. נתמך ב-PostgreSQL מגרסה 10 ואילך.	כן
max_parallel_maintenance_workers	integer 0 ... varies הערה: המגבלות מבוססות על ה-RAM במכונה, כפי שמתואר בקטע max_worker_processes. ערך ברירת המחדל הוא 2. נתמך ב-PostgreSQL מגרסה 11 ואילך. הערך ברפליקות חייב להיות גדול מהערך בראשי או שווה לו. שינויים בערך הראשי מועברים לרפליקות שבהן הערך נמוך מהערך החדש בראשי, או שלא שונו מערך ברירת המחדל. אם הערך של המכונה הראשית הוא default, אי אפשר לשנות את הערך של הרפליקות. כדי לשנות את הערך של הרפליקות, קודם צריך להגדיר את הערך של הרפליקה הראשית כמספר שלם.	לא
max_parallel_workers	integer 0 ... varies הערה: המגבלות מבוססות על ה-RAM במכונה, כפי שמתואר בקטע max_worker_processes. ערך ברירת המחדל הוא 8. נתמך ב-PostgreSQL מגרסה 10 ואילך. הערך ברפליקות חייב להיות גדול מהערך בראשי או שווה לו. שינויים בערך הראשי מועברים לרפליקות שבהן הערך נמוך מהערך החדש בראשי, או שלא שונו מערך ברירת המחדל. אם הערך של המכונה הראשית הוא default, אי אפשר לשנות את הערך של הרפליקות. כדי לשנות את הערך של הרפליקות, קודם צריך להגדיר את הערך של הרפליקה הראשית כמספר שלם.	לא
max_parallel_workers_per_gather	integer 0 ... varies הערה: המגבלות מבוססות על ה-RAM במכונה, כפי שמתואר בקטע max_worker_processes. ערך ברירת המחדל הוא 2. הערך ברפליקות חייב להיות גדול מהערך בראשי או שווה לו. שינויים בערך הראשי מועברים לרפליקות שבהן הערך נמוך מהערך החדש בראשי, או שלא שונו מערך ברירת המחדל. אם הערך של המכונה הראשית הוא default, אי אפשר לשנות את הערך של הרפליקות. כדי לשנות את הערך של הרפליקות, קודם צריך להגדיר את הערך של הרפליקה הראשית כמספר שלם.	לא
max_pred_locks_per_page	integer 0 ... 2147483647 ברירת המחדל היא 2. נתמך ב-PostgreSQL מגרסה 10 ואילך.	לא
max_pred_locks_per_relation	integer -2147483648 ... 2147483647 ברירת המחדל היא -2. נתמך ב-PostgreSQL מגרסה 10 ואילך.	לא
max_pred_locks_per_transaction	integer 64 ... 1048576 הערה: הערך המקסימלי של ההגדרה הזו משתנה באופן לינארי בהתאם לזיכרון שזמין במכונה. נפח הזיכרון (GB) ערך מקסימלי 0 - 1 512 ‫1 עד 2 1024 2 - 4 2048 4 - 8 4096 8 - 16 8192 16 עד 32 16384 32 - 64 32768 64 - 128 65536 128 - 256 131072 256 - 512 262144 512 - 1024 524288 > 1024 1048576	כן
max_prepared_transactions	integer 0 ... varies גודל הזיכרון (MB) ערך מקסימלי 0 - 3,840 30,000 3,840 - 7,680 85,000 7,680 - 15,360 200,000 ‫15,360 ואילך 262,000 הערך ברפליקות חייב להיות גדול מהערך בראשי או שווה לו. שינויים במופע הראשי מועברים לרפליקות שהערך שלהן נמוך מהערך החדש במופע הראשי, או שהערך שלהן לא שונה מערך ברירת המחדל. שינויים כאלה במופע הראשי גורמים להפעלה מחדש של הרפליקה.	כן
max_replication_slots	integer 10 ... varies הערה: הערך המקסימלי של ההגדרה הזו משתנה באופן לינארי בהתאם לזיכרון שזמין במכונה. נפח הזיכרון (GB) ערך מקסימלי 0 - 4 10 4 - 16 32 16 עד 32 128 32 - 64 256 64 -128 512 128 - 256 1024 256 - 512 2048 > 512 4096 למידע נוסף על הדגל הזה, ראו הגדרה של שכפול לוגי ופענוח. ברירת המחדל היא 10.	כן
max_slot_wal_keep_size	integer 102400 ... 10485760 היחידה היא MB	לא
max_stack_depth	integer 100 ... 7680 היחידה היא KB.	לא
max_standby_archive_delay	‫integer 0 ... 2147483647 אלפיות השנייה, או -1 להמתנה ללא הגבלת זמן	לא
max_standby_streaming_delay	‫integer 0 ... 2147483647 אלפיות השנייה, או -1 להמתנה ללא הגבלת זמן	לא
max_sync_workers_per_subscription	integer 2 ... 64 לא יכול להיות גדול מ-max_logical_replication_workers.	לא
max_wal_senders	integer 10 ... varies ברירת המחדל היא 10. הערה: הערך המקסימלי של ההגדרה הזו משתנה באופן לינארי בהתאם לזיכרון שזמין במכונה. הערך הזה צריך להיות גדול או שווה לערך של max_replication_slots. נפח הזיכרון (GB) ערך מקסימלי 0 - 4 10 4 - 16 32 16 עד 32 128 32 - 64 256 64 -128 512 128 - 256 1024 256 - 512 2048 > 512 4096 למידע נוסף על הדגל הזה, קראו את המאמר הגדרת שכפול לוגי ופענוח. הערך ברפליקות חייב להיות גדול מהערך בראשי או שווה לו. שינויים במופע הראשי מועברים לרפליקות שהערך שלהן נמוך מהערך החדש במופע הראשי, או שהערך שלהן לא שונה מערך ברירת המחדל. שינויים כאלה במופע הראשי גורמים להפעלה מחדש של הרפליקה.	כן
max_wal_size	integer 2 ... 2147483647 היחידה היא 16MB (גודל קובץ ה-WAL) לגרסה 9.6, ו-1MB ל-PostgreSQL 10 ואילך. ערך ברירת המחדל הוא 1504MB אם הזיכרון של המכונה גדול מ-3.75GB או שווה לו. ערך ברירת המחדל הוא 1GB אם הזיכרון של המכונה קטן מ-3.75GB. למידע על השימוש שעשוי להשפיע על הסכם רמת השירות, קראו את ההנחיות התפעוליות למכונות של Cloud SQL ל-PostgreSQL.	לא
max_worker_processes	integer 8 ... varies הערה: הערך המקסימלי של ההגדרה הזו משתנה באופן לינארי בהתאם לזיכרון שזמין במכונה. נפח הזיכרון (GB) ערך מקסימלי מ-0 עד פחות מ-8 10 מ-8 עד פחות מ-16 16 מ-16 עד פחות מ-32 32 מ-32 עד פחות מ-64 64 מ-64 עד פחות מ-128 128 מ-128 עד < 256 256 מ-256 עד פחות מ-512 512 > 512 1024 למידע נוסף על הדגל הזה, קראו את המאמר הגדרת שכפול לוגי ופענוח. הערך ברפליקות חייב להיות גדול מהערך בראשי או שווה לו. שינויים במופע הראשי מועברים לרפליקות שהערך שלהן נמוך מהערך החדש במופע הראשי, או שהערך שלהן לא שונה מערך ברירת המחדל. שינויים כאלה במופע הראשי גורמים להפעלה מחדש של הרפליקה.	כן
min_parallel_index_scan_size	integer 0 ... 715827882 היחידה היא 8KB	לא
min_parallel_table_scan_size	integer 0 ... 715827882 היחידה היא 8KB	לא
min_parallel_relation_size	integer 0 ... 715827882 היחידה היא 8 KB נתמך רק ב-PostgreSQL 9.6.	לא
min_wal_size	integer 32 ... 2147483647 היחידה היא 16MB (גודל קובץ ה-WAL) לגרסה 9.6, ו-1MB ל-PostgreSQL 10 ואילך.	לא
old_snapshot_threshold	‫integer 0 ... 86400 דקות, או -1 כדי להשבית ערך ברירת המחדל הוא -1. הערה: ב-PostgreSQL 17, הדגל הזה הוצא משימוש.	כן
parallel_setup_cost	float 0.0 ... inf ערך ברירת המחדל הוא 1000.	לא
parallel_tuple_cost	float 0.0 ... inf ערך ברירת המחדל הוא 0.1.	לא
password_encryption	enumeration md5 | scram-sha-256 ברירת המחדל תלויה בגרסת PostgreSQL. בגרסאות 10 עד 13 של PostgreSQL, ברירת המחדל היא md5. ב-PostgreSQL מגרסה 14 ואילך, ערך ברירת המחדל הוא scram-sha-256.	לא
pg_bigm.enable_recheck	boolean on | off	לא
pg_bigm.gin_key_limit	integer 0 ... 2147483647	לא
pg_bigm.similarity_limit	float 0.0 ... 1.0	לא
pg_hint_plan.enable_hint	boolean on | off ברירת המחדל היא on.	לא
pg_hint_plan.debug_print	String off|on|detailed|verbose|0|1||2|3|no|yes|false|true ברירת המחדל היא מושבת.	לא
pg_hint_plan.parse_messages	String debug5|debug4|debug3|debug2|debug1|debug| info|notice|warning|error|log ערך ברירת המחדל הוא info.	לא
pg_hint_plan.message_level	String debug5|debug4|debug3|debug2|debug1|debug| info|notice|warning|error|log ברירת המחדל היא log.	לא
pg_hint_plan.enable_hint_table	boolean on | off ברירת המחדל היא מושבת.	לא
pglogical.batch_inserts	boolean on | off ברירת המחדל היא off. הערה: למידע על התכונה שמשתמשת בדגל הזה, ראו הגדרת שכפול לוגי ופענוח.	כן
pglogical.conflict_log_level	String ערך ברירת המחדל הוא LOG. הדגל הזה מקבל את אותם ערכים כמו log_min_messages. הערה: למידע על התכונה שמשתמשת בדגל הזה, ראו הגדרת שכפול לוגי ופענוח.	לא
pglogical.conflict_resolution	String error|apply_remote|keep_local|last_update_wins|first_update_wins ערך ברירת המחדל הוא apply_remote. הערה: כדי להשתמש בערכים keep_local,‏ last_update_wins ו-first_update_wins, צריך להפעיל את track_commit_timestamps בשני הצמתים. למידע על התכונה שמשתמשת בדגל הזה, קראו את המאמר הגדרה של רפליקציה לוגית ופענוח.	לא
pglogical.extra_connection_options	String מקבל מחרוזות חיבור של מילות מפתח/ערכים של PostgreSQL. ברירת המחדל היא מחרוזת ריקה. הערה: למידע על התכונה שמשתמשת בדגל הזה, ראו הגדרת שכפול לוגי ופענוח.	לא
pglogical.synchronous_commit	boolean on | off ברירת המחדל היא on. הערה: למידע על התכונה שמשתמשת בדגל הזה, ראו הגדרת שכפול לוגי ופענוח.	כן
pglogical.use_spi	boolean on | off ברירת המחדל היא off. הערה: למידע על התכונה שמשתמשת בדגל הזה, ראו הגדרת שכפול לוגי ופענוח.	כן
pg_stat_statements.max	integer 100 ... 2147483647 ערך ברירת המחדל הוא 5,000.	כן
pg_stat_statements.save	boolean on | off ברירת המחדל היא on.	לא
pg_stat_statements.track	enumeration none | top | all ערך ברירת המחדל הוא top.	לא
pg_stat_statements.track_planning	boolean on | off ברירת המחדל היא off. נתמך ב-PostgreSQL מגרסה 13 ואילך.	לא
pg_stat_statements.track_utility	boolean on | off ברירת המחדל היא on.	לא
pg_textsearch.bulk_load_threshold	integer מספר המונחים בכל עסקה לפני מילוי אוטומטי. כדי להשבית, צריך להגדיר את הערך כ-0. ערך ברירת המחדל הוא 100,000. נתמך ב-PostgreSQL מגרסה 17 ואילך.	לא
pg_textsearch.compress_segments	boolean on | off דחיסת בלוקים של פוסטים בפלחים חדשים. ברירת המחדל היא מופעל. נתמך ב-PostgreSQL מגרסה 17 ואילך.	לא
pg_textsearch.default_limit	integer מספר המסמכים המקסימלי שמקבלים ניקוד כשאין פסוקית LIMIT. ערך ברירת המחדל הוא 1,000. נתמך ב-PostgreSQL מגרסה 17 ואילך.	לא
pg_textsearch.memtable_pages_threshold	integer מספר הדפים שצריך לשרשר לפני שמתבצעת העברה אוטומטית. כדי להשבית את המדיניות, צריך להגדיר את הערך 0. ערך ברירת המחדל הוא 64. נתמך ב-PostgreSQL מגרסה 17 ואילך.	לא
pg_textsearch.segments_per_level	integer מספר הפלחים בכל רמה לפני שמתבצעת דחיסה אוטומטית. הטווח הוא 0-64, וברירת המחדל היא 8. נתמך ב-PostgreSQL מגרסה 17 ואילך.	לא
pgaudit.log	enumeration read | write | function | role | ddl | misc | misc_set | all|none אפשר לציין כמה כיתות באמצעות רשימה מופרדת בפסיקים, ולהחסיר כיתה על ידי הוספת הסימן - לפני הכיתה. ערך ברירת המחדל הוא none.	לא
pgaudit.log_catalog	boolean on | off ברירת המחדל היא on.	לא
pgaudit.log_client	boolean on | off ברירת המחדל היא off.	לא
pgaudit.log_level	enumeration debug5 | debug4 | debug3 | debug2 | debug1 | info | notice | warning | error | log ברירת המחדל היא log. בנוסף, המדיניות pgaudit.log_level מופעלת רק כשהמדיניות pgaudit.log_client מופעלת.	לא
pgaudit.log_parameter	boolean on | off ברירת המחדל היא off.	לא
pgaudit.log_relation	boolean on | off ברירת המחדל היא off.	לא
pgaudit.log_statement_once	boolean on | off ברירת המחדל היא off.	לא
pgaudit.role	string אין ברירת מחדל.	לא
pgaudit.log_rows	boolean התכונה מושבתת כברירת מחדל.	לא
pgtt.enabled	boolean on | off ברירת המחדל היא on.	לא
pg_wait_sampling.history_period	integer 1 ... 2147483647	לא
pg_wait_sampling.history_size	integer 1 ... 2147483647	לא
pg_wait_sampling.profile_period	integer 1 ... 2147483647	לא
pg_wait_sampling.profile_pid	boolean on | off	לא
pg_wait_sampling.profile_queries	boolean on | off	לא
random_page_cost	float 0.0 ... inf ברירת המחדל היא 4.	לא
plan_cache_mode	String auto|force_generic_plan|force_custom_plan ערך ברירת המחדל הוא auto.	לא
rdkit.agent_FP_bit_ratio	float 0 ... 3	לא
rdkit.avalon_fp_size	integer 64 ... 9192	לא
rdkit.dice_threshold	float 0 ... 1	לא
rdkit.difference_FP_weight_agents	integer -10 ... 10	לא
rdkit.difference_FP_weight_nonagents	integer 1 ... 20	לא
rdkit.do_chiral_sss	boolean on | off	לא
rdkit.do_enhanced_stereo_sss	boolean on | off	לא
rdkit.featmorgan_fp_size	integer 64 ... 9192	לא
rdkit.hashed_atompair_fp_size	integer 64 ... 9192	לא
rdkit.hashed_torsion_fp_size	integer 64 ... 9192	לא
rdkit.ignore_reaction_agents	boolean on | off	לא
rdkit.init_reaction	boolean on | off	לא
rdkit.layered_fp_size	integer 64 ... 9192	לא
rdkit.morgan_fp_size	integer 64 ... 9192	לא
rdkit.move_unmmapped_reactants_to_agents	boolean on | off	לא
rdkit.rdkit_fp_size	integer 64 ... 9192	לא
rdkit.reaction_difference_fp_size	integer 64 ... 9192	לא
rdkit.reaction_difference_fp_type	integer 1 ... 3	לא
rdkit.reaction_sss_fp_size	integer 64 ... 9192	לא
rdkit.reaction_sss_fp_type	integer 1 ... 5	לא
rdkit.sss_fp_size	integer 64 ... 4096	לא
rdkit.tanimoto_threshold	float 0 ... 1	לא
rdkit.threshold_unmapped_reactant_atoms	float 0 ... 1	לא
recovery_prefetch	string on | off | try ערך ברירת המחדל הוא try. נתמך ב-PostgreSQL מגרסה 15 ואילך.	לא
replacement_sort_tuples	integer 0 ... 2147483647 אזהרה: הדגל הזה נתמך רק עד PostgreSQL 9.6 ל-Cloud SQL.	לא
reserved_connections	integer 0 ... 262143 נתמך ב-PostgreSQL מגרסה 16 ואילך.	כן
session_replication_role	enumeration origin | replica | local אפשר להגדיר רק בסשן הנוכחי	-
seq_page_cost	float 0.0 ... inf ערך ברירת המחדל הוא 1.0.	לא
shared_buffers	integer טווח הגודל הוא בין 10% ל-60% מהזיכרון של המכונה. היחידה היא 8KB. ברירת המחדל היא שליש מנפח הזיכרון הכולל של המכונה הווירטואלית (ב-MB). לדוגמה, לזיכרון של מכונה בנפח 45GB, ערך ברירת המחדל הוא 15085MB.	כן
squeeze.max_xlock_time	integer 1 ... 2147483647	לא
squeeze.worker_autostart	string	כן
squeeze.worker_role	string	כן
ssl_max_protocol_version	‫enumeration Postgres 14: הגדרת הגרסה המקסימלית של פרוטוקול SSL/TLS לשימוש. הערכים התקינים זהים לאלה של ssl_min_protocol_version, בתוספת מחרוזת ריקה, שמאפשרת לציין כל גרסת פרוטוקול. נתמך ב-PostgreSQL מגרסה 12 ואילך.	לא
ssl_min_protocol_version	‫enumeration Postgres 14: הגדרת הגרסה המינימלית של פרוטוקול SSL/TLS לשימוש. הערכים התקינים כרגע הם: TLSv1, TLSv1.1, TLSv1.2, TLSv1.3. ערך ברירת המחדל הוא TLSv1. נתמך ב-PostgreSQL מגרסה 12 ואילך.	לא
standard_conforming_strings	boolean on | off ברירת המחדל היא on.	לא
synchronize_seqscans	boolean on | off ברירת המחדל היא on.	לא
tcp_keepalives_count	integer 0 ... 2147483647 ברירת המחדל היא 5.	לא
tcp_keepalives_idle	integer 0 ... 2147483647 ערך ברירת המחדל הוא 60.	לא
tcp_keepalives_interval	integer 0 ... 2147483647 ערך ברירת המחדל הוא 60.	לא
temp_buffers	integer 100 ... 1,073,741,823 היחידה היא 8KB	לא
temp_file_limit	integer 1048576 ... 2147483647 KB ברירת המחדל היא 10% מגודל הדיסק הראשוני. לדוגמה, בדיסק של 100GB, ערך ברירת המחדל הוא 10262623KB.	לא
TimeZone	string הדגל הזה מאפשר למשתמשי Cloud SQL ל-PostgreSQL להגדיר את אזור הזמן להצגה ולניתוח של חותמות זמן. אתם מציינים את אזורי הזמן לפי השם שלהם. לדוגמה, Europe/London הוא השם של אזור הזמן של לונדון. כדי להביא זאת בחשבון, צריך לעדכן את הדגל הזה באופן ידני במכונה הראשית ובכל הרפליקות לקריאה בלבד. שמות של אזורי זמן הם לא תלויי-רישיות. אפשר לציין את שם אזור הזמן בכל אותיות רישיות או קטנות. אנחנו תומכים ב-UTC+X כפורמט תקין לדגל הזה, כאשר X הוא +/-HH. בשלב הזה אנחנו לא תומכים במפרטים של אזורי זמן ב-POSIX.	כן
trace_notify	boolean on | off ברירת המחדל היא off.	לא
trace_recovery_messages	enumeration debug5 | debug4 | debug3 | debug2 | debug1 | log | notice | warning | error ערך ברירת המחדל הוא log. הערה: ב-PostgreSQL 17, הדגל הזה הוצא משימוש.	לא
trace_sort	boolean on | off ברירת המחדל היא off.	לא
track_activities	boolean on | off ברירת המחדל היא on.	לא
track_activity_query_size	integer 100 ... 102400 ערך ברירת המחדל הוא 1KB.	כן
track_commit_timestamp	boolean on | off ברירת המחדל היא off.	כן
track_cost_delay_timing	boolean on | off ברירת המחדל היא off. נתמך ב-PostgreSQL מגרסה 18 ואילך.	לא
track_counts	boolean on | off ברירת המחדל היא on.	לא
track_functions	enumeration none | pl | all ברירת המחדל היא none.	לא
track_io_timing	boolean on | off ברירת המחדל היא off.	לא
vacuum_cost_delay	integer 0 ... 100 אלפיות השנייה ברירת המחדל היא 0.	לא
vacuum_cost_limit	integer 1 ... 10000 ברירת המחדל היא 200.	לא
vacuum_cost_page_dirty	integer 0 ... 10000 ברירת המחדל היא 20.	לא
vacuum_cost_page_hit	integer 0 ... 10000 ברירת המחדל היא 1.	לא
vacuum_cost_page_miss	integer 0 ... 10000 ערך ברירת המחדל הוא 10.	לא
vacuum_failsafe_age	integer 0 ... 2100000000 ערך ברירת המחדל הוא 1600000000.	לא
vacuum_freeze_min_age	integer 0 ... 1000000000 ערך ברירת המחדל הוא 50000000.	לא
vacuum_freeze_table_age	integer 0 ... 2000000000 ערך ברירת המחדל הוא 150000000.	לא
vacuum_max_eager_freeze_failure_rate	float 0 ... 1 ברירת המחדל היא 0.03. נתמך ב-PostgreSQL מגרסה 18 ואילך.	לא
vacuum_multixact_failsafe_age	integer 0 ... 2100000000 ערך ברירת המחדל הוא 1600000000.	לא
vacuum_multixact_freeze_min_age	integer 0 ... 1000000000 ערך ברירת המחדל הוא 5000000.	לא
vacuum_multixact_freeze_table_age	integer 0 ... 2000000000 ערך ברירת המחדל הוא 150000000.	לא
vacuum_truncate	boolean on | off ברירת המחדל היא on. נתמך ב-PostgreSQL מגרסה 18 ואילך.	לא
wal_buffers	integer טווח הגודל הוא בין ‎-1 ל-5% מהזיכרון של המכונה. היחידה היא 8KB. ברירת המחדל היא 16MB.	כן
wal_compression	enumeration off | on | pglz | lz4 | zstd ערך ברירת המחדל הוא off במכונות של Cloud SQL Enterprise ובמכונות של Cloud SQL Enterprise Plus עם 32 מעבדי vCPU או פחות. במכונות של Cloud SQL Enterprise Plus עם יותר מ-32 מעבדי vCPU ב-PostgreSQL מגרסה 14 ואילך, ברירת המחדל היא on. הערה: הערכים pglz,‏ lz4 ו-zstd נתמכים רק בגרסאות 15 ואילך של PostgreSQL. הערה: במכונות גדולות של Cloud SQL Enterprise Plus עם יותר מ-32 מעבדי vCPU, הגדרת wal_compression ל-on מפחיתה את נפח ה-WAL, אבל יכולה להשפיע על פעולות תחזוקה עם שרשור יחיד כמו VACUUM FULL. כדי לשפר את ביצועי התחזוקה של עומסי העבודה האלה, אפשר להגדיר את wal_compression ל-off.	לא
wal_decode_buffer_size	integer 65536 ... 1073741823 היחידה היא B. נתמך ב-PostgreSQL מגרסה 15 ואילך.	כן
wal_receiver_timeout	integer 0 ... 2147483647 ערך ברירת המחדל הוא 60 שניות. הדגל הזה משפיע על השולח והמקבל של WAL. אם הדגל הזה לא מוגדר כראוי, הוא משפיע על הרפליקציה הלוגית והפיזית. הדגל הזה משפיע גם על הביצועים וזמן האחזור של הרפליקציה. ערך של אפס משבית את מנגנון הזמן הקצוב לתפוגה. היחידה היא אלפיות השנייה.	לא
wal_sender_timeout	integer 0 ... 2147483647 ערך ברירת המחדל הוא 60 שניות. הדגל הזה משפיע על השולח והמקבל של WAL. אם הדגל הזה לא מוגדר כראוי, הוא משפיע על הרפליקציה הלוגית והפיזית. הדגל הזה משפיע גם על הביצועים וזמן האחזור של הרפליקציה. ערך של אפס משבית את מנגנון הזמן הקצוב לתפוגה. היחידה היא אלפיות השנייה.	לא
wal_writer_delay	integer 1 ... 10000 ברירת המחדל היא 200.	לא
wal_writer_flush_after	integer 0 ... 2147483647 ערך ברירת המחדל הוא 128.	לא
work_mem	integer 64 ... 2147483647 KB ברירת המחדל היא 4 MB.	לא

סימונים מיוחדים

bgwriter

ל-PostgreSQL יש דגל של כותב ברקע (bgwriter). הדגל הזה מנפיק כתיבות של מאגרי נתונים זמניים משותפים חדשים או ששונו. מאגרי הנתונים הזמניים המשותפים האלה נקראים מאגרי נתונים זמניים מלוכלכים. כשאין מספיק מאגרי נתונים זמניים משותפים נקיים, כותב הרקע כותב מאגרי נתונים זמניים מלוכלכים למערכת הקבצים ומסמן אותם כנקיים.

שני דגלים שמשויכים לדגל bgwriter הם bgwriter_delay ו-bgwriter_lru_maxpages. הערך bgwriter_delay מציין את ההשהיה בין סבבי הפעילות של כותב הרקע באלפיות השנייה (ms), והערך bgwriter_lru_maxpages מציין כמה מאגרים ייכתבו על ידי כותב הרקע.

ערך ברירת המחדל של הדגל bgwriter הוא 200 ms. עם זאת, אם בוחרים כונן SSD שגדול מ-500GB, הערך של הדגל bgwriter_delay מוגדר ל-50 והערך של הדגל bgwriter_lru_maxpages מוגדר ל-200.

למידע נוסף על כותב הרקע, עיינו במסמכי התיעוד של PostgreSQL.

cloudsql_session_read_only

אפשר להשתמש בדגל cloudsql_session_read_only כדי ליצור סשן לקריאה בלבד.

אפשר להגדיר את הדגל הזה לערכים on,‏ off או locked. ערך ברירת המחדל הוא off.

הערה: הדגל הזה ספציפי ל-Cloud SQL. זה לא דגל של PostgreSQL.

session_replication_role

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

לפעמים אפשר להשתמש בדגל הזה גם לפעולות תחזוקה מסוימות כדי לעקוף בדיקות של אילוצים (לרוב מפתח זר).

כל משתמש שהמאפיין REPLICATION מוגדר אצלו יכול להגדיר את הדגל הזה בסשן. אפשר להגדיר את המאפיין REPLICATION לכל משתמש באמצעות cloudsqlsuperuser כשאחד מהדגלים cloudsql.enable_pglogical או cloudsql.logical_decoding מוגדר למכונה.

אי אפשר להגדיר את הדגל הזה לכל המכונה.

פתרון בעיות

שגיאה

פתרון בעיות

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

מתחברים למסד הנתונים ומגדירים את אזור הזמן של מסד הנתונים לאזור הזמן הרצוי, לכל משתמש או לכל מסד נתונים. ב-Cloud SQL ל-PostgreSQL, אפשר לציין את הפרטים הבאים. ההגדרות האלה נשמרות אחרי שסוגרים את הסשן, בדומה להגדרה של .conf: ALTER DATABASE dbname SET TIMEZONE TO 'timezone'; ALTER USER username SET TIMEZONE TO 'timezone'; ההגדרות האלה חלות רק על חיבורים חדשים למסד הנתונים. כדי לראות את השינוי באזור הזמן, מתנתקים מהמכונה ומתחברים אליה מחדש.

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

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