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

בחירת גרסת תיעוד:

בדף הזה מוסבר איך להגדיר פרמטרים של מסד נתונים באמצעות כלי הניהול של AlloyDB Omni RPM.

פרמטרים של מסד נתונים, שנקראים גם פרמטרים של Grand Unified Configuration‏ (GUC), מאפשרים לכם לשפר את הביצועים וההתנהגות של אשכול מסד הנתונים של AlloyDB Omni. מידע נוסף מופיע בקטע הגדרת פרמטרים במסמכי התיעוד של PostgreSQL.

לפני שמתחילים

לפני שאתם מגדירים את הפרמטרים של מסד הנתונים, ודאו שיש לכם:

  1. התקנתם את התזמור ב-AlloyDB Omni.
  2. הקצאתם ויצרתם את אשכול AlloyDB Omni.

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

כדי להגדיר פרמטרים של מסד נתונים, משתמשים בשדה parameters בקטע primarySpec של מפרט המשאבים DBCluster.

עדכון מפרט המשאב

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

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

DBCluster:
  metadata:
    name: CLUSTER_NAME
  spec:
    primarySpec:
      # ... other settings ...
      parameters:
        # ... existing parameters ...
        max_wal_size: "MAX_WAL_SIZE"
        max_connections: "MAX_CONNECTIONS_LIMIT"
        huge_pages: "HUGE_PAGES"
        log_statement: "LOG_STATEMENT"
        # ... other parameters ...

מחליפים את מה שכתוב בשדות הבאים:

  • ‫CLUSTER_NAME: השם של אשכול מסד הנתונים.
  • ‫MAX_WAL_SIZE: פרמטר לדוגמה שקובע את הגודל המקסימלי שאליו ה-WAL יכול לגדול בין נקודות ביקורת אוטומטיות של WAL, לדוגמה 2GB.
  • ‫MAX_CONNECTIONS_LIMIT: פרמטר לדוגמה ששולט במספר המקסימלי של חיבורים בו-זמניים שמותרים לשרת מסד הנתונים, לדוגמה 200. הערך המינימלי הנתמך הוא 50.
  • ‫HUGE_PAGES: פרמטר לדוגמה שקובע את השימוש בדפים גדולים, לדוגמה on.
  • ‫LOG_STATEMENT: פרמטר לדוגמה שקובע אילו הצהרות SQL יתועדו, לדוגמה all.

שימוש בתצורה

מחילים את השינויים באמצעות ממשק התזמור המועדף.

Ansible

אם אתם מנהלים את תשתית התזמור של AlloyDB Omni RPM ישירות באמצעות Ansible, היא מפעילה עדכונים על ידי הפעלת ה-playbook המתאים והעברת ה-update_action שנבחר כמשתנה נוסף.

קובץ לדוגמה של update.yml:

---
- hosts: localhost
  vars:
    update_action: "update_resource_spec"
    ansible_user: your_ssh_user
    ansible_ssh_private_key_file: ~/path/to/private-key
  roles:
    - role: google.alloydbomni_orchestrator.update

מריצים את הפקודה של Ansible:

ansible-playbook -i DEPLOYMENT_SPECIFICATION update.yml -e resource_spec="DBCLUSTER_SPECIFICATION"

מחליפים את המשתנים הבאים:

alloydbctl 

alloydbctl apply -d DEPLOYMENT_SPECIFICATION -r DBCLUSTER_SPECIFICATION

מחליפים את המשתנים הבאים:

אימות שינויים בפרמטרים

אחרי החלת ההגדרות, אפשר לוודא שהפרמטרים עודכנו באמצעות הפקודה SHOW ב-psql:

SHOW PARAMETER_NAME;

מחליפים את PARAMETER_NAME בשם הפרמטר שהגדרתם.