PostgreSQL

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

ניבים שמשתמשים בהוראות האלה

הניבים הבאים חולקים את הדרישות להגדרת מסד הנתונים שמתוארות בדף הזה:

• PostgreSQL
• Microsoft Azure PostgreSQL
• ‫Amazon Aurora PostgreSQL
• ‫Amazon RDS ל-PostgreSQL

ל-Amazon RDS ל-PostgreSQL ול-Amazon Aurora PostgreSQL, ‏ Looker כולל תמיכה בשילוב.

למידע על PostgreSQL ב-Heroku, אפשר לעיין במסמכי Heroku.

למידע על Google Cloud SQL ל-PostgreSQL, אפשר לעיין בדף הייעודי בנושא Google Cloud SQL ל-PostgreSQL.

הצפנה של תנועה ברשת

מומלץ להצפין את תעבורת הנתונים ברשת בין אפליקציית Looker לבין מסד הנתונים. כדאי לשקול אחת מהאפשרויות שמתוארות בדף הפעלת גישה מאובטחת למסד נתונים.

אם אתם רוצים להשתמש בהצפנת SSL, תוכלו לעיין במסמכי PostgreSQL.

משתמשים ואבטחה

כדי לבצע פעולות במסד הנתונים, ל-Looker צריך להיות חשבון משתמש במסד הנתונים.

כדי להגדיר משתמש מסד נתונים עבור Looker, בצע את השלבים הבאים במסד הנתונים שלך:

1. יוצרים משתמש וסיסמה למסד הנתונים.

   CREATE USER USERNAME WITH ENCRYPTED PASSWORD 'PASSWORD';
   

2. נותנים הרשאות למשתמש במסד הנתונים כדי ש-Looker יוכל לבצע פעולות במסד הנתונים:

   GRANT CONNECT ON DATABASE DATABASE_NAME to USERNAME;
   \c DATABASE_NAME
   GRANT SELECT ON ALL SEQUENCES IN SCHEMA public TO USERNAME;
   GRANT SELECT ON ALL TABLES IN SCHEMA public TO USERNAME;
   

3. אם אתם משתמשים בסכימה שאינה public, מריצים את הפקודה הזו כדי להעניק הרשאות שימוש ל-Looker:

   GRANT USAGE ON SCHEMA SCHEMA_NAME TO USERNAME;
   

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

   ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON tables TO USERNAME;
   ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON sequences TO USERNAME;
   

יכול להיות שתצטרכו לשנות את הפקודות הקודמות בהתאם להגדרה שלכם. אם משתמש או תפקיד אחרים יוצרים טבלאות שהמשתמש ב-Looker יזדקק להרשאות לגביהן בעתיד, צריך לציין תפקיד או משתמש יעד כדי להחיל עליהם את ההרשאות שניתנו למשתמש ב-Looker:

ALTER DEFAULT PRIVILEGES FOR USER ANOTHER_USERNAME IN SCHEMA SCHEMA_NAME GRANT SELECT ON tables TO USERNAME;
ALTER DEFAULT PRIVILEGES FOR ROLE TARGET_ROLE IN SCHEMA SCHEMA_NAME GRANT SELECT ON sequences TO USERNAME;

לדוגמה, אם משתמש web_app יוצר טבלאות ואתה רוצה שמשתמש looker יוכל להשתמש בטבלאות אלו, עליך להפעיל משפט GRANT כדי לתת למשתמש looker הרשאות לטבלאות שנוצרו על ידי משתמש web_app. תפקיד או משתמש היעד במקרה זה הוא משתמש web_app, מה שאומר שברצונך לשנות הרשאות בטבלאות שנוצרו על ידי web_app כך שלמשתמש looker יהיו הרשאות לקרוא את הטבלאות. לדוגמה:

ALTER DEFAULT PRIVILEGES FOR USER web_app IN SCHEMA public GRANT SELECT ON tables TO looker;

לִרְאוֹתALTER DEFAULT PRIVILEGES באתר האינטרנט של PostgreSQL למידע נוסף.

הגדרת סכימה זמנית

פוסטגרס באחסון עצמי

יוצרים סכימה בבעלות משתמש Looker:

CREATE SCHEMA SCHEMA_NAME AUTHORIZATION USERNAME;

פוסטגרס ב-Amazon RDS

צור סכימת גירסה:

CREATE SCHEMA SCHEMA_NAME;

שנה את הבעלות על סכימת הגרסה הקודמת למשתמש Looker:

ALTER SCHEMA SCHEMA_NAME OWNER TO USERNAME;

הגדרת ה-search_path

לפני חיבור Looker למסד הנתונים שלך, עליך להגדיר search_path מתאים, שבו ה-Looker SQL Runner יכול להשתמש כדי לאחזר מטא-נתונים מסוימים ממסד הנתונים שלך:

ALTER USER USERNAME SET search_path TO '$user',SCHEMA_NAME,SCHEMA_NAME_2,SCHEMA_NAME_3
                                                            ^^^^^^^^^^^^^^^^^^
                                                            ^^^^^^^^^^^^^^^^^^
                                             include a comma-separated list of
                                            all schemas that you'll use with Looker

יצירת חיבור Looker למסד הנתונים

כדי ליצור את החיבור מ-Looker למסד הנתונים:

1. פתחו את הדף חברו את מסד הנתונים שלכם ל-Looker על ידי ביצוע אחת מהפעולות הבאות:

   • לוחצים על סמל menu התפריט הראשי, בוחרים באפשרות אדמין ואז בוחרים באפשרות חיבורים בקטע מסד נתונים בחלונית אדמין. בדף Connections (חיבורים), לוחצים על הלחצן Add Connection (הוספת חיבור).
   • לוחצים על הלחצן יצירה בתפריט הניווט הראשי, ואז בוחרים באפשרות חיבור.

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

   • עבור Microsoft Azure PostgreSQL, בחר Microsoft Azure PostgreSQL.
   • עבור PostgreSQL, בחר PostgreSQL 9.5+‎‏ או PostgreSQL pre-9.5‎‏, בהתאם לגרסת PostgreSQL שלך.
   • עבור Amazon RDS עבור PostgreSQL ו-Amazon Aurora PostgreSQL, בחר PostgreSQL 9.5+‎‏.

3. ממלאים את פרטי החיבור. רוב ההגדרות משותפות לרוב הניבים של מסדי הנתונים. מידע נוסף זמין בדף חיבור Looker למסד הנתונים.

4. כדי לוודא שהחיבור בוצע בהצלחה, לוחצים על הלחצן בדיקת החיבור בקטע פרטי הסטטוס בחלק התחתון של הדף הגדרות החיבורים.

5. אם ב-Looker מוצגת ההודעה Can Connect (אפשר להתחבר), לוחצים על Connect (התחברות) כדי ליצור את החיבור.

החיבור למסד הנתונים יתווסף לרשימה בדף Connections Admin ב-Looker.

פרמטרים נתמכים של JDBC

עבור PostgreSQL, Looker תומך בפרמטרי JDBC הבאים בשדה Additional JDBC parameters עבור החיבור. מידע על הפרמטרים האלה זמין במסמכי התיעוד של מסד הנתונים.

• allowEncodingChanges
• ApplicationName
• assumeMinServerVersion
• binaryTransfer
• binaryTransferDisable
• binaryTransferEnable
• cancelSignalTimeout
• connectTimeout
• currentSchema
• databaseMetadataCacheFields
• defaultRowFetchSize
• escapeSyntaxCallMode
• gssEncMode
• hostRecheckSeconds
• jaasApplicationName
• jaasLogin
• kerberosServerName
• loadBalanceHosts
• loginTimeout
• logServerErrorDetail
• options
• password
• preferQueryMode
• preparedStatementCacheQueries
• prepareThreshold
• queryTimeout
• readOnly
• reWriteBatchedInserts
• socketTimeout
• ssl
• sslfactory
• sslhostnameverifier
• sslmode
• sslNegotiation
• sslpassword
• sslpasswordcallback
• stringtype
• targetServerType
• tcpKeepAlive
• unknownLength
• user

תמיכה בתכונות

כדי ש-Looker יתמוך בתכונות מסוימות, הדיאלקט של מסד הנתונים צריך לתמוך בהן גם כן.

PostgreSQL 9.5+ תומך בתכונות הבאות החל מ-Looker 26.16:

התכונות הבאות נתמכות ב-Microsoft Azure PostgreSQL החל מ-Looker 26.16: