פרמטרים של Explore

בדף הזה יש קישורים לכל הפרמטרים של LookML שהם צאצאים של הפרמטר explore.

ניתוח ב-Explore משמש כנקודת התחלה לשאילתה באפליקציית Looker. ה-Explores (חקירות) מתייחסים לתצוגות, וכל Explore יכול להכיל joins לתצוגות אחרות. בדרך כלל, צריך להצהיר על תכונות Explore בקובץ מודל.

דוגמה לשימוש

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

## STRUCTURAL PARAMETERS

explore: explore_name {
  extension: required
  extends: [explore_name,  explore_name, ...]
  fields: [field_or_set, field_or_set, ...]
  tags: ["string1", "string2", ...]

  # DISPLAY PARAMETERS
  description: "Description I want"
  group_label: "Label to use as a heading in the Explore menu"
  hidden: yes | no
  label: "desired label"
  query:  {
      # Desired query parameters (described on the query page)      }
  view_label: "Field picker heading I want for the Explore's fields"

  # FILTER PARAMETERS

  access_filter: {
    field: fully_scoped_field
    user_attribute: user_attribute_name
  }

  # Possibly more access_filter declarations

  always_filter: {
    filters: [field_name: "filter expression", field_name: "filter expression", ...]
  }
  case_sensitive: yes | no
  conditionally_filter: {
    filters: [field_name: "filter expression", field_name: "filter expression", ...]
    unless: [field_name, field_name, ...]
  }
  sql_always_having: SQL HAVING condition ;;
  sql_always_where: SQL WHERE condition ;;

  # JOIN PARAMETERS

  always_join: [view_name, view_name, ...]
  join: view_name {
    # Desired join parameters (described on Join Parameters page)
  }
  # Possibly more join declarations

  # QUERY PARAMETERS

  autogenerate_primary_keys: yes | no
  cancel_grouping_fields: [fully_scoped_field, fully_scoped_field, ...]
  from: view_name
  persist_for: "N (seconds | minutes | hours)"
  persist_with: datagroup_name
  required_access_grants: [access_grant_name, access_grant_name, ...]
  sql_table_name: table_name ;;
  sql_preamble: SQL STATEMENT  ;;
  symmetric_aggregates: yes | no
  view_name: view_name

  # AGGREGATE TABLE PARAMETERS

  aggregate_table: table_name {
    query:  {
      # Desired query parameters (described on the aggregate_table page)
    }
    materialization:  {
      # Desired materialization parameters (described on the aggregate_table page)
    }
  }
  # Possibly more aggregate_table declarations
}

## REFINEMENT PARAMETERS

explore: +explore_name {
  final: yes
}

הגדרות הפרמטרים

שם הפרמטר	תיאור
פרמטרים מבניים
‫extends (ב-Explore)	מציין את הניתוחים שיורחבו על ידי הניתוח הזה
‫extension (ב-Explore)	המדיניות הזו קובעת שהתכונה 'חיפוש' דורשת תוסף ולא ניתן לחשוף אותה למשתמשים
explore (למאפיין model)	הצגת תצוגה בתפריט 'ניתוח נתונים'
‫fields (ב-Explore)	מגביל את השדות שזמינים בניתוח מהתצוגה הבסיסית שלו ודרך הצטרפויות של הניתוח
‫tags (ב-Explore)	מציין טקסט שאפשר להעביר לאפליקציות אחרות
הצגת פרמטרים
‫description (ב-Explore)	מוסיף תיאור לניתוח ב-Explore שמוצג למשתמשים בממשק המשתמש
‫group_label (ב-Explore)	יוצר תווית קבוצה לשימוש ככותרת בתפריט 'חיפוש'
‫hidden (ב-Explore)	הסתרה של ניתוח Explore מתפריט הכרטיסייה 'מה חדש'
‫label (ב-Explore)	משנה את האופן שבו ניתוח מופיע בתפריט 'ניתוח'
‫query (ב-Explore)	יוצר שאילתה מוגדרת מראש שהמשתמשים יכולים לבחור בתפריט 'התחלה מהירה' של ניתוח.
‫view_label (ב-Explore)	מאפיין שמציין איך קבוצת שדות מתצוגת הבסיס של התכונה 'ניתוח נתונים' תתויג בכלי לבחירת שדות
פרמטרים של מסננים
access_filter	הוספת מסננים ספציפיים למשתמש לניתוח
always_filter	הוספת מסננים שמשתמש יכול לשנות, אבל לא להסיר, לניתוח
‫case_sensitive (ב-Explore)	מציינת אם המסננים תלויי אותיות רישיות ב'ניתוח נתונים'
conditionally_filter	הוספת מסננים לניתוח ב-Explore אם המשתמש לא מוסיף מסנן משלו מרשימה ספציפית
sql_always_having	הוספת תנאים לסעיף HAVING של השאילתה, שהמשתמש לא יכול לשנות או להסיר ב-Explore הזה
sql_always_where	הוספת תנאים לסעיף WHERE של השאילתה, שהמשתמש לא יכול לשנות או להסיר ב-Explore הזה
פרמטרים של הצטרפות
always_join	מגדירה אילו הצטרפויות תמיד יחולו על Explore
join	צירוף תצוגה נוספת ל-Explore. מידע נוסף על פעולות איחוד והפרמטרים שלהן זמין בדף העזר בנושא פרמטרים של פעולות איחוד.
פרמטרים של שאילתה
‫autogenerate_primary_keys (ב-Explore)	המתג מפעיל או משבית את היצירה האוטומטית של מפתח ראשי
cancel_grouping_fields	ביטול הסעיף GROUP BY כשבוחרים שדות מסוימים ב'אפשרויות נוספות'
‫from (ב-Explore)	מציין את התצוגה שעליה יתבסס הניתוח ב-Explore, ומפנה לשדות של התצוגה הזו לפי השם של הניתוח ב-Explore
‫persist_for (ב-Explore)	שינוי הגדרות המטמון של ניתוח נתונים
‫persist_with (ב-Explore)	מציין את קבוצת הנתונים שבה יש להשתמש בשביל מדיניות השמירה במטמון של הכלי 'ניתוח נתונים'
‫required_access_grants (ב-Explore)	מגבילה את הגישה לכלי 'ניתוח נתונים' רק למשתמשים שערכי מאפייני המשתמש שלהם תואמים להרשאות הגישה
‫sql_table_name (ב-Explore)	מציין את טבלת מסד הנתונים שעליה יתבסס הניתוח ב-Explore
symmetric_aggregates	המדיניות הזו קובעת אם צבירה סימטרית מופעלת בדוח ניתוח.
‫view_name (ב-Explore)	מציין את התצוגה שעליה יתבסס הניתוח ב-Explore, ומפנה לשדות של התצוגה הזו לפי שם התצוגה
פרמטרים של טבלה מצטברת
aggregate_table	יוצר טבלת צבירה כדי להשתמש בצבירה מודעת לשאילתות בניתוח. מידע על הפרמטר aggregate_table זמין בדף הפרמטר aggregate_table. סקירה כללית על מודעות מצטברת מופיעה בדף התיעוד בנושא מודעות מצטברת.
query	מגדיר את השאילתה לטבלה מסכמת. מידע על query ועל הפרמטרים המשניים שלו זמין בדף הפרמטר aggregate_table.
materialization	המאפיין מגדיר את אסטרטגיית ההתמדה של הטבלה המצטברת. מידע על materialization ועל הפרמטרים המשניים שלו זמין בדף הפרמטר aggregate_table.
פרמטרים לשיפור
explore: +explore_name	מוסיפים סימן פלוס (+) לפני שם קיים של ניתוח ב-Explore כדי להוסיף שיפור לניתוח הקיים. מידע נוסף ותרחישי שימוש מופיעים בדף שיפורים ב-LookML.
final	הערך הזה מציין שהסינון הנוכחי הוא הסינון הסופי שמותר לביצוע ב'ניתוח נתונים חכם'. מידע נוסף ותרחישי שימוש מופיעים בדף שיפורים ב-LookML.
פרמטרים שכדאי להימנע מהם
access_filter_fields	הוסר 6.0 הוחלף על ידי access_filter