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 לרשימת גישה של 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 Console.
  2. בתפריט הניווט הראשי, בקטע אבטחה, בוחרים באפשרות גישה למסד נתונים.
  3. לוחצים על הוספת משתמש חדש למסד הנתונים.
  4. בוחרים באפשרות סיסמה כשיטת האימות. מזינים שם משתמש (לדוגמה, looker) וסיסמה מאובטחת.
  5. בקטע Database User Privileges (הרשאות משתמש במסד נתונים), בוחרים באפשרות Built-in Role (תפקיד מובנה) ומקצים את התפקיד read (או הרשאות קריאה בהתאמה אישית) למסד הנתונים שאליו Looker יקבל גישה.
  6. לוחצים על הוספת משתמש כדי לשמור את פרטי הכניסה של המשתמש.

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

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

  1. מתחברים אל MongoDB Atlas Console.
  2. עוברים לאשכול ולוחצים על Connect (חיבור).
  3. בוחרים באפשרות Atlas SQL (או Connect your application using SQL).
  4. בוחרים באפשרות JDBC Driver (מנהל התקן JDBC).
  5. שימו לב לדרישות ה-SSL, למארח, ליציאה (בדרך כלל 27017) ולמסד נתונים שנוצרו. תצטרכו להזין את הפרטים האלה כשיוצרים את החיבור ל-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.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 מצטברות
אלפיות השנייה
מיקרו-שניות
תצוגות מהותיות
מדדים של השוואה בין תקופות שונות
ספירה משוערת של ערכים ייחודיים
מודלים אנליטיים במסד הנתונים
יומנים בהתאמה אישית