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

הדף הזה מקשר לכל הפרמטרים של 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