MongoSQL

אפשר לקשר את Looker ישירות לאשכול MongoSQL באמצעות הדיאלקט MongoSQL (שמופעל על ידי MongoSQL Interface). קישור Looker ל-MongoSQL מאפשר לכם לנתח נתונים של מסמכים באמצעות שאילתות SQL יחסיות וליצור לוחות בקרה אינטראקטיביים ב-Looker.

‫Looker כולל מנהל התקן JDBC עם רישיון Apache-2.0 עבור ממשק MongoSQL, שזמין לשימוש מיידי. בניגוד לניב MongoBI מדור קודם, לא נדרשת התקנה ידנית של קובצי JAR של מנהלי התקנים של JDBC שלא נארזו.

דרישות מוקדמות והגדרת MongoSQL

לפני שיוצרים חיבור ב-Looker, צריך לבצע את שלבי ההגדרה הבאים ב-MongoSQL:

יצירת סכימה יחסית באמצעות הכלי ליצירת סכימות SQL

‫MongoDB מאחסן נתונים בפורמט מסמך גמיש ולא רלציוני (JSON/BSON). כדי ש-Looker יוכל לשלוח שאילתות לקולקציות של MongoDB באמצעות SQL סטנדרטי, צריך להשתמש בכלי ליצירת סכימת SQL ב-MongoSQL כדי ליצור סכימת SQL.

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

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

במקרים של מופעי MongoDB Enterprise מקומיים, משתמשים ב-MongoDB SQL Schema Builder CLI כדי להגדיר את הסכימות.

הוספת כתובות IP של Looker לרשימת הגישה ל-IP ב-Atlas

‫MongoSQL מגביל את חיבורי הלקוח לכתובות IP מורשות. כדי להריץ שאילתות ב-MongoSQL ממופע Looker, צריך להוסיף את כתובות ה-IP של Looker לרשימת הגישה ל-IP ב-Atlas. לשם כך, מבצעים את השלבים הבאים:

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

יצירת חשבון משתמש ב-MongoDB ל-Looker

כדי ליצור חשבון משתמש במסד נתונים עבור Looker באמצעות מסוף האינטרנט של MongoDB Atlas, פועלים לפי השלבים הבאים:

  1. מתחברים אל מסוף MongoDB Atlas.
  2. בתפריט הניווט הראשי, בקטע אבטחה, בוחרים באפשרות גישה למסד נתונים.
  3. לוחצים על הוספת משתמש חדש למסד הנתונים.
  4. בוחרים באפשרות סיסמה כשיטת האימות. מזינים שם משתמש (לדוגמה, looker) וסיסמה מאובטחת.
  5. בקטע Database User Privileges (הרשאות משתמש במסד נתונים), בוחרים באפשרות Built-in Role (תפקיד מובנה) ומקצים את התפקיד read (או הרשאות קריאה בהתאמה אישית) למסד הנתונים שאליו Looker יקבל גישה.
  6. לוחצים על הוספת משתמש כדי לשמור את פרטי הכניסה של המשתמש.

קבלת פרמטרים של חיבור ל-Atlas SQL

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

  1. מתחברים אל מסוף MongoDB Atlas.
  2. עוברים אל האשכול ולוחצים על Connect (חיבור).
  3. בוחרים באפשרות Atlas SQL (או Connect your application using SQL).
  4. בוחרים באפשרות JDBC Driver (מנהל התקן ל-JDBC).
  5. שימו לב לערכים שנוצרו עבור Host,‏ Port (בדרך כלל 27017),‏ Database ולדרישות של SSL. תצטרכו להזין את הפרטים האלה כשיוצרים את החיבור ל-Looker.

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

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

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

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

    • שם: מזינים שם ייחודי לחיבור.
    • דיאלקט: בוחרים באפשרות MongoSQL מהתפריט הנפתח.
    • מארח: שם המארח שסופק על ידי ממשק MongoSQL (לדוגמה, <cluster-name>.a.query.mongodb.net).
    • יציאה: מספר היציאה של Atlas SQL (ברירת מחדל: 27017).
    • מסד נתונים: השם של מסד הנתונים שעבורו יצרתם סכימה באמצעות הכלי ליצירת סכימות SQL.
    • שם משתמש: שם המשתמש במסד הנתונים שנוצר עבור Looker.
    • סיסמה: סיסמת משתמש במסד הנתונים.
    • ‫SSL: מפעילים את SSL (ssl=true).
    • פרמטרים נוספים של JDBC: (אופציונלי) פרמטרים נוספים של JDBC שנתמכים על ידי מנהל ההתקן של MongoDB, כמו authSource=admin או connectTimeoutMS=10000. אלו הפרמטרים של JDBC שנתמכים.

  3. כדי לוודא שיש חיבור למסד הנתונים, לוחצים על בדיקת החיבור.

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

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

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

בדיאלקט MongoSQL, ‏ Looker תומך בפרמטרים הבאים של JDBC בשדה Additional JDBC parameters:

  • appName
  • authSource
  • clientinfo
  • connectTimeoutMS
  • directConnection
  • disableclientcache
  • extjsonmode
  • heartbeatFrequencyMS
  • journal
  • localThresholdMS
  • maxIdleTimeMS
  • maxWaitTimeMS
  • readPreference
  • replicaSet
  • retryReads
  • retryWrites
  • serverSelectionTimeoutMS
  • socketTimeoutMS
  • ssl
  • tls
  • tlsAllowInvalidHostnames
  • tlsInsecure
  • w
  • wtimeoutMS

מגבלות על שאילתות והתנהגות של SQL

כשיוצרים מודלים של LookML ומריצים שאילתות ב-MongoSQL באמצעות ממשק ה-SQL, חשוב לזכור את המאפיינים הבאים של הניב:

  • דרישה ל-SQL Schema Builder: כמו שצוין בדרישות המוקדמות, שאילתות SQL דורשות סכימה יחסית שהוגדרה מראש ב-Atlas SQL Schema Builder.
  • טבלאות נגזרות: יש תמיכה בטבלאות נגזרות ארעיות (רגילות), אבל אין תמיכה בטבלאות נגזרות מתמידות (PDT).
  • סוגי תאריכים וחותמות זמן: סוג הנתונים date לא נתמך. הדרך המקובלת היא לאחסן ולעצב תאריכים כשדות timestamp.
  • אזורי זמן: כל חותמות הזמן שאליהן ניגשים דרך MongoSQL Interface הן לפי שעון UTC. ‫Looker לא ממיר אזורי זמן במסד נתונים לחיבורי MongoDB.

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

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

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