פרמטרים של שדות

בדף הזה יש קישורים לכל הפרמטרים של LookML שמגדירים שדות.

יש כמה סוגים של שדות:

• מאפיינים מייצגים עמודה בטבלה, או ערך מחושב שמבוסס על סוג כלשהו של מניפולציה או שילוב של עמודות
• קבוצות של מאפיינים משמשות רק עם נתונים שמבוססים על זמן, ומאפשרות ליצור הרבה מאפיינים שמבוססים על זמן בבת אחת
• מדדים דומים לפונקציות מצטברות ב-SQL (לדוגמה, COUNT, ‏ SUM, ‏ AVG) ומייצגים מידע על כמה שורות
• מסננים יוצרים שדה לסינון בלבד, שמשתמשים יכולים להזין בו קלט למסנן מבוסס-תבנית או לצירוף מותנה
• פרמטרים יוצרים שדה סינון בלבד שמשתמשים יכולים להזין בו קלט לתג Liquid‏ {% parameter %}

דוגמה לשימוש

מצמידים את מצביע העכבר לשם של פרמטר כדי לראות תיאור קצר. לוחצים על שם של פרמטר כדי לעבור לדף ההפניה שלו.

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

## STRUCTURAL PARAMETERS
view: view_name {
  (dimension |dimension_group |measure |filter | parameter):field_name{
    intervals: [interval, interval, …]
    timeframes: [timeframe, timeframe, …]

    # ACTION AND LINKING PARAMETERS
    action: {
      label: "Label to Appear in Action Menu"
      url: "url"
      icon_url: "url"
      form_url: "url"
      param: {
        name:  "name string"
        value:  "value string"
      }
      # Possibly more param definitions
      form_param: {
        name:  "title"
        type: select | string | textarea
        label:  "desired label name"
        required:  yes | no
        default:  "value string"
        option: {
          name:  "name string"
          value:  "value string"
        }
        # Possibly more option definitions
      }
      # Possibly more form_param definitions
    }
    drill_fields: [field_or_set, field_or_set, ...]
    tags: ["string1", "string2", ...]
    link: {
      label: "desired label name;"
      url: "desired_url"
      icon_url: "url_of_an_image_file"
    }
    # Possibly more link definitions
    # DISPLAY PARAMETERS
    alias: [old_field_name, old_field_name, ...]
    alpha_sort: yes | no
    description: "description string"
    group_label:  "desired group label name"
    group_item_label:  "label to use under the group label in the field picker"
    hidden: yes | no
    label: "desired label name"
    label_from_parameter: parameter_name
    order_by_field: dimension_name | dimension_group_name | measure_name 
    style: classic | interval | integer | relational
    view_label: "desired label name"

    # FILTER PARAMETERS
    can_filter: yes | no
    case_sensitive: yes | no
    filters: [dimension: "filter expression", dimension: "filter expression", ...]
    skip_drill_filter: yes | no

    # FILTER SUGGESTION PARAMETERS
    allowed_value: {
      label: "desired label name"
      value: "looker filter expression"
    }
    # Possibly more allowed_value definitions
    bypass_suggest_restrictions: yes | no
    full_suggestions: yes | no
    suggest_dimension: dimension_name
    suggest_explore: explore_name
    suggest_persist_for: "N (seconds | minutes | hours)"
    suggestable: yes | no
    suggestions: ["suggestion string", "suggestion string", "…"]<

    # QUERY PARAMETERS
    allow_approximate_optimization: yes | no
    approximate: yes | no
    approximate_threshold: N
    convert_tz: yes | no
    datatype: epoch | timestamp | datetime | date | yyyymmdd
    fanout_on: repeated_record_name
    precision: N
    primary_key: yes | no
    required_access_grants: [access_grant_name, access_grant_name, ...]
    required_fields: [field_name, field_name, ...]
    sql_distinct_key: SQL expression to define repeated entities ;;

    # VALUE AND FORMATTING PARAMETERS
    case: {
      when: {
        sql: SQL condition ;;
        label: "value"
      }
      # Possibly more when statements
    }
    default_value: "desired default value"
    direction: "row | column"
    end_location_field: dimension_name
    html: HTML expression using Liquid template elements ;;
    list_field: dimension_name

    percentile: Nth percentile
    sql: SQL expression to generate the field value ;;
    sql_end: SQL expression indicating the end time of a duration ;;
    sql_latitude: SQL expression to generate a latitude ;;
    sql_longitude: SQL expression to generate a longitude ;;
    sql_start: SQL expression indicating the start time of a duration ;;
    start_location_field: dimension_name
    synonyms: [synonym1, synonym2, ...]
    tiers: [N, N, ...]
    type: dimension_field_type # For a dimension field
    type: dimension_group_type # For a dimension_group field
    type: measure_field_type   # For a measure field
    type: filter_field_type    # For a filter field
    type: parameter_field_type # For a parameter field
    string_datatype: unicode # For a dimension field
    units: feet | kilometers | meters | miles | nautical_miles | yards
    value_format: "excel-style formatting string"
    value_format_name: format_name

    # VISUALIZATION PARAMETERS
    allow_fill: yes | no
    map_layer_name: name_of_map_layer
  }
}

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

• ‫D = מאפיין
• ‫DG = קבוצת מאפיינים
• ‫M = Measure
• ‫F = סינון
• ‫P = פרמטר

שם הפרמטר	סוגי שדות תקינים	תיאור
פרמטרים מבניים
dimension	D	יצירת שדה מאפיין
dimension_group	DG	יצירה של כמה מאפיינים מבוססי-זמן בו-זמנית
filter	F	יצירת שדה לסינון בלבד לשימוש במסנן מבוסס-תבנית או בצירוף מותנה
measure	M	יצירת שדה מדד
parameter	P	יוצר שדה למסנן בלבד, שמשתמשים יכולים להזין בו קלט לתג Liquid‏ {% parameter %}
intervals	DG	הגדרת קבוצת מאפייני משך הזמן שרוצים ב-dimension_group של type: duration
timeframes	DG	ההגדרה הזו מגדירה את קבוצת המאפיינים של טווחי הזמן שרוצים בdimension_group של type: time
פרמטרים של פעולות וקישורים
action	D M	יוצר פעולת נתונים בשדה שמאפשרת למשתמשים לבצע משימות בכלים אחרים, ישירות מ-Looker
drill_fields	D DG M	הצהרה על רשימת השדות שיוצגו כשמבצעים Drill down במדד או במאפיין
link	D M	יצירת קישורים לתוכן אחר ב-Looker ולתוכן חיצוני
tags	D DG M F P	הוספת טקסט שאפשר להעביר לאפליקציות אחרות כדי לספק נתונים על שדה
הצגת פרמטרים
alias	D DG M F P	מאפשר לכתובות URL שנשמרו עם שמות שדות ישנים להמשיך לפעול אחרי ששם של שדה משתנה
alpha_sort	D	הפרמטר case גורם למיון התנאים שלו לפי סדר אלפביתי
description	D DG M F P	מוסיף תיאור לשדה שהמשתמשים יכולים לראות כשמעבירים את העכבר מעל השדה.
group_label	D DG M F	קיבוץ שדות בתצוגה בבוחר השדות
group_item_label	D DG M F	מציין תווית לשימוש בשדה מתחת לתווית הקבוצה שלו בבורר השדות
hidden	D DG M F P	הסתרת שדה מממשק המשתמש של 'ניתוח נתונים'
label	D DG M F P	שינוי האופן שבו שם השדה מופיע בכלי לבחירת שדות
label_from_parameter	D M	משנה את האופן שבו שם שדה מופיע בהדמיה על סמך הקלט של parameter
order_by_field	D DG M	מיון שדה לפי הערכים של שדה אחר נתמך במאפיינים ובקבוצות של מאפיינים תמיכה במדדים
style	D	משנה את האופן שבו רמות מופיעות בממשק המשתמש של Looker עבור מאפיין של type: tier
view_label	D DG M F P	שינוי השדות שמופיעים בתצוגה בכלי לבחירת שדות
פרמטרים של מסננים
can_filter	D DG M	קובעת אם אפשר להשתמש במאפיין או במדד כמסנן
case_sensitive	D F	קובע אם המסננים תלויי אותיות רישיות (case-sensitive) לגבי מאפיין
filter	F	יוצר שדה לסינון בלבד לשימוש במסנן מבוסס-תבנית
filters	M	הפונקציה מגבילה את החישוב של מדד מסוים על סמך מגבלות של מאפיין
skip_drill_filter	D	הגדרה שמונעת הוספה של מאפיין לפילטרים כשמבצעים פירוט של מדד
פרמטרים של הצעות לסינון
allowed_value	P	מציין את האפשרויות של parameter
bypass_suggest_restrictions	D DG F P	הצגת הצעות למשתמשים כשמשתמשים ב-sql_always_where, אבל לא חלות הגבלות על ההצעות
full_suggestions	D DG F P	ההגדרה הזו קובעת איך Looker שולח שאילתות למסד הנתונים כדי לספק הצעות לערכים של שדה במסנן של כלי הניתוח. ‫Looker יכול להשתמש בשאילתת SELECT DISTINCT בסיסית, או להשתמש בלוגיקה המלאה של הכלי 'ניתוח נתונים', כולל הצטרפויות ופרמטרים של sql_always_where ושל access_filter.
suggest_dimension	D DG M F P	מבוסס על הערכים של מאפיין אחר כדי להציע הצעות לשדה
suggest_explore	D DG M F P	ההצעות לשדה מבוססות על הערכים של תרשים אחר ב-Explore
suggest_persist_for	D F P	שינוי הגדרות המטמון של הצעות למסננים ב-Looker
suggestable	D DG M F P	הפעלה או השבתה של הצעות לשדה
suggestions	D F P	התג הזה מגדיר רשימה של ערכים שישמשו להצעות של שדה
פרמטרים של שאילתה
allow_approximate_optimization	M	מאפשר קירובים של ספירה נפרדת למדדים של type: count או type: count_distinct, כדי שאפשר יהיה להשתמש במדד לצורך הגברת המודעות
approximate	M	מבצעת ספירה משוערת למדד של type: count_distinct. רשימת הניבים שתומכים בפרמטר הזה מופיעה בדף התיעוד של approximate.
approximate_threshold	M	מגדיר את המספר שבו BigQuery עובר מספירה מדויקת של ערכים ייחודיים לספירה משוערת של ערכים ייחודיים
convert_tz	D DG M F P	השבתה של המרת אזור זמן אוטומטית בשדה
datatype	D DG F M	מציין את סוג נתוני הזמן שאתם מספקים לשדה
fanout_on	D DG M	מאפשר גישה לשדות חוזרים ב-Google BigQuery
precision	M	מציין את מספר הספרות אחרי הנקודה העשרונית שבהן יש להשתמש כשמבצעים חישובים של צבירות סימטריות ב-Looker
primary_key	D	הצהרה על מאפיין כמפתח הראשי של תצוגה
required_access_grants	D DG F M P	מגביל את הגישה לשדה רק למשתמשים שערכי התכונות שלהם תואמים להרשאות הגישה
required_fields	D M	נדרש להוסיף שדות נוספים לשאילתה כשבוחרים שדה
sql_distinct_key	M	הגדרת הישויות הייחודיות שעליהן יחושב מדד של type: sum_distinct או type: average_distinct
פרמטרים של ערך ועיצוב
case	D	יוצרת קבוצה נפרדת של ערכים שיכולים להיות למאפיין, שנקבעים על ידי תנאי SQL
default_value	F P	מציין ערך ברירת מחדל עבור שדות מסנן
direction	M	קובע את הכיוון שבו מחושב מדד של type: percent_of_total או type: running_total כשמשתמשים בטבלאות ציר
end_location_field	D	השדה שמכיל את מיקום הסיום של שדה מסוג type: distance
html	D DG M	שינוי פלט ה-HTML של שדה באמצעות תבניות Liquid
list_field	M	הפונקציה מכריזה על המאפיין שממנו יחושב מדד של type: list
percentile	M	מציינים את הערך השברי (האחוזון ה-N) למדד של type: percentile או type: percentile_distinct
sql	D DG M F	קובע איך שדה יחושב
sql_end	D DG	המאפיין מגדיר את שעת הסיום של משך הזמן של קבוצת מאפיינים מסוג משך זמן או של מאפיין מסוג משך זמן
sql_latitude	D	הגדרת קו הרוחב של מאפיין של type: location
sql_longitude	D	הגדרת קו האורך של מאפיין של type: location
sql_start	D DG	המאפיין מגדיר את זמן ההתחלה של משך הזמן עבור קבוצת מאפיינים מסוג משך זמן או מאפיין מסוג משך זמן
start_location_field	D	הגדרת השדה שמכיל את מיקום ההתחלה של שדה מסוג type: distance
synonyms	D DG F M P	מציינים רשימה של מילים נרדפות (מילים או ביטויים) שיכולות לעזור למודלים גדולים של שפה ולמפתחי אפליקציות להבין דרכים אחרות שבהן משתמשים עשויים להתייחס לשדה
tiers	D	הגדרת הרמות של מאפיין type: tier
‫type (למאפיין, למסנן או לפרמטר)	D F P	מציין את הסוג של המאפיין, המסנן או הפרמטר
type (לקבוצת מאפיינים)	DG	מציין את סוג קבוצת המאפיינים
type (למדידה)	M	מציין את סוג המדד
string_datatype	D	מציין את סוג הנתונים של Unicode בשדה של type: string ל-SQL Server או ל-MySQL
units	D	הגדרת היחידות שבהן יש להשתמש בשדה של type: distance
value_format	D M	עיצוב הפלט של שדה באמצעות אפשרויות בסגנון Excel
value_format_name	D M	עיצוב הפלט של שדה באמצעות פורמט מובנה או פורמט בהתאמה אישית
פרמטרים של המחשה
allow_fill	D DG	קובעת אם מותר למלא מאפיין מסוים
map_layer_name	D	מציין מיפוי מערך נתונים לאזור גיאוגרפי שהגדרתם במפה מובנית או במפה בהתאמה אישית
פרמטרים שכדאי להימנע מהם
decimals	D M	הוסרה גרסה 5.4 הוחלפה ב-value_format
format	D M	הוסר 3.16 הוחלף על ידי value_format