התחברות באמצעות לקוח psql

אתם יכולים להשתמש בלקוח שורת הפקודה של PostgreSQL כדי להתחבר ל-Cloud SQL. בדף הזה מוסבר איך לחבר לקוח psql למכונה של Cloud SQL, בין אם הוא פועל באופן מקומי במכונה של הלקוח, במכונה וירטואלית של Compute Engine או ב-Cloud Shell.

לפני שמתחילים

כדי להשתמש בלקוח psql כדי להתחבר למכונה של Cloud SQL, צריך לבצע את הפעולות הבאות:

שימוש בלקוח PostgreSQL במכונה מקומית או במכונה וירטואלית של Compute Engine

כדי להתחבר למכונה של Cloud SQL באמצעות לקוח psql, צריך לבצע שלוש משימות ברמה גבוהה:

  1. מתקינים את הלקוח.
  2. הגדרת הגישה למכונה של Cloud SQL.
  3. מתחברים למכונה של Cloud SQL.

התקנת הלקוח

כדי להתקין את הלקוח של psql:

Debian/Ubuntu

מתקינים את לקוח psql ממנהל החבילות:

sudo apt-get update
sudo apt-get install postgresql-client

CentOS/RHEL

מתקינים את לקוח psql ממנהל החבילות:

sudo yum install postgresql

openSUSE

מתקינים את לקוח psql ממנהל החבילות:

sudo zypper install postgresql

פלטפורמות אחרות

  1. מורידים את PostgreSQL Core Distribution לפלטפורמה שלכם מדף ההורדות של PostgreSQL. ‫
    ההפצה הבסיסית כוללת את הלקוח psql.
  2. מתקינים את מסד הנתונים של PostgreSQL לפי ההוראות שבדף ההורדה.

הגדרת הגישה למכונה של Cloud SQL

כדי להגדיר גישה למכונה:

  1. במכונה של הלקוח או במכונה הווירטואלית של Compute Engine, משתמשים ב-What's my IP כדי לראות את כתובת ה-IP של המכונה של הלקוח.
  2. מעתיקים את כתובת ה-IP הזו.
  3. נכנסים לדף Cloud SQL Instances במסוף Google Cloud .

    כניסה לדף Cloud SQL Instances

  4. כדי לפתוח את הדף Overview של מכונה, לוחצים על שם המכונה.
  5. בתפריט הניווט של SQL, לוחצים על Connections (קישורים).
  6. לוחצים על הכרטיסייה Networking.
  7. בקטע Authorized networks, לוחצים על Add network ומזינים את כתובת ה-IP של המכונה שבה מותקן הלקוח.
  8. לוחצים על סיום. כדי לשמור את השינויים, לוחצים על שמירה בתחתית הדף.
  9. מתחברים למכונה באמצעות SSL/TLS או ללא הצפנה (בלי להשתמש ב-SSL/TLS).

התחברות למכונה של Cloud SQL בלי הצפנה

כדי לאפשר לכם להתחבר בלי הצפנה, צריך להגדיר את מצב SSL במכונה ל-ALLOW_UNENCRYPTED_AND_ENCRYPTED. במסוף Google Cloud , ההגדרה המקבילה היא Allow unencrypted network traffic.

מידע נוסף על הגדרת SSL/TLS של המכונה זמין במאמר הגדרת אישורי SSL/TLS.

כדי להתחבר למכונה:

  1. מוודאים שהתקנתם את הלקוח והגדרתם גישה למכונה.
  2. מפעילים את הלקוח של psql:
    psql "sslmode=disable dbname=postgres user=postgres hostaddr=INSTANCE_IP_ADDRESS"
  3. הזן סיסמה.
  4. מופיעה ההנחיה psql.

התחברות למכונה של Cloud SQL באמצעות SSL/TLS

כדי להתחבר למכונה באמצעות SSL/TLS ואימות מובנה:

  1. מפעילים את הלקוח של psql:
    psql "sslmode=require \
          hostaddr=INSTANCE_IP_ADDRESS \
          user=postgres dbname=DB_NAME"
       

    לדוגמה:

    psql "sslmode=require \
          hostaddr=203.12.34.56 \
          user=postgres dbname=postgres"
       

    כדאי גם ליצור קובץ Connection Service File כדי לנהל את הפרמטרים של החיבור, במיוחד אם אתם מתחברים ליותר ממכונה אחת. מידע נוסף זמין במאמרי העזרה של PostgreSQL.

  2. מזינים את הסיסמה. חובה להזין סיסמה ב-Cloud SQL, למרות ש-PostgreSQL תומך בקישוריות ללא סיסמה כשמשתמשים ב-SSL/TLS.
  3. כדי לוודא שהחיבור מוצפן, מחפשים את הצופן בפרטי החיבור:
    SSL connection (cipher: ECDHE-RSA-AES128-GCM-SHA256, bits: 128)
    

התחברות למכונה של Cloud SQL באמצעות SSL/TLS ואימות אישור לקוח

אם ssl_mode במכונה של Cloud SQL מוגדר ל-TRUSTED_CLIENT_CERTIFICATE_REQUIRED, צריך גם לספק זהות לקוח מאומתת כשמתחברים.

כדי להתחבר באמצעות אישורי SSL/TLS עם אימות לקוח, צריך:

  • אישור של מפתח ציבורי של לקוח בקובץ client-cert.pem.
  • מפתח פרטי של לקוח בקובץ client-key.pem.

בנוסף, כדי לאפשר ללקוח לאמת את זהות השרת לצורך אימות הדדי, צריך לציין את אישור השרת server-ca.pem.

לדוגמה, כדי להפעיל את הלקוח psql:
   psql "sslmode=verify-ca sslrootcert=server-ca.pem \
      sslcert=client-cert.pem sslkey=client-key.pem \
      hostaddr=INSTANCE_IP_ADDRESS \
      user=postgres dbname=DB_NAME"
   

אם אין לכם אישור לקוח ומפתח פרטי תואם, צרו אישור לקוח חדש.

שימוש בלקוח ב-Cloud Shell

כדי להתחבר למכונה של Cloud SQL (כתובת IP ציבורית בלבד):

  1. נכנסים למסוף Google Cloud .

    נכנסים ל Google Cloud מסוף.

  2. לוחצים על הסמל של Cloud Shell בצד שמאל של סרגל הכלים.

    ההפעלה של Cloud Shell נמשכת כמה רגעים.

  3. בשורת הפקודה של Cloud Shell, משתמשים בלקוח המובנה כדי להתחבר למכונה של Cloud SQL:
    gcloud sql connect INSTANCE_ID \
    --user=postgres
  4. הזן סיסמה.

הפקודה gcloud sql connect לא תומכת בחיבור למכונה של Cloud SQL באמצעות כתובת IP פרטית או באמצעות SSL/TLS. כדי להתחבר באמצעות הצפנה, מתקינים את שרת ה-proxy ומשתמשים בו ב-Cloud Shell:

  1. מתקינים את שרת ה-Proxy (‏Linux‏ 64 סיביות) בספרייה /home/USER.
  2. מפעילים את שרת ה-proxy באמצעות אימות של ה-CLI של gcloud:

    ./cloud-sql-proxy INSTANCE_CONNECTION_NAME &

  3. מתחברים למסד הנתונים באמצעות חיבור TCP:

    psql -U USERNAME --host=127.0.0.1

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

נסו בעצמכם

אנחנו ממליצים למשתמשים חדשים ב-Google Cloud ליצור חשבון כדי שיוכלו להעריך את הביצועים של Cloud SQL בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300 $להרצה, לבדיקה ולפריסה של עומסי העבודה.

להתנסות ב-Cloud SQL בחינם