קישור אל PostgreSQL

‫PostgreSQL היא מערכת ניהול של מסד נתונים יחסי (RDBMS) בקוד פתוח, שפותחה על ידי צוות מתנדבים מכל העולם.

מחבר PostgreSQL מאפשר לכם לגשת לנתונים ממסדי נתונים מבוססי PostgreSQL בתוך Data Studio.

איך מתחברים ל-PostgreSQL

המחבר הזה משתמש במנהל ההתקן PostgreSQL JDBC כדי לקשר מקור נתונים של Data Studio לטבלה אחת במסד נתונים של PostgreSQL.

גרסאות נתמכות

בדקנו את Data Studio בגרסאות הבאות של PostgreSQL:

  • 9.6
  • 10
  • 11
  • 12
  • 13
  • 14

אם נתקלתם בבעיות בשימוש בגרסה נתמכת, אתם יכולים לספר לנו על כך בקהילת Data Studio. אפשר גם להוסיף בקשות לתכונות ולהצביע עליהן בכלי למעקב אחר בעיות.

כדי להתחבר

  1. נכנסים ל-Data Studio.
  2. בדף הבית של Data Studio, בפינה הימנית העליונה, לוחצים על יצירה ואז על מקור נתונים.
  3. בוחרים את מחבר PostgreSQL.
  4. מגדירים גישה למסד הנתונים באמצעות אחת מאפשרויות החיבור.
  5. לוחצים על AUTHENTICATE. תוצג רשימה של טבלאות במסד הנתונים.
  6. בוחרים טבלה.
  7. לוחצים על קישור.

עכשיו אפשר לגשת לכל העמודות בטבלה כשדות בדוחות.

אפשרויות חיבור

BASIC

כדי להתחבר באמצעות שם מארח או כתובת IP, צריך לספק את הפרטים הבאים:

  • שם המארח או כתובת ה-IP
  • יציאה (אופציונלי)
  • מסד נתונים
  • שם משתמש
  • סיסמה

כתובת אתר של JDBC

כדי להתחבר באמצעות כתובת URL של JDBC, צריך לספק את פרטי החיבור הבאים:

  • כתובת אתר של JDBC
    • דוגמה jdbc:postgresql://HOSTNAME[:PORT]/DATABASE
  • סיסמה

אם משתמשים באפשרות של שם המארח ב-JDBC, אפשר לוודא שהיא נגישה באמצעות כלי חיפוש DNS ציבוריים כמו Whois.

כדי להתחבר באמצעות כתובת מילולית של IPv6, צריך להוסיף את הכתובת בסוגריים מרובעים. לדוגמה: jdbc:postgresql://[2001:db8:1:1:1:1:1:1]/your_db

הפעלת SSL

‫Data Studio תומך בחיבורים מאובטחים (מוצפנים) לשרת באמצעות פרוטוקול TLS (אבטחת שכבת התעבורה). פרוטוקול TLS נקרא גם SSL (שכבת שקע מאובטחת). כדי להפעיל חיבור מאובטח, מסמנים את התיבה הפעלת SSL ומזינים את קובצי ההגדרה של SSL.

ההגדרה הזו לא נדרשת ב-Data Studio, אבל יכול להיות שהיא נדרשת בהגדרת מסד הנתונים. לפרטים נוספים, אפשר לפנות לספק מסד הנתונים.

הפעלת אימות לקוח

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

ההגדרה הזו לא נדרשת ב-Data Studio, אבל יכול להיות שהיא נדרשת בהגדרת מסד הנתונים. לפרטים נוספים, אפשר לפנות לספק מסד הנתונים.

הערה : ב-Data Studio נדרש פורמט מפתח לקוח PKCS-8.

מידע נוסף על חיבורים מאובטחים ב-PostgreSQL

שאילתה בהתאמה אישית

בוחרים באפשרות CUSTOM QUERY (שאילתה בהתאמה אישית) כדי לספק שאילתת SQL במקום להתחבר לטבלה אחת. מערכת Data Studio משתמשת ב-SQL המותאם אישית הזה כהצהרת בחירה פנימית לכל שאילתה שנוצרת במסד הנתונים.

לדוגמה, הפקודה הבאה לא תפעל כי יש בה כמה הצהרות SQL:


DECLARE cost_per_tb_in_dollar FLOAT64 DEFAULT 4.2;

SELECT total_bytes_billed / (1024 * 1024))* cost_per_tb_in_dollar)/(1024*1024))) FROM billing-table;

יכול להיות ששאילתות ב-Data Studio יפסיקו לפעול אחרי שלוש עד חמש דקות. אם חלף הזמן הקצוב לתפוגה של השאילתות המותאמות אישית, אפשר לנסות את הגישות הבאות כדי לפתור את הבעיה:

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

הערות

סוגי נתונים נתמכים

מחבר PostgreSQL תומך בסוגי הנתונים הבאים:

  • Numeric
  • המשמעות של "על סמך תווים"
  • בוליאני
  • תאריך/שעה (חוץ מפרקי זמן)

כש-Data Studio נתקל בעמודה מסוג לא נתמך, הוא לא יוצר שדה עבור העמודה הזו.

מידע נוסף על סוגי נתונים ב-PostgreSQL

חומת אש וגישה למסד נתונים

כדי לאפשר ל-Data Studio להתחבר למסדי נתונים שנמצאים מאחורי חומת אש ולשאול אותם שאילתות, צריך לפתוח גישה לאחת מכתובות ה-IP הבאות. יכול להיות שתצטרכו גם להגדיר את מסד הנתונים כך שיקבל תנועה מהכתובות האלה. לקבלת הוראות להגדרה, עיינו במאמרי העזרה של מסד הנתונים הספציפי שלכם.

כתובות IP

הכתובות הבאות שמורות לתשתית הגלובלית של Data Studio:

  • 142.251.74.0/23

  • ‫2001:4860:4807::/48 (אופציונלי, לפלטפורמות שתומכות ב-IPv6)

אם הפעלתם את התכונה 'מיקום הנתונים' במינוי שלכם ל-Data Studio Pro, עליכם להשתמש בכתובות הבאות במקום זאת:

  • 142.251.56.0/24

  • ‫2001:4860:4815::/48 (אופציונלי, לפלטפורמות שתומכות ב-IPv6)

חשוב לשים לב למגבלות הבאות של הרשת כשמשתמשים במחבר PostgreSQL:

  • ‫Data Studio לא תומך בחיבורים של כתובות IP פרטיות ל-PostgreSQL ב-Cloud SQL.

  • מחבר PostgreSQL לא משתמש ב-Cloud SQL proxy כשמתחברים למופעים של Cloud SQL PostgreSQL. אם אתם מתחברים למכונת Cloud SQL PostgreSQL, תצטרכו להוסיף את כתובות ה-IP שמופיעות ברשימה לרשימת הרשתות המורשות. לעיון במאמרי העזרה של Cloud SQL

מגבלות של מחבר PostgreSQL

  • אי אפשר להתחבר למקורות נתונים של AlloyDB באמצעות SSL, כי AlloyDB לא תומך בייצוא של אישורים של רשות אישורים (CA).

  • אי אפשר לבחור טבלה מחוץ לסכימה public. עם זאת, אתם יכולים לבחור באפשרות CUSTOM QUERY (שאילתה בהתאמה אישית) כדי לכתוב שאילתה שכוללת טבלאות בכל סכימה.

  • אפשר להריץ שאילתות על עד 150,000 שורות בכל שאילתה באמצעות המחבר הזה. אם תחרגו מהמגבלה הזו, הנתונים ייחתכו.

  • כותרות העמודות (שמות השדות) צריכות להכיל רק תווי ASCII. אין תמיכה בתווים שאינם ASCII.

פתרון בעיות

במדריך לפתרון בעיות ב-Data Studio מופיעה רשימה של הודעות שגיאה נפוצות ושלבים לפתרון שלהן.

יצירת מקור נתונים