בדף הזה מוסבר איך לחבר את 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.
מתקינים את
psqlב-PATH, ומתקינים אתspgcלפי ההוראות במאמר הפעלת PGAdapter.מגדירים את Application Default Credentials (ADC), לדוגמה, על ידי הפעלת
gcloud auth application-default loginאו הגדרתGOOGLE_APPLICATION_CREDENTIALS.מריצים את
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אופציונלי: כדי לוודא ש-
psqlהתחבר למסד נתונים עם ניב PostgreSQL, מריצים את השאילתה הבאה:SELECT 1::bigint;השאילתה הזו לא תואמת למסדי נתונים בניב GoogleSQL.
התחברות למכונה פעילה של PGAdapter
אם אתם מריצים את PGAdapter כתהליך או כקונטיינר נפרד:
מפעילים את PGAdapter באותו מחשב שבו מפעילים את הפקודה
psql.מידע נוסף זמין במאמר הפעלת PGAdapter.
בחלון הטרמינל, מפעילים את
psqlומציינים אתlocalhostכמארח של שרת מסד הנתונים.- אם PGAdapter מוגדר להאזין ליציאה אחרת מיציאת ברירת המחדל של PostgreSQL (5432), אפשר לציין מספר יציאה.
- אפשר לציין פקודה אחת או יותר לשליחה למסד הנתונים או למנהל ההתקן (לדוגמה, מנהל ההתקן של JDBC). בכל פעם שמשתמשים באפשרות
-c, אפשר לציין פקודה אחת או קבוצה של פקודות שמופרדות בנקודה-פסיק (;). מידע נוסף זמין במאמר כלי שורת הפקודה psql.
psql -h localhost [-p PORT] [-c "COMMAND; ..."] ...אופציונלי: כדי לוודא ש-
psqlהתחבר בהצלחה למסד נתונים בניב PostgreSQL, שולחים את השאילתה הבאה:SELECT 1::bigint;השאילתה הזו לא תואמת למסדי נתונים בניב GoogleSQL.
המאמרים הבאים
- מידע על PGAdapter
- אפשר לעיין בפקודות הנתמכות של
psqlבכלי שורת הפקודה psql.