הפעלה והתחברות ל-AlloyDB Omni

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

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

הפעלת AlloyDB Omni

התהליכים שבהם משתמשים כדי להריץ את AlloyDB Omni תלויים בשאלה אם מריצים את AlloyDB Omni בקונטיינר בשרת יחיד.

הפעלת AlloyDB Omni

כדי להפעיל קונטיינר של AlloyDB Omni שהופסק, מריצים את הפקודה docker container start או את הפקודה podman container start:

Docker

docker container start CONTAINER_NAME

מחליפים את CONTAINER_NAME בשם שהקציתם לקונטיינר של AlloyDB Omni כשהתקנתם אותו.

Podman

podman container start CONTAINER_NAME

מחליפים את CONTAINER_NAME בשם שהקציתם לקונטיינר של AlloyDB Omni כשהתקנתם אותו.

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

כדי לבדוק את הסטטוס של כל הקונטיינרים שפועלים, מריצים את הפקודה docker container ls או את הפקודה podman container ls:

Docker

docker container ls

Podman

podman container ls

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

אם שם הקונטיינר לא מופיע בעמודה NAMES, סימן ש-AlloyDB Omni לא פועל.

עצירת AlloyDB Omni

כדי לעצור קונטיינר של AlloyDB Omni, מריצים את הפקודה docker container stop או את הפקודה podman container stop:

Docker

  docker container stop CONTAINER_NAME

מחליפים את CONTAINER_NAME בשם שהקציתם לקונטיינר של AlloyDB Omni כשהתקנתם אותו.

Podman

  podman container stop CONTAINER_NAME

מחליפים את CONTAINER_NAME בשם שהקציתם לקונטיינר AlloyDB Omni כשהתקנתם אותו.

התחברות ל-AlloyDB Omni שפועל בשרת יחיד

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

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

במאמר התחברות ל-AlloyDB Omni שפועל ב-Kubernetes מוסבר איך מתחברים לאשכול של מסד נתונים ב-AlloyDB Omni שפועל באשכול של Kubernetes.

חיבור באמצעות psql מבוסס-קונטיינר

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

Docker

  docker exec -it CONTAINER_NAME psql -U postgres

מחליפים את CONTAINER_NAME בשם שהקציתם לקונטיינר של AlloyDB Omni כשהתקנתם אותו.

Podman

  podman exec -it CONTAINER_NAME psql -U postgres

מחליפים את CONTAINER_NAME בשם שהקציתם לקונטיינר של AlloyDB Omni כשהתקנתם אותו.

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

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

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

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

כדי להתחבר לשרת מסד הנתונים של AlloyDB Omni, צריך לחשוף את הרשת ממארז ה-Docker של AlloyDB Omni למחשב המארח. לשם כך, מוסיפים את --network=host או את -p 5432:5432 לפקודה docker run או podman run כשמפעילים את AlloyDB Omni.

כדי לבחור מספר יציאה מותאם אישית, משתמשים ב--p [HOST_PORT]:5432 כשמפעילים את AlloyDB Omni. לאחר מכן, משתמשים בכל לקוח או ספריית קוד שתואמים ל-PostgreSQL כדי להתחבר ליציאה 5432 או למספר היציאה המותאם אישית שציינתם.

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

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

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