sql_analytic_model_name (לניתוחים)

בדף הזה מוסבר על הפרמטר sql_analytic_model_name שהוא חלק מניתוח.

אפשר להשתמש ב-sql_analytic_model_name גם כחלק מתצוגה מפורטת, כמו שמתואר בדף התיעוד של הפרמטר sql_analytic_model_name (לתצוגות מפורטות).

Usage

explore: explore_name {
  sql_analytic_model_name: analytic_model_name ;;
}
היררכיה
explore
sql_analytic_model_name
ערך ברירת המחדל
ללא

אישור
שם של מודל ניתוח במסד נתונים

כללים מיוחדים
  • מודלים אנליטיים נתמכים רק בחיבורים ל-BigQuery ול-Snowflake.
  • sql_analytic_model_name צריך להשתמש ב-Explores רק אם אותה תצוגה יכולה לתאר כמה מודלים אנליטיים במסד הנתונים.
  • מודל הניתוח שאליו מתייחס sql_analytic_model_name צריך להיות נגיש בחיבור למסד הנתונים של המודל שלו.
  • אם המודל האנליטי נמצא במסד נתונים, בסכימה, בפרויקט או במערך נתונים שונים מהנתיב שמוגדר כברירת מחדל בחיבור למסד הנתונים, צריך להגדיר את ההיקף של שם המודל האנליטי.

הגדרה

בחיבורים ל-BigQuery ול-Snowflake, הפרמטר sql_analytic_model_name מציין את השם של מודל ניתוח קיים במסד הנתונים (גרף BigQuery או תצוגה סמנטית ב-Snowflake) שמשמש כבסיס לרכיב Explore ב-LookML.

ברוב המקרים, משתמשים בפרמטר sql_analytic_model_name (לתצוגות מפורטות) כדי לציין מודל ניתוח בקובץ התצוגה המפורטת. לאחר מכן, בקובץ התצוגה הזה, מגדירים מדדים ומאפיינים של LookML שמבוססים על המודל האנליטי במסד הנתונים. עם זאת, במקרים שבהם במסד הנתונים יש כמה מודלים אנליטיים שאפשר להגדיר באמצעות אותם שדות LookML, אפשר להשתמש בפרמטר sql_analytic_model_name מתחת לפרמטר explore.

כשמציינים sql_analytic_model_name מתחת לפרמטר explore, כלי הניתוח יבטל את המודל האנליטי שצוין בקובץ התצוגה ויבצע במקומו שאילתה על המודל האנליטי שצוין ב-sql_analytic_model_name מתחת לפרמטר explore. במקרה כזה, בדוח הניתוח המפורט ישמשו המדדים והמאפיינים של LookML שמוגדרים בקובץ התצוגה המפורטת, אבל הם יחולו על המודל האנליטי שצוין בפרמטר sql_analytic_model_name של הפרמטר explore.

הגדרת היקף לשמות של מודלים אנליטיים

כשמפנים למודל ניתוח באמצעות השם של מודל הניתוח בלבד, Looker משתמש בנתיב החיפוש שמוגדר כברירת מחדל (מסד הנתונים והסכימה) שהאדמין של Looker הגדיר בהגדרות של חיבור מסד הנתונים.

אם אתם צריכים להפנות למודל אנליטי במסד נתונים ובסכימה אחרים שלא נמצאים בנתיב החיפוש שמוגדר כברירת מחדל למשתמש במסד הנתונים, אתם יכולים להגדיר את היקף השם של המודל האנליטי באמצעות הפורמט <database_name>.<schema_name>.<analytic_model_name> כדי להפנות למסד נתונים או לסכימה אחרים:

  • כדי להפנות למודל ניתוח מסכימה אחרת, משתמשים בפונקציה <schema_name>.<analytic_model_name>.
  • כדי להפנות למודל ניתוח ממאגר נתונים אחר, צריך להשתמש ב<database_name>.<schema_name>.<analytic_model_name> המלא.

בחיבור ל-Google BigQuery, אפשר להפנות למודל ניתוח בפרויקט ובמערך נתונים אחרים על ידי הגדרת היקף השם של מודל הניתוח באמצעות הפורמט <project_name>.<dataset_name>.<analytic_model_name>. מידע נוסף זמין בדף חיבור ל-Google BigQuery.

דוגמה

הנה דוגמה לתצוגת LookML בשם MyStoreGraphView שמבוססת על StoreGraph BigQuery Graph במסד נתונים של BigQuery, כולל מאפיינים ומדדים שממופים ל-Graph:

view: MyStoreGraphView {
  sql_analytic_model_name: StoreGraph ;;

  dimension: location_id {
    type: number
    sql: Stores_location_id ;;
  }

  dimension: population {
    type: number
    sql: Locations_population ;;
  }

  dimension: location_name {
    type: string
    sql: Locations_name ;;
  }

  measure: locations_total_population {
    type: number
    sql: Locations_total_population ;;
  }
}

בהנחה שלמסד הנתונים יש גרף נוסף בשם ShopDetailsGraph עם אותם אלמנטים כמו StoreGraph, הנה ניתוח שמבטל את הערך sql_analytic_model_name בקובץ התצוגה MyStoreGraphView. לניתוח יהיו אותם מאפיינים ומדדים של LookML שמוגדרים ב-MyStoreGraphView, אבל הניתוח ישלח שאילתה למודל הניתוח ShopDetailsGraph:

explore: MyStoreGraphView {
  sql_analytic_model_name: ShopDetailsGraph ;;
}

דברים שכדאי לקחת בחשבון

שיקולים לגבי מודלים אנליטיים ב-Looker

כשמשתמשים במודלים אנליטיים בתוך מסד נתונים, חשוב להביא בחשבון את השיקולים והמגבלות הבאים:

  • סוגי נתונים: יש תמיכה רק בסוגי הנתונים הבאים של מאפיינים ומדדים במודלים אנליטיים:

    • נתמך במאפיינים ובמדדים:
      • string
      • number
      • date
      • yesno
    • נתמך רק במאפיינים:
      • time
      • date_time

  • מדדים:

    • צריך להגדיר מראש את המדדים הבסיסיים: צריך להגדיר מראש את המדדים הבסיסיים במודל הניתוח של מסד הנתונים הבסיסי. ‫Looker לא יכול להגדיר מדד בסיסי חדש על ידי ביצוע צבירה (כמו type: sum או type: count) על מאפיין ממודל ניתוח.

    • יש תמיכה במדדים שמבוססים על מדדים אחרים: אפשר להשתמש בפרמטר sql של מדד LookML כדי לבצע חישובים לא מצטברים שמשתמשים במדדי בסיס מוגדרים מראש מהמודל האנליטי. כשיוצרים מדד שמבוסס על מדדים אחרים, אי אפשר להגדיר את המדד החדש כסוג מדד מצטבר כמו sum או count. צריך להגדיר את המדד החדש כסוג מדד לא מצטבר, כמו string,‏ number,‏ date או yesno. מקרה לדוגמה:

      measure: average_order_amount {
  type: number
  sql: ROUND(${total_order_amount} / NULLIF(${count_orders}, 0), 2) ;;
}

  • צירופים: בניתוח שהתצוגה הבסיסית שלו מבוססת על מודל אנליטי, אי אפשר לכלול צירופים. באופן דומה, אי אפשר לצרף תצוגה שמבוססת על מודל ניתוח לניתוח נתונים שמבוסס על תצוגת בסיס רגילה של LookML.

  • צירופים מרומזים: לא ניתן להשתמש במודלים אנליטיים בתכונות שמסתמכות על צירופים מרומזים. דוגמאות לתכונות שמסתמכות על הצטרפות מרומזת הן יומנים מותאמים אישית ושדות שמוגדרים עם type: location,‏ type: distance או type: zipcode.

  • התכונות הבאות לא נתמכות במודלים אנליטיים:

צריכה להיות גישה למודל הניתוח מהחיבור הנוכחי

כשמשתמשים בפרמטר sql_analytic_model_name באובייקט explore, האובייקט explore הזה נכלל באובייקט model. (ההיררכיה בדף הזה מציגה את שרשרת הקשרים הזו). באובייקט המודל מוגדר מסד נתונים connection. כשמפנים למודל ניתוח בפרמטר sql_analytic_model_name, צריך לוודא שיש גישה למודל הניתוח בחיבור המשויך שצוין בקובץ המודל.

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