הרצה של AlloyDB Omni וחיבור אליו באמצעות RPM

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

בדף הזה מוסבר איך להפעיל את AlloyDB Omni ולהתחבר אליו אחרי שמתקינים אותו במחשב.

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

מתקינים את AlloyDB Omni במערכת.

הפעלת AlloyDB Omni

כדי להפעיל את AlloyDB Omni, לבדוק את הסטטוס שלו ולעצור אותו, אתם יכולים להשתמש במידע שבקטעים הבאים.

אופציונלי: עדכון כללי המדיניות של SELinux

אם SELinux מופעל במערכת שלכם ואתם משנים פרמטרים מסוימים של Grand Unified Configuration‏ (GUC) בקובץ postgresql.conf, אתם צריכים לעדכן את כללי המדיניות של SELinux לפני שאתם מפעילים את שירות AlloyDB Omni. עדכון כללי המדיניות האלה מונע דחייה של גישה למשאבים, שעלולה לגרום לכך ששרת מסד הנתונים לא יהיה זמין או לשבש פעולות כמו גיבויים.

כדי להריץ את הפקודות semanage ו-restorecon, צריך את החבילה policycoreutils-python-utils.

בטבלה הבאה מפורטים הפרמטרים של GUC שצריך לעדכן את מדיניות SELinux כשמשנים אותם מערכי ברירת המחדל שלהם:

פרמטר GUC סוג המשאב ההשפעה אם מדיניות SELinux לא מעודכנת רזולוציה
port יציאה שרת מסד הנתונים לא מופעל ואי אפשר להשתמש בו. מקצים את התווית postgresql_port_t ליציאת ה-TCP בהתאמה אישית.
external_pid_file קובץ שרת מסד הנתונים נשאר זמין, אבל SELinux מונע גישה ליצירת קובץ ה-PID החיצוני מחוץ ל-/var/run/postgresql/. מקצים את התווית postgresql_db_t לספריית הקבצים המותאמת אישית של ה-PID.
unix_socket_directories קובץ שרת מסד הנתונים לא מצליח ליצור את קובץ השקע והוא לא זמין. מקצים את התווית postgresql_db_t לספריית שקע Unix בהתאמה אישית.
log_directory קובץ שרת מסד הנתונים לא מצליח לכתוב יומנים והופך ללא זמין. מקצים את התווית postgresql_db_t לספריית היומנים בהתאמה אישית.
archive_command קובץ שרת מסד הנתונים נשאר זמין, אבל SELinux מונע גישת כתיבה לספריית היעד, מה שעלול לשבש את הגיבוי ואת ההעברה לארכיון של יומן הכתיבה מראש (WAL). מקצים את התווית postgresql_db_t לספריית הארכיון המותאמת אישית.

עדכון מדיניות SELinux ליציאה בהתאמה אישית

אם משנים את הפרמטר port בקובץ postgresql.conf, צריך להריץ את הפקודות הבאות כדי לאפשר ל-AlloyDB Omni להתחבר ליציאת ה-TCP בהתאמה אישית:

  1. מוסיפים את התווית postgresql_port_t ליציאה המותאמת אישית:

    sudo /usr/sbin/semanage port -a -t postgresql_port_t -p tcp PORT_NUMBER

    מחליפים את PORT_NUMBER במספר יציאת ה-TCP בהתאמה אישית, לדוגמה 5433.

  2. מוודאים שמדיניות היציאות מעודכנת:

    sudo /usr/sbin/semanage port -l | grep postgresql_port_t

עדכון מדיניות SELinux לספרייה בהתאמה אישית

אם משנים את הפרמטר external_pid_file,‏ unix_socket_directories,‏ log_directory או archive_command בקובץ postgresql.conf כדי להשתמש בספרייה בהתאמה אישית, צריך להריץ את הפקודות הבאות כדי להחיל את ההקשר של postgresql_db_t על הספרייה הזו:

sudo /usr/sbin/semanage fcontext -a -t postgresql_db_t "DIRECTORY_PATH(/.*)?"
sudo /sbin/restorecon -R -F DIRECTORY_PATH

מחליפים את DIRECTORY_PATH בנתיב המלא לספריית קובצי ה-PID בהתאמה אישית, לספריית שקעי Unix, לספריית היומנים או לספריית ארכיון ה-WAL.

הפעלת AlloyDB Omni

  sudo systemctl start alloydbomni18

אופציונלי: הפעלה אוטומטית מחדש של השירות

כדי להפעיל מחדש באופן אוטומטי את שירות AlloyDB Omni:

  1. מוסיפים את ההגדרות הבאות לקובץ /etc/systemd/system/alloydbomni18.service.d/override.conf.

      [Service]
    Restart=on-failure

  2. כדי שהשינויים ייכנסו לתוקף, טוענים מחדש את ההגדרות של מנהל systemd ומפעילים מחדש את השירות alloydbomni18.

    sudo systemctl daemon-reload
sudo systemctl restart alloydbomni18

בדיקת הסטטוס של AlloyDB Omni

   sudo systemctl status alloydbomni18

עצירת AlloyDB Omni

  sudo systemctl stop alloydbomni18

התחברות ל-AlloyDB Omni

חבילת AlloyDB Omni RPM כוללת גם את לקוח psql שמאפשר לפתוח סשן אינטראקטיבי של מעטפת SQL עם שרת מסד הנתונים.

אתם יכולים גם להתחבר ל-AlloyDB Omni באמצעות תוכנה תואמת ל-PostgreSQL לבחירתכם.

התחברות באמצעות psql מקובץ

  /usr/lib/postgresql/18/bin/psql -h localhost -U postgres

הפקודה הזו מחברת אתכם לשרת בתפקיד המשתמש postgres, ומציגה את שורת הפקודה postgres=#. עכשיו אפשר להריץ פקודות psql ושאילתות SQL.

כדי לצאת מ-psql, מריצים את הפקודה \q.

חיבור באמצעות אפליקציות משלכם

כל אפליקציית לקוח שעובדת עם PostgreSQL יכולה לעבוד גם עם AlloyDB Omni, בלי צורך בשינויים.

אתם יכולים להשתמש בכל לקוח או ספריית קוד שתואמים ל-PostgreSQL כדי להתחבר ל-AlloyDB Omni.

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

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

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