ל-Looker יש גישה ל-MongoDB באמצעות MongoDB Connector for BI בשתי אפשרויות:
- שימוש ב-MongoDB Connector for BI ב-MongoDB Atlas.
- שימוש ב-MongoDB Connector for BI שמותקן באותו שרת שבו מותקן מסד הנתונים של MongoDB.
MongoDB Atlas
ב-MongoDB Atlas צריך להשתמש באשכול M10 ומעלה. כדי ש-Looker יוכל להשתמש במסד נתונים של MongoDB שפועל ב-MongoDB Atlas, צריך להשתמש ב-MongoDB Connector for BI (MongoBI). כדי להפעיל את BI Connector for Atlas, צריך להשתמש ב-MongoDB Atlas באשכול M10 ומעלה.
בנוסף, צריך ליצור חשבון משתמש עם הרשאות קריאה למסד הנתונים הרצוי.
הגדרת MongoDB Connector for BI
לפני שיוצרים חיבור ב-Looker, האדמין של MongoDB או Atlas צריך להגדיר את MongoDB Connector for BI באמצעות השלבים הבאים, שמפורטים בדף הזה:
- הוספת שרת Looker לרשימת כתובות ה-IP עם גישה ל-Atlas
- הפעלת MongoDB Connector for BI
- התרת שימוש בטבלאות נגזרות רגילות (מומלץ)
הוספת שרת Looker לרשימת הגישה של Atlas לפי IP
Atlas מאפשר חיבורי לקוחות רק מכתובות שמופיעות ברשימת הגישה ל-IP של הפרויקט. מוסיפים את כתובת ה-IP של Looker לרשימת הגישה לפי IP של פרויקט Atlas:
- איך מקבלים את כתובת ה-IP של Looker
- פועלים לפי ההוראות להגדרת רשימת גישה ל-IP ב-Atlas כדי להוסיף את כתובת ה-IP של Looker לרשימת גישה ל-IP ב-Atlas.
הפעלת MongoDB Connector for BI
מפעילים את MongoDB Connector for BI:
- מוודאים שאתם נמצאים באשכול M10+.
- ב-Atlas, פותחים את דף החיבור של האשכול. חשוב לרשום לפניכם את שם המארח, היציאה והמשתמש. תצטרכו להשתמש במידע הזה כשמגדירים את החיבור ב-Looker.
MongoDB באותו שרת
לפני שיוצרים קישור ב-Looker, האדמין של MongoDB צריך להגדיר את MongoDB ואת Mongo Connector for BI באמצעות השלבים הבאים, שמוסברים בדף הזה:
- התקנת Mongo Connector for BI
- הצפנת תנועה ברשת
- הגדרה של משתמש והרשאות ב-Looker
- התרת שימוש בטבלאות נגזרות רגילות (מומלץ)
התקנת Mongo Connector for BI
מתקינים את MongoDB Connector for BI באותו שרת שבו נמצא מסד הנתונים של MongoDB, כמו שמוסבר בדף התיעוד של MongoDB בנושא Install BI Connector On Premises .
הצפנה של תנועה ברשת
המחבר של MongoDB ל-BI מחייב שימוש בהצפנת SSL בין השרת של MongoDB לבין אפליקציית Looker. פועלים לפי ההוראות להגדרת SSL בדף התיעוד של MongoDB בנושא הגדרת SSL עבור BI Connector.
הגדרת המשתמש וההרשאות ב-Looker
ב-MongoDB shell, מזינים את הפקודה use כדי לעבור למסד הנתונים שאליו Looker יתחבר. לאחר מכן, יוצרים משתמש ב-Looker עם db.createUser() עם התפקיד readWrite:
use looker_database
db.createUser({ user: looker,
pwd: `some_password_here`,
roles: [ "readWrite" ]
})
התקנה של קובצי מנהל ההתקן MongoBI JDBC
בשתי האפשרויות של MongoDB Connector for BI, כדי להשתמש ב-Looker צריך להגדיר קבצים של מנהל התקן JDBC. לשם כך, מבצעים את השלבים הבאים:
מורידים את שני קובצי ה-JAR האלה:
פועלים לפי השלבים בדף התיעוד בנושא מנהלי התקנים של JDBC שלא נארזו, ומשתמשים בערכים הבאים:
סמל הנהג: mongobi
driver entry:
- name: mongobi
dir_name: mongobi
module_path: com.mysql.jdbc.Driver
override_jdbc_url_subprotocol: mysql
אם אתם משתמשים ב-Looker 6.2 או בגרסאות קודמות:
- name: maria15x
dir_name: mongobi
module_path: com.mysql.jdbc.Driver
override_jdbc_url_subprotocol: mysql
בשלב שבו מעבירים את הדרייבר לספרייה של הניב, הנתיבים לקבצים האלה ייראו כך:
looker/custom_jdbc_drivers/mongobi/mongosql-auth-1.0.0-rc0.jarlooker/custom_jdbc_drivers/mongobi/mysql-connector-java-5.1.47.jar
התרת שימוש בטבלאות נגזרות רגילות (מומלץ)
טבלאות נגזרות הן כלים חשובים ב-Looker שמאפשרים לכם להרחיב את מורכבות הניתוחים. הם יכולים גם למלא תפקיד חשוב בשיפור הביצועים של השאילתות. באופן כללי, היכולת של Looker ליצור טבלאות נגזרות מאפשרת ליצור טבלאות חדשות שלא קיימות כבר במסד הנתונים.
המחבר של MongoDB ל-BI תומך בטבלאות נגזרות רגילות זמניות, אבל לא תומך בטבלאות נגזרות קבועות.
מכיוון שטבלאות נגזרות רגילות הן זמניות, אין צורך לאחסן אותן. לכן, אין צורך ליצור סכימה בשבילם. עם זאת, צריך להעניק את התפקיד dbOwner לסכימה looker_tmp, גם אם הסכימה הזו לא קיימת.
כדי להוסיף את התפקיד dbOwner ב-looker_tmp למשתמש ש-Looker ישתמש בו כדי להתחבר, פועלים לפי ההוראות שבקטע Modify MongoDB Users (שינוי משתמשי MongoDB) בדף התיעוד הזה של MongoDB בנושא הגדרת משתמשי מסד נתונים.
db.grantRolesToUser("looker", [ {role: "dbOwner", db: "looker_tmp"} ])
יצירת חיבור Looker למסד הנתונים
כדי ליצור את החיבור מ-Looker למסד הנתונים:
- בקטע Admin (ניהול) ב-Looker, בוחרים באפשרות Connections (חיבורים) ואז לוחצים על Add Connection (הוספת חיבור).
בתפריט הנפתח Dialect (ניב), בוחרים באפשרות MongoBI.
ממלאים את פרטי החיבור. רוב ההגדרות משותפות לרוב הניבים של מסדי הנתונים. מידע נוסף זמין בדף חיבור Looker למסד הנתונים.
כדי לוודא שהחיבור בוצע בהצלחה, לוחצים על בדיקה. מידע לפתרון בעיות זמין בדף בנושא בדיקת הקישוריות למסד הנתונים.
כדי לשמור את ההגדרות האלה, לוחצים על Connect (חיבור).
שימוש בפונקציות ובאופרטורים של SQL עם MongoDB Connector for BI
כשמפתחים באמצעות חיבור של MongoDB Connector for BI, אפשר להשתמש בפונקציות ובאופרטורים של SQL שמפורטים במסמכי התיעוד של MongoDB.
פרמטרים נתמכים של JDBC
ב-MongoDB Connector for BI, Looker תומך בפרמטרים הבאים של JDBC בשדה Additional JDBC parameters של החיבור. מידע על הפרמטרים האלה זמין במסמכי התיעוד של מסד הנתונים.
allowMultiQueriesappNameauthSourceautoReconnectcachePrepStmtscharacterEncodingconnectTimeoutconnectTimeoutMSelideSetAutoCommitsenabledSslProtocolSuitesenabledTLSProtocolsexplainSlowQueriesmaxAllowedPacketpasswordqueryInterceptorsqueryTimeoutKillsConnectionreplicaSetrewriteBatchedStatementssocketTimeoutsslsslModetcpKeepAliveuseCompressionuseCursorFetchuseLocalSessionStateuseruseServerPrepStmtsuseSSLverifyServerCertificatezeroDateTimeBehavior
תמיכה בתכונות
כדי ש-Looker יתמוך בתכונות מסוימות, הדיאלקט של מסד הנתונים שלכם צריך לתמוך בהן גם כן.
התכונות הבאות נתמכות ב-MongoBI החל מ-Looker 26.10:
| תכונה | האם יש תמיכה? |
|---|---|
| Looker (Google Cloud core) | |
| צבירה סימטרית | |
| טבלאות נגזרות | |
| טבלאות נגזרות מתמידות שמבוססות על SQL | |
| טבלאות נגזרות מתמידות מבוססות LookML | |
| תצוגות יציבות | |
| ביטול שאילתה | |
| טבלאות ציר שמבוססות על SQL | |
| אזורי זמן | |
| SSL | |
| סכומי ביניים | |
| פרמטרים נוספים של JDBC | |
| תלוי אותיות רישיות | |
| סוג מיקום | |
| סוג הרשימה | |
| מאון | |
| אחוזון נפרד | |
| SQL Runner Show Processes | |
| SQL Runner Describe Table | |
| SQL Runner Show Indexes | |
| SQL Runner Select 10 | |
| מספר הפעמים שהופעל SQL Runner | |
| SQL Explain | |
| פרטי כניסה של OAuth 2.0 | |
| תגובות להוספת הקשר | |
| איגום חיבורים | |
| רישומים מסוג HLL | |
| מודעות מצטברת | |
| המרות מצטברות של PDT | |
| אלפיות שנייה | |
| מיקרו-שניות | |
| תצוגות מהותיות | |
| מדדים של השוואה בין תקופות שונות | |
| ספירה משוערת של ערכים ייחודיים | |
| מודלים אנליטיים בתוך מסד הנתונים | |
| יומנים בהתאמה אישית |
בנוסף:
- MongoDB לא תומך במסגרות זמן של אלפיות השנייה ומיליוניות השנייה לקבוצות של מימדים.
- MongoDB לא תומך בסוגים millisecond, millisecondX ו-microsecond למימדים.
- מערכת Looker מתייחסת לכל חותמות הזמן שמתקבלות מ-MongoBI כאילו הן באזור הזמן UTC.