הדף הזה מקשר לכל הפרמטרים של 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 = מדידה
- 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 | מצהירה על רשימת השדות שיוצגו כשמתבצעת הסתעפות של המדד או המאפיין |
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 | הסתרת שדה מממשק המשתמש של Explore |
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 שולח שאילתות למסד הנתונים כדי לספק הצעות לערכים של שדה במסנן של Explore. Looker יכול להשתמש בשאילתת SELECT DISTINCT בסיסית, או בלוגיקה המלאה של Explore, כולל צירופים ופרמטרים של 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 | מציינת רשימה של מילים נרדפות (מילים או ביטויים) שיכולות לעזור למודלים גדולים של שפה (LLM) ולמפתחי אפליקציות להבין דרכים אחרות שבהן משתמשים עשויים להתייחס לשדה |
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 |