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 Schema Builder ב-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

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

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

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

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

  1. מתחברים אל MongoDB Atlas Console.
  2. נווטו לאשכול שלכם ולחצו על התחברו.
  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 מתייחסות לזמן אוניברסלי מתואם (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
אלפיות שנייה
מיקרו-שניות
תצוגות מהותיות
מדדים של השוואה בין תקופות שונות
ספירה משוערת של ערכים ייחודיים
מודלים לניתוח נתונים במסד הנתונים
יומנים בהתאמה אישית