בדף הזה מוסבר איך להפעיל את AlloyDB Omni ולהתחבר אליו אחרי שמתקינים אותו במחשב.
לפני שמתחילים
רוב הפקודות בדף הזה משתמשות ב-AlloyDB Omni CLI.
כדי להתקין את כלי שורת הפקודה הזה במכונה, קראו את המאמר התקנת AlloyDB Omni CLI.
הפעלת AlloyDB Omni
ההליכים להרצת AlloyDB Omni תלויים בשאלה אם אתם מריצים את AlloyDB Omni בקונטיינר בשרת יחיד.
ההתקנה של AlloyDB Omni מגדירה שירות מערכת בשם alloydb-dataplane, שמוגדר להפעלה בכל פעם שהמכונה מופעלת.
כדי לשלוט ב-AlloyDB Omni ולעקוב אחריו, משתמשים בפקודה sudo alloydb, כמו שמוסבר בקטעים הבאים.
הפעלת AlloyDB Omni
sudo alloydb database-server startכדי לבצע חיבור לבדיקה, ראו חיבור באמצעות psql בקונטיינר.
בדיקת הסטטוס של AlloyDB Omni
sudo alloydb database-server statusעצירת AlloyDB Omni
sudo alloydb database-server stopהשבתת ההפעלה בזמן האתחול
הפקודה הבאה מונעת מ-AlloyDB Omni לפעול באופן אוטומטי כשהמכונה מופעלת.
sudo systemctl disable alloydb-dataplaneהפעלה מחדש של ההפעלה בזמן ההפעלה
sudo systemctl enable alloydb-dataplaneהתחברות ל-AlloyDB Omni שפועל בשרת יחיד
הקונטיינר של AlloyDB Omni כולל עותק משלו של psql, שמאפשר לפתוח סשן אינטראקטיבי של מעטפת SQL עם שרת מסד הנתונים שלו.
אפשר גם להתחבר ל-AlloyDB Omni מחוץ לקונטיינר, באמצעות תוכנה שתואמת ל-PostgreSQL לפי בחירתכם.
התחברות באמצעות psql בקונטיינר
כדי להתחבר לשרת של מסד הנתונים של AlloyDB Omni באמצעות עותק של psql בקונטיינר, מריצים את הפקודה הבאה:
שרת יחיד
docker exec -it pg-service psql -h localhost -U postgresהפקודה הזו מחברת אתכם לשרת בתור תפקיד המשתמש postgres ומציגה שורת פקודה postgres=#. עכשיו אפשר להריץ פקודות של psql ושאילתות SQL.
כדי לצאת מ-psql, מריצים את הפקודה \q.
חיבור באמצעות אפליקציות משלכם
כל אפליקציה שעובדת עם PostgreSQL יכולה לעבוד גם עם AlloyDB Omni, בלי צורך בשינויים.
כדי להתחבר לשרת של מסד הנתונים AlloyDB Omni, אתם יכולים להשתמש בכל לקוח או ספריית קוד שתואמים ל-PostgreSQL כדי להתחבר ליציאה 5432 – יציאת ברירת המחדל של שרת מסד הנתונים PostgreSQL – של המכונה שבה פועל AlloyDB Omni.
זה עובד כי הקונטיינר של AlloyDB Omni חושף את היציאה שלו, 5432, לאותה יציאה של המכונה שבה הוא פועל.
אחרי שמתחברים לשרת מסד הנתונים, אפשר להגדיר, לשלוח שאילתות ולשנות את מסדי הנתונים באמצעות שאילתות DML ושאילתות SQL, באמצעות פרוטוקולי תקשורת סטנדרטיים של PostgreSQL.
מכיוון ש-AlloyDB Omni פועל בסביבה שלכם, אתם יכולים לשלוט באופן החיבור ל-AlloyDB Omni. זה כולל מתן גישה לרשת לשירות הזה או הגבלת הגישה אליו בהתאם לצרכים של האפליקציה, בדיוק כמו שהייתם עושים עם שרת PostgreSQL רגיל.