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

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

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

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

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

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

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

המסוף

  1. בGoogle Cloud מסוף, בוחרים את הפרויקט שמכיל את מופע Cloud SQL שרוצים להגדיר לו דגל מסד נתונים.
  2. פותחים את המופע ולוחצים על עריכה.
  3. עוברים לקטע דגלים.
  4. כדי להגדיר דגל שלא הוגדר במופע לפני כן, לוחצים על הוספת פריט, בוחרים את הדגל מהתפריט הנפתח ומגדירים את הערך שלו.
  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. מגדירים את פרויקט ברירת המחדל שבו רוצים להחיל את ההגדרות של Terraform. Google Cloud

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

    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.

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

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

  1. כדי להשבית את ההגנה מפני מחיקה, בקובץ התצורה של Terraform מגדירים את הארגומנט deletion_protection לערך false.
    deletion_protection =  "false"
  2. מריצים את הפקודה הבאה ומזינים yes בהודעה שמופיעה, כדי להחיל את הגדרות Terraform המעודכנות:
    terraform apply
  1. כדי להסיר משאבים שהוחלו בעבר על הגדרות 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"
      }
    ]
  }
}

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

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

אם יש דגלים קיימים שהוגדרו עבור מסד הנתונים, צריך לשנות את הפקודה הקודמת כדי לכלול אותם. הפקודה 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"
      }
    ]
  }
}

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

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

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

ניקוי כל הדגלים לערכי ברירת המחדל

המסוף

  1. בGoogle Cloud מסוף, בוחרים את הפרויקט שמכיל את מופע Cloud SQL שרוצים לנקות את כל הדגלים שלו.
  2. פותחים את המופע ולוחצים על עריכה.
  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": []
  }
}

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

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

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": []
  }
}

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

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

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

כדי לראות את כל הערכים הנוכחיים של הגדרות 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

בפלט, סימוני מסד הנתונים מפורטים בקטע settings כאוסף databaseFlags. מידע נוסף על אופן הצגת הדגלים בפלט זמין במאמר Instances Resource Representation.

REST v1

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

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

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

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

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

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

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

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

REST v1beta4

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

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

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

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

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

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

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

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

סימונים נתמכים

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

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

A | C | D | E | F | G | H | I | J | L | M | O | P | R | S | T | V | W

דגל Cloud SQL סוג
ערכים קבילים והערות
נדרשת הפעלה מחדש?
anon.algorithm String
ברירת המחדל היא sha256.
לא
anon.maskschema String
ברירת המחדל היא mask.
לא
anon.restrict_to_trusted_schemas boolean
on | off
ברירת המחדל היא off.
לא
anon.salt String
אין ערך ברירת מחדל.
לא
anon.sourceschema String
ברירת המחדל היא public.
לא
auto_explain.log_analyze boolean
on | off
ברירת המחדל היא off.
לא
auto_explain.log_buffers boolean
on | off
ברירת המחדל היא 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
ברירת המחדל היא 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
ברירת המחדל היא off.
לא
auto_explain.log_wal boolean
on | off
ברירת המחדל היא off.
נתמך ב-PostgreSQL 13 ואילך.
לא
auto_explain.log_verbose boolean
on | off
ברירת המחדל היא off.
לא
auto_explain.sample_rate Float
0 ... 1
ברירת המחדל היא 1.
לא
autovacuum boolean
on | off
ברירת המחדל היא on.
מידע על שימוש שעשוי להשפיע על הסכם רמת השירות מופיע בהנחיות התפעול למופעי 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.
כן
autovacuum_multixact_freeze_max_age integer
10000 ... 2000000000
ברירת המחדל היא 400000000.
מידע על שימוש שעשוי להשפיע על הסכם רמת השירות מופיע בהנחיות התפעול למופעי Cloud SQL ל-PostgreSQL.
כן
autovacuum_naptime integer
1 ... 2147483s ‫
ברירת המחדל היא 60 שניות.
לא
autovacuum_vacuum_cost_delay integer
0 ... 100 ms, or -1 to use the vacuum_cost_delay value
For PostgreSQL 9.6, 10, and 11, the default value is 2 ms.
לא
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
ברירת המחדל היא 30s.
לא
client_connection_check_interval integer
0 ... 2147483647
ברירת המחדל היא 0.
לא
cloudsql.allow_passwordless_local_connections boolean
on | off
ברירת המחדל היא off.
לא
cloudsql.enable_anon boolean
on | off
ברירת המחדל היא off.
לא
cloudsql.enable_auto_explain boolean
on | off
ברירת המחדל היא off.
כן
cloudsql.enable_index_advisor boolean
on | off
ברירת המחדל היא off.
כן
cloudsql.enable_maintenance_mode boolean
on | off
ברירת המחדל היא off.
כן
cloudsql.enable_pgaudit boolean
on | off
ברירת המחדל היא off.
כן
cloudsql.enable_pg_bigm boolean
on | off
default: off
כן
cloudsql.enable_pg_cron boolean
on | off
ברירת המחדל היא off.
נתמך ב-PostgreSQL 10 ומעלה.
כן
cloudsql.enable_pg_hint_plan boolean
on | off
ברירת המחדל היא off.
כן
cloudsql.enable_pglogical boolean
on | off
ברירת המחדל היא off.
כן
cloudsql.enable_pg_squeeze boolean
on | off
ברירת המחדל היא off.
כן
cloudsql.enable_pg_wait_sampling boolean
on | off
כן
cloudsql.enable_vector_assist boolean
on | off
ברירת המחדל היא off.
כן
cloudsql.iam_authentication boolean
on | off
ברירת המחדל היא off.
לא
cloudsql.logical_decoding boolean
on | off
ברירת המחדל היא off.
כן
cloudsql.max_failed_attempts_user integer
0 ... 10000
ברירת המחדל היא 10.
כן
cloudsql.pg_authid_select_role string
לא
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
ברירת המחדל היא on.
נתמך ב-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_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% מזיכרון המכונה הווירטואלית. לדוגמה, אם הזיכרון של מופע הוא 45GB, ערך ברירת המחדל הוא 18537160 KB.
לא
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
ברירת המחדל היא on.
לא
enable_incremental_sort boolean
on | off
ברירת המחדל היא on.
לא
enable_memoize boolean
on | off
ברירת המחדל היא on.
לא
enable_parallel_append boolean
on | off
ברירת המחדל היא on.
לא
enable_parallel_hash boolean
on | off
ברירת המחדל היא on.
לא
enable_partition_pruning boolean
on | off
ברירת המחדל היא on.
לא
enable_partitionwise_aggregate boolean
on | off
ברירת המחדל היא off.
לא
enable_partitionwise_join boolean
on | off
ברירת המחדל היא 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
ברירת המחדל היא on
לא
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.
לא
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 ms
ברירת המחדל היא 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 ms
ברירת המחדל היא 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 ms
ברירת המחדל היא ‎-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_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.
לא
log_statement_stats boolean
on | off
אסור להפעיל את התכונה הזו יחד עם log_parser_stats,‏ log_planner_stats או log_executor_stats.
ברירת המחדל היא מושבת.
לא
log_temp_files integer
0 ... 2147483647 KB, או -1 כדי להשבית ברירת המחדל היא 0.
לא
log_timezone string
הדגל הזה מאפשר למשתמשי Cloud SQL ל-PostgreSQL להגדיר את אזור הזמן שמשמש לחותמות זמן שנכתבות ביומן השרת.

מציינים את אזורי הזמן לפי שם. לדוגמה, Europe/London הוא שם אזור הזמן של לונדון.

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

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

אנחנו תומכים בפורמט UTC+X כפורמט תקין לסימון הזה, כאשר X הוא +/-HH:MM.

כן
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 עד < 6100
מ-6 עד < 7.5200
‫7.5 עד < 15400
‫15 עד < 30500
‫30 עד < 60600
‫60 עד < 120800
‫‎>=1201,000

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

כן
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
ברירת המחדל היא 2.
נתמך ב-PostgreSQL 11 ואילך.

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

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

לא
max_parallel_workers integer
0 ... varies
ערך ברירת המחדל הוא 8.
נתמך ב-PostgreSQL 10 ומעלה.

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

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

לא
max_parallel_workers_per_gather integer
0 ... varies
ברירת המחדל היא 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
כן
max_prepared_transactions integer
0 ... varies
גודל הזיכרון (MB)ערך מקסימלי
‫0 – 3,84030,000
‫3,840 - 7,68085,000
‫7,680 - 15,360200,000
‫15,360 ואילך262,000

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

כן
max_replication_slots integer
10 ... varies
ברירת המחדל היא 10.
כן
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_wal_size integer
2 ... 2147483647

היחידה היא 16MB (גודל קובץ ה-WAL) בגרסה 9.6 ו-1MB ב-PostgreSQL 10 ואילך.

ערך ברירת המחדל הוא 1504 MB אם זיכרון המופע גדול מ-3.75 GB או שווה לו. ערך ברירת המחדל הוא 1 GB אם זיכרון המופע קטן מ-3.75 GB.

מידע על שימוש שעשוי להשפיע על הסכם רמת השירות מופיע במאמר הנחיות תפעוליות למופעי Cloud SQL ל-PostgreSQL.
לא
max_worker_processes integer
8 ... varies

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

כן
min_parallel_index_scan_size integer
0 ... 715827882
היחידה היא 8 KB
לא
min_parallel_table_scan_size integer
0 ... 715827882
היחידה היא 8 KB
לא
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.
כן
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. ב-PostgreSQL בגרסאות 10 עד 13, ברירת המחדל היא 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
ברירת המחדל היא off.
לא
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
ברירת המחדל היא 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.
לא
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
ברירת המחדל היא 5000.
כן
pg_stat_statements.save boolean
on | off
ברירת המחדל היא on.
לא
pg_stat_statements.track enumeration
none | top | all
ברירת המחדל היא top.
לא
pg_stat_statements.track_utility boolean
on | off
ברירת המחדל היא on.
לא
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
לא
replacement_sort_tuples integer
0 ... 2147483647
לא
session_replication_role enumeration
origin | replica | local
אפשר להגדיר רק בסשן הנוכחי
-
seq_page_cost float
0.0 ... inf
ברירת המחדל היא 1.0.
לא
shared_buffers integer
טווח הגודל הוא 10% עד 60% מהזיכרון של המופע.
היחידה היא ‎8KB.
ברירת המחדל היא שליש מנפח הזיכרון הכולל של מכונת ה-VM (ב-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.

כן
trace_notify boolean
on | off
ברירת המחדל היא off.
לא
trace_recovery_messages enumeration
debug5 | debug4 | debug3 | debug2 | debug1 | log | notice | warning | error
ברירת המחדל היא log.
לא
trace_sort boolean
on | off
ברירת המחדל היא off.
לא
track_activities boolean
on | off
ברירת המחדל היא on.
לא
track_activity_query_size integer
100 ... 102400
ברירת המחדל היא 1 KB.
כן
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 ms
ברירת המחדל היא 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.
לא
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.

מידע נוסף על background writer זמין במסמכי העזרה של 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';

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

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