‫sql_analytic_model_name (לתצוגות)

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

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

Usage

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

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

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

הגדרה

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

בתרחיש הזה, אובייקט המודל האנליטי כבר קיים במסד הנתונים ומנוהל על ידי מסד הנתונים. המודל האנליטי לא נוצר, לא מתוחזק ולא כפוף ל-Looker. זה דומה למצב שבו טבלאות רגילות של מסד נתונים שנחשפות כתצוגות LookML באמצעות sql_table_name לא כפופות ל-Looker.

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

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

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

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

במסמכי התיעוד של הניב שלכם מוסבר מהו תחביר ה-SQL הנכון שצריך להשתמש בו כדי להתייחס לרכיבים במודל הניתוח. לדוגמה, כדי ליצור מאפיין LookML מישות של תרשים BigQuery, צריך להשתמש בקו תחתון כדי להפריד בין רכיבים כשמגדירים את ההיקף. לדוגמה, במקרה של BigQuery Graph, המאפיין הזה של LookML מבוסס על המאפיין location_id בטבלת הצמתים Stores:

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

עם זאת, כדי ליצור מאפיין LookML שמבוסס על תצוגה סמנטית של Snowflake, צריך להשתמש בשם לא מוסמך של מדד או מאפיין.

דוגמה

הנה דוגמה לגרף BigQuery בשם StoreGraph שמוגדר במסד נתונים של BigQuery:

CREATE OR REPLACE PROPERTY GRAPH mydataset.StoreGraph
  NODE TABLES (
    mydataset.Stores AS S,
    mydataset.Locations AS L
    PROPERTIES(id, name, population, MEASURE(SUM(population)) AS total_population)
  )
  EDGE TABLES (
    mydataset.Stores AS SL
    SOURCE KEY (location_id) REFERENCES L (id)
    DESTINATION KEY (name) REFERENCES S (name)
  );

זו דוגמה לתצוגת LookML שמבוססת על StoreGraph BigQuery Graph, כולל מאפיינים ומדדים שממופים ל-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 ;;
  }
}

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

שיקולים לגבי מודלים אנליטיים ב-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 באובייקט view, אפשר להפנות לאובייקט view הזה באובייקט explore, שאליו מפנים בתורו באובייקט model. באובייקט המודל מוגדר מסד נתונים connection. כשמפנים למודל ניתוח בפרמטר sql_analytic_model_name, צריך לוודא שיש גישה למודל הניתוח בחיבור המשויך שצוין בקובץ המודל.

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