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

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

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

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

דוגמה לשימוש

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

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

## 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 = מדידה
• ‫F = סינון
• ‫P = Parameter

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