פרמטרים של Explore

בדף הזה מפורטים כל הפרמטרים של LookML שהם צאצאים של הפרמטר 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 (למודל)	הצגת תצוגה בתפריט 'ניתוח נתונים'
‫fields (ב-Explore)	הגבלת השדות שזמינים בניתוח מהתצוגה הבסיסית שלו ודרך הצטרפויות הניתוח
‫tags (ב-Explore)	מציין טקסט שאפשר להעביר לאפליקציות אחרות
פרמטרים של תצוגה
‫description (ב-Explore)	הוספת תיאור לניתוח ב-Explore שמוצג למשתמשים בממשק המשתמש
‫group_label (ב-Explore)	יוצר תווית לקבוצה לשימוש ככותרת בתפריט 'חיפוש'
‫hidden (ב-Explore)	הסתרת אפשרות נוספת מהתפריט 'אפשרויות נוספות'
‫label (ב-Explore)	שינוי האופן שבו ניתוח מופיע בתפריט 'ניתוחים'
‫query (ב-Explore)	יוצר שאילתה מוגדרת מראש שהמשתמשים יכולים לבחור בתפריט 'התחלה מהירה' של ניתוח.
‫view_label (ב-Explore)	מציין איך קבוצת שדות מתצוגת הבסיס של הניתוח תסומן בכלי לבחירת שדות
פרמטרים של מסננים
access_filter	הוספת מסננים ספציפיים למשתמש לניתוח
always_filter	הוספת מסננים שמשתמש יכול לשנות, אבל לא להסיר, לניתוח
‫case_sensitive (ב-Explore)	מציינים אם המסננים תלויי אותיות רישיות ב-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)	שינוי הגדרות המטמון של ניתוח ב-Explore
‫persist_with (ב-Explore)	מציין את קבוצת הנתונים שבה יש להשתמש בשביל מדיניות השמירה במטמון של הכלי 'ניתוח נתונים'
‫required_access_grants (ב-Explore)	מגבילה את הגישה ל'ניתוח נתונים' רק למשתמשים שערכי מאפייני המשתמש שלהם תואמים להרשאות הגישה
‫sql_table_name (ב-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