‫MongoDB Connector for BI

מעבר מ-MongoBI ל-MongoSQL

מעכשיו יש ב-Looker תמיכה ב-MongoSQL, ומומלץ לבצע מיגרציה ל-MongoSQL מ-MongoDB Connector for BI.

בגלל ההבדלים בתחביר SQL בין MongoDB Connector for BI‏ (MongoBI) לבין MongoSQL, יכול להיות שיהיה צורך לבצע שינויים בתחביר של מודלים קיימים של LookML שמשתמשים בבלוקים מותאמים אישית של SQL, בעיצוב תאריכים או בפונקציות של מסד נתונים. אל תעבירו חיבור קיים של סביבת ייצור ישירות ל-MongoSQL בלי לאמת קודם את קוד ה-LookML, כי זה עלול לשבור לוחות בקרה, תצוגות ותזמונים או התראות.

כדי לבצע מיגרציה בטוחה מ-MongoBI ל-MongoSQL, צריך לבצע את השלבים הבאים:

  1. אפשר לעיין בהבדלים בתחביר SQL בין MongoBI לבין MongoSQL במסמכי התיעוד של MongoDB מעבר מ-Atlas BI Connector ל-MongoSQL.
  2. יוצרים חיבור חדש ל-MongoSQL ב-Looker כחיבור משני.
  3. בענף פיתוח חדש בפרויקט של LookML, מעדכנים את הפרמטר connection בקובץ המודל כך שיצביע על חיבור MongoSQL החדש.
  4. ב-SQL Runner, בודקים ומריצים שאילתות לדוגמה מתוך Explores כדי לאמת את תחביר השאילתה והתוצאות.
  5. מאמתים את הפרויקט והתוכן:
  6. אחרי שפותרים את כל שגיאות האימות, פורסים את השינויים בסביבת הייצור.

שימוש ב-MongoDB Connector for BI‏ (MongoBI)

ל-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

‫Atlas מאפשר חיבורי לקוחות רק מכתובות שמופיעות ברשימת הגישה ל-IP של הפרויקט. מוסיפים את כתובת ה-IP של Looker לרשימת הגישה של פרויקט Atlas:

  1. קבלת כתובת ה-IP של Looker
  2. פועלים לפי ההוראות להגדרת רשימת גישה ל-IP ב-Atlas כדי להוסיף את כתובת ה-IP של Looker לרשימת גישה ל-IP ב-Atlas.

הפעלת MongoDB Connector for BI

מפעילים את MongoDB Connector for BI:

  1. מוודאים שאתם נמצאים באשכול M10+‎.
  2. ב-Atlas, פותחים את דף החיבור של האשכול. רושמים את שם המארח, היציאה והמשתמש. תצטרכו להשתמש במידע הזה כשמגדירים את הקישור ב-Looker.

‫MongoDB באותו שרת

לפני שיוצרים חיבור ב-Looker, האדמין של MongoDB צריך להגדיר את MongoDB ואת Mongo Connector for BI באמצעות השלבים הבאים, שמוסברים בדף הזה:

התקנת 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 האלה:

פועלים לפי השלבים בדף התיעוד בנושא Unpackaged JDBC drivers (מנהלי התקנים של 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.jar
  • looker/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 למסד הנתונים:

  1. בקטע ניהול ב-Looker, בוחרים באפשרות חיבורים ואז לוחצים על הוספת חיבור.

  2. בתפריט הנפתח ניב, בוחרים באפשרות MongoBI.

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

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

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

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

שימוש בפונקציות ובאופרטורים של SQL עם MongoDB Connector for BI

כשמפתחים באמצעות חיבור של MongoDB Connector for BI, אפשר להשתמש בפונקציות ובאופרטורים של SQL שמפורטים במסמכי התיעוד של MongoDB.

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

ב-MongoDB Connector for BI, ‏ Looker תומך בפרמטרים הבאים של JDBC בשדה Additional JDBC parameters של החיבור. מידע על הפרמטרים האלה מופיע במאמרי העזרה של מסד הנתונים.

  • allowMultiQueries
  • appName
  • authSource
  • autoReconnect
  • cachePrepStmts
  • characterEncoding
  • connectTimeout
  • connectTimeoutMS
  • elideSetAutoCommits
  • enabledSslProtocolSuites
  • enabledTLSProtocols
  • explainSlowQueries
  • maxAllowedPacket
  • password
  • queryInterceptors
  • queryTimeoutKillsConnection
  • replicaSet
  • rewriteBatchedStatements
  • socketTimeout
  • ssl
  • sslMode
  • tcpKeepAlive
  • useCompression
  • useCursorFetch
  • useLocalSessionState
  • user
  • useServerPrepStmts
  • useSSL
  • verifyServerCertificate
  • zeroDateTimeBehavior

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

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

התכונות הבאות נתמכות ב-MongoBI החל מ-Looker 26.18:

התכונה נתמך?
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
פרטי כניסה של OAuth 2.0
תגובות להוספת הקשר
איגום חיבורים
סקיצות HLL
מודעות מצטברת
PDT מצטברות
אלפיות השנייה
מיקרו-שניות
תצוגות מהותיות
מדדים של השוואה בין תקופות שונות
ספירה משוערת של ערכים ייחודיים
מודלים אנליטיים במסד הנתונים
יומנים בהתאמה אישית

בנוסף: