קישור psql למסד נתונים בניב PostgreSQL

בדף הזה מוסבר איך לחבר את psql למסד נתונים בניב PostgreSQL ב-Spanner. ‫psql הוא ממשק שורת הפקודה של PostgreSQL.

אפשר לחבר את psql ל-Spanner בשתי דרכים:

  • שימוש ב-Spanner PG Connector‏ (spgc): spgc הוא wrapper עצמאי של CLI שכולל את PGAdapter וסביבת זמן ריצה מינימלית של Java. הוא מפעיל ומפסיק את PGAdapter ברקע כשמריצים את psql.
  • שימוש במכונה פועלת של PGAdapter: הפעלה וניהול של תהליך ה-proxy של PGAdapter בנפרד. ואז מחברים את psql אל localhost.

התחברות באמצעות Spanner PG Connector‏ (spgc)

spanner-pg-connector (עם הכינוי spgc) מאפשר להריץ את psql בלי להתקין את Java או Docker, או לנהל ידנית תהליך נפרד של PGAdapter.

  1. מתקינים את psql ב-PATH, ומתקינים את spgc לפי ההוראות במאמר הפעלת PGAdapter.

  2. מגדירים את Application Default Credentials (ADC), לדוגמה, על ידי הפעלת gcloud auth application-default login או הגדרת GOOGLE_APPLICATION_CREDENTIALS.

  3. מריצים את psql עד spgc על ידי ציון השם המלא של משאב מסד הנתונים:

    spgc psql -d "projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID"
    

    לחלופין, מגדירים את GOOGLE_CLOUD_PROJECT ו-SPANNER_INSTANCE (ואת SPANNER_DATABASE, אם רוצים):

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID
    export SPANNER_INSTANCE=INSTANCE_ID
    
    spgc psql -d DATABASE_ID
    
  4. אופציונלי: כדי לוודא ש-psql התחבר למסד נתונים עם ניב PostgreSQL, מריצים את השאילתה הבאה:

    SELECT 1::bigint;
    

    השאילתה הזו לא תואמת למסדי נתונים בניב GoogleSQL.

התחברות למכונה פעילה של PGAdapter

אם אתם מריצים את PGAdapter כתהליך או כקונטיינר נפרד:

  1. מפעילים את PGAdapter באותו מחשב שבו מפעילים את הפקודה psql.

    מידע נוסף זמין במאמר הפעלת PGAdapter.

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

    • אם PGAdapter מוגדר להאזין ליציאה אחרת מיציאת ברירת המחדל של PostgreSQL‏ (5432), אפשר לציין מספר יציאה.
    • אפשר לציין פקודה אחת או יותר לשליחה למסד הנתונים או למנהל ההתקן (לדוגמה, מנהל ההתקן של JDBC). בכל פעם שמשתמשים באפשרות -c, אפשר לציין פקודה אחת או קבוצה של פקודות שמופרדות בנקודה-פסיק (;). מידע נוסף זמין במאמר כלי שורת הפקודה psql.

    psql -h localhost [-p PORT] [-c "COMMAND; ..."] ...

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

    SELECT 1::bigint;

    השאילתה הזו לא תואמת למסדי נתונים בניב GoogleSQL.

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