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

בוחרים גרסה של מאמר העזרה:

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

אם אתם מנהלים את תשתית מתזמן ה-RPM של AlloyDB Omni ישירות באמצעות 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"

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

  • ‫DEPLOYMENT_SPECIFICATION: הנתיב למפרט הפריסה שיצרתם בקטע התקנת רכיבי AlloyDB Omni.

  • ‫DBCLUSTER_SPECIFICATION: הנתיב למפרט האשכול.

alloydbctl 

alloydbctl apply -d DEPLOYMENT_SPECIFICATION -r DBCLUSTER_SPECIFICATION

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

  • ‫DEPLOYMENT_SPECIFICATION: הנתיב למפרט הפריסה שיצרתם בקטע התקנת רכיבי AlloyDB Omni.

  • ‫DBCLUSTER_SPECIFICATION: הנתיב למפרט האשכול.

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

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

SHOW PARAMETER_NAME;

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