התחברות לאשכול מסדי נתונים

כברירת מחדל, אשכול מסד נתונים מאפשר חיבור רק מתוך אשכול המשתמשים ומאותו פרויקט.

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

כדי לאפשר חיבורים לאשכול של מסד נתונים מכתובות IP מחוץ לארגון ב-GDC, קראו את המאמר הפעלת חיבורים חיצוניים.

כדי למצוא את המידע הבא להתחברות לאשכול מסד הנתונים, נכנסים למסוף GDC באמצעות חשבון שמקושר לתפקיד אדמין של פרויקט מסד נתונים. המידע הזה נמצא בקטע Connectivity בדף Database Service.

השלבים האלה כוללים דוגמה להתחברות למסד הנתונים באמצעות psql. השלבים המדויקים משתנים בהתאם לתוכנת הלקוח שבוחרים.

המסוף

  1. עוברים לקטע Connectivity בדף Database Service של אשכול מסד הנתונים. הדף הזה כולל:

    • הסיסמה של חשבון האדמין (שם המשתמש הוא dbsadmin)
    • שם המארח ומספר היציאה של נקודת הקצה הראשית של אשכול מסד הנתונים
    • אם אשכול מסד הנתונים מאפשר חיבור חיצוני מחוץ לארגון.
    • פקודת psql להתחברות לאשכול
    • קישור להורדת אישור ה-CA של אשכול מסד הנתונים

  2. מורידים את אישור ה-CA ממסוף GDC בקטע Connectivity בדף Database Service של אשכול מסד הנתונים.

  3. מגדירים את הלקוח כך שישתמש באישור ה-CA כדי לאמת את מסד הנתונים. בלקוחות psql, מגדירים את משתנה הסביבה PGSSLROOTCERT לנתיב של קובץ האישור ואת משתנה הסביבה PGSSLMODE לפי ההעדפה שלכם:

    export PGSSLROOTCERT=path/to/accounts_cert.pem
export PGSSLMODE="verify-full"

  4. מתחברים למסד הנתונים מתוכנת הלקוח. אם משתמשים ב-psql, מריצים את הפקודה הבאה:

    PGPASSWORD=DB_PASSWORD psql -h DB_HOSTNAME -p PORT -U USERNAME -d postgres

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

  • ‫path/to/: הנתיב לאישור accounts_cert.pem.
  • DB_PASSWORD: הסיסמה מהמסוף.
  • ‫DB_HOSTNAME: שם המארח של מסד הנתונים מהמסוף.
  • ‫DB_PORT: מספר היציאה של מסד הנתונים מהמסוף.
  • DB_USERNAME: שם המשתמש של מסד הנתונים מהמסוף.

API

  1. מאחזרים את נקודת הקצה של מסד הנתונים מסטטוס אשכול מסד הנתונים:

    kubectl get dbcluster.postgresql.dbadmin.gdc.goog DBCLUSTER_NAME -n USER_PROJECT -o=jsonpath='{.status.primary.url}'

  2. מורידים את אישור ה-CA מהסוד של Kubernetes:

    kubectl get secret dbs-certificates -n USER_PROJECT -o json | jq -r '.data."dbs-pg-cert-DBCLUSTER_NAME"' | base64 -d > path/to/ca.crt

  3. מגדירים את הלקוח כך שישתמש באישור ה-CA כדי לאמת את מסד הנתונים. בלקוחות psql, אפשר להגדיר את משתנה הסביבה PGSSLROOTCERT לנתיב של קובץ האישור ואת משתנה הסביבה PGSSLMODE להעדפה שלכם:

    export PGSSLROOTCERT=path/to/ca.crt
export PGSSLMODE="verify-full"

  4. מתחברים למסד הנתונים מתוכנת הלקוח. אם משתמשים ב-psql, מריצים את הפקודה הבאה:

    PGPASSWORD=DB_PASSWORD psql -h DB_HOSTNAME -p DB_PORT -U DB_USERNAME -d postgres

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

  • ‫USER_PROJECT: השם של פרויקט המשתמש שבו נוצר אשכול מסד הנתונים.
  • ‫DBCLUSTER_NAME: שם אשכול מסד הנתונים.
  • ‫path/to/: הנתיב לאישור ה-CA של מסד הנתונים.
  • ‫DB_PASSWORD: סיסמת מסד הנתונים של משתמש עם הרשאת אדמין.
  • ‫DB_HOSTNAME: שם המארח מהסטטוס של אשכול מסד הנתונים.
  • ‫DB_PORT: מספר היציאה של מסד הנתונים מסטטוס אשכול מסד הנתונים.
  • DB_USERNAME: עם שם המשתמש של מסד הנתונים (ברירת המחדל היא dbsadmin).