‫MongoDB Connector for BI

מעבר מ-MongoBI ל-MongoSQL

Looker תומך כעת ב-MongoSQL וממליץ לעבור ל-MongoSQL ממחבר MongoDB עבור BI.

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

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

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

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

Looker יכול לגשת ל-MongoDB באמצעות מחבר MongoDB עבור BI באמצעות שתי אפשרויות:

  • שימוש ב-MongoDB Connector for BI ב-MongoDB Atlas.
  • שימוש במחבר MongoDB עבור BI המותקן באותו שרת בו נמצא מסד הנתונים של MongoDB.

אטלס MongoDB

אטלס ה-MongoDB שלך חייב להשתמש באשכול 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 לרשימת הגישה של Atlas לפי IP

ב-Atlas, מותרים חיבורים של לקוחות רק מכתובות שמופיעות ברשימת הגישה ל-IP של הפרויקט. מוסיפים את כתובת ה-IP של Looker לרשימת הגישה לפי IP של פרויקט 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.

הגדרת משתמש והרשאות של Looker

ב-מעטפת MongoDB, הזינו את הפקודה 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.jar
  • looker/custom_jdbc_drivers/mongobi/mysql-connector-java-5.1.47.jar

מתן אפשרות לשימוש בטבלאות נגזרות רגילות (מומלץ)

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

מחבר MongoDB עבור BI תומך בטבלאות נגזרות רגילות זמניות, אך אינו תומך בטבלאות נגזרות מתמידות.

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

עקוב אחר הסעיף "שינוי משתמשי MongoDB" בנושא זה.דף תיעוד של MongoDB על הגדרת משתמשי מסד נתונים להוסיף אתdbOwner תפקיד עלlooker_tmp עבור המשתמש בו Looker ישתמש כדי להתחבר.

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 עבור BI

בעת פיתוח באמצעות מחבר MongoDB עבור חיבור 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.16:

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

בנוסף: