‫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. מאמתים את הפרויקט והתוכן:
    • אפשר להשתמש בכלי לאימות תוכן כדי לסרוק את כל לוחות הבקרה והתצוגות ולחפש שדות או הפניות שבורים.
    • אפשר להשתמש בכלי לאימות SQL של Looker CI כדי לאמת את המאפיינים ב-Explores מול מסד הנתונים.
  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 לרשימת הגישה של 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 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.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. בתפריט הנפתח Dialect (ניב), בוחרים באפשרות 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.14:

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

בנוסף: