פרמטרים של תרשימי טבלה ללוחות בקרה של LookML

בדף הזה מוסבר איך להוסיף ולהתאים אישית רכיב בלוח הבקרה של LookML מסוג type: looker_grid באמצעות פרמטרים של מרכז שליטה של LookML בקובץ dashboard.lkml.

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

דוגמה לשימוש


## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_grid
height: N
width: N
top: N
left: N
row: N
col: N
refresh: N (seconds | minutes | hours | days)
note_state: collapsed | expanded
note_display: above | below | hover
note_text: 'note text'

## QUERY PARAMETERS
model: model_name
explore: explore_name
fields: [view_name.field_name, view_name.field_name, …]
dimensions: [view_name.field_name, view_name.field_name, …]
measures: [view_name.field_name, view_name.field_name, …]
sorts: [view_name.field_name asc | desc, view_name.field_name, …]
pivots: [view_name.field_name, view_name.field_name, …]
fill_fields: [view_name.field_name, view_name.field_name, …]
subtotals: [view_name.field_name, view_name.field_name, …]
total: true | false
row_total: right | left | false
limit: N
column_limit: N
filters:
  view_name.field_name: 'Looker filter expression' | 'filter value'
filter_expression:  'Looker custom filter expression'
listen:
  dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone
analysis_config: # can only be used when the Forecasting Labs feature is enabled
  forecasting:
  - confidence_interval: N
    field_name: view_name.field_name
    forecast_n: N
    forecast_interval: day | month | a time frame with dimension fill
    seasonality: N
merged_queries:
- 'primary query definition'
- 'next source query definition'
  join_fields:
  - field_name: view_name.field_name
    source_field_name: view_name.field_name

## COLUMN PARAMETERS
auto_size_all_columns: true | false
column_order: [view_name.field_name, view_name.field_name, …]
pinned_columns:
    view_name.field_name: left

## PLOT PARAMETERS
table_theme: editable | white | gray | transparent | unstyled
show_row_numbers: true | false
hide_totals: true | false
hide_row_totals: true | false
transpose: true | false
hidden_fields: [view_name.field_name, view_name.field_name, …]
limit_displayed_rows: true | false
limit_displayed_rows_values:
  show_hide: show | hide
  first_last: first | last
  num_rows: 'N'

## SERIES PARAMETERS
truncate_text: true | false
show_view_names: true | false
size_to_fit: true | false
dynamic_fields:
- table_calculation: {'table calculation definition'}
- measure: {'custom measure or custom filtered measure definition'}
- dimension: {'custom dimension definition'}
series_labels:
    view_name.field_name: 'Series Label'
series_column_widths:
    view_name.field_name: N
series_cell_visualizations:
    view_name.field_name:
        is_active: true | false
        palette:
            palette_id: 'palette ID'
            collection_id: 'collection ID'
            custom_colors:
            - 'color value'
        value_display: true | false
series_text_format:
    view_name.field_name:
        fg_color: 'color value'
        bg_color: 'color value'
        bold: true | false
        italic: true | false
        align: left | center | right
series_collapsed:
    view_name.field_name: true | false
series_value_format:
    view_name.field_name:
        format_string: 'value formatting string'

## FORMATTING PARAMETERS
color_application:
    collection_id: 'collection ID'
    palette_id: 'palette ID'
header_font_color: 'color value'
header_background_color: 'color value'
header_text_alignment: left | center | right
header_font_size: N
rows_font_size: N
enable_conditional_formatting: true | false
conditional_formatting_include_totals: true | false
conditional_formatting_include_nulls: true | false
conditional_formatting:
  {'desired conditional formatting'}

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

שם הפרמטר תיאור
פרמטרים בסיסיים
name (לרכיבים) יצירת רכיב
title (לרכיבים) שינוי האופן שבו שם הרכיב מוצג למשתמשים
type (לרכיבים) קובע את סוג התצוגה החזותית שבה ייעשה שימוש ברכיב
height (לרכיבים) מגדיר את הגובה של רכיב ביחידות של tile_size למרכזי בקרה מסוג layout: tile ו-layout: static
width (לרכיבים) מגדיר את הרוחב של רכיב ביחידות של tile_size למרכזי בקרה של layout: tile ו-layout: static
top מגדיר את המיקום מלמעלה למטה של רכיב ביחידות של tile_size במרכזי בקרה של layout: static
left מגדירה את המיקום של רכיב משמאל לימין ביחידות של tile_size במרכזי בקרה של layout: static
row מגדיר את המיקום מלמעלה למטה של רכיב ביחידות של שורות במרכזי בקרה של layout: newspaper
col מגדיר את המיקום של רכיב משמאל לימין ביחידות של עמודות במרכזי בקרה של layout: newspaper
refresh (לרכיבים) הגדרת מרווח הזמן שבו הרכיב יתרענן באופן אוטומטי
note_state ההגדרה קובעת אם ההערה תכווץ או תורחב אם היא גדולה מדי ולא נכנסת בשורה אחת ברוחב של הרכיב
note_display מגדיר איפה ההערה מוצגת ברכיב
note_text מציין את הטקסט שמוצג בהערה
פרמטרים של שאילתה
model הגדרת המודל שישמש לשאילתה של הרכיב
explore (לרכיבים) הגדרת ה-Explore שבו ייעשה שימוש בשאילתה של הרכיב
fields מגדיר את השדות שישמשו לשאילתה של הרכיב. אפשר להשתמש בו במקום dimensions ו-measures.
dimensions הגדרת המאפיינים שישמשו לשאילתה של הרכיב
measures הגדרת המדדים שישמשו לשאילתה של הרכיב
sorts הגדרת המיונים שישמשו לשאילתה של הרכיב
pivots הגדרת המאפיינים שצריך להפוך לציר כדי להשתמש בהם בשאילתה של הרכיב
fill_fields מגדיר את המאפיינים שמשתמשים באפשרות מילוי מאפיינים
subtotals מגדיר את השדות שבהם מחושב סכום הביניים
total ההגדרה קובעת אם סכומי העמודות יוצגו בתצוגה חזותית של טבלה
row_total ההגדרה הזו קובעת אם סכומי השורות יוצגו בתצוגה החזותית של הטבלה
limit הגדרת מגבלת השורות שבהן ייעשה שימוש בשאילתה של הרכיב
column_limit הגדרת מגבלת העמודות לשימוש בשאילתה של הרכיב
filters (לרכיבים) מגדיר את המסננים שאי אפשר לשנות בשאילתה של הרכיב
filter_expression הגדרה של מסנן מותאם אישית שאי אפשר לשנות בשאילתה של הרכיב
listen מגדיר את המסננים שאפשר לשנות בשאילתה של הרכיב, אם נוצרו filters (למרכז הבקרה)
query_timezone מגדיר את אזור הזמן שבו צריך להשתמש כשהשאילתה מופעלת
analysis_config נוסף בגרסה 21.14 מגדיר את ניתוח התחזית שצריך לבצע כשמריצים את השאילתה. צריך להפעיל את תכונת Labs Forecasting.
merged_queries מגדירה שאילתה של תוצאות ממוזגות
פרמטרים של עמודות
auto_size_all_columns משנה אוטומטית את הגודל של כל עמודה בטבלה לרוחב של כותרת העמודה או של ערך הנתונים הארוך ביותר, לפי מה שרחב יותר
column_order מסדר את העמודות בתרשים הטבלה
pinned_columns מגדיר את העמודות שיוצמדו או יוקפאו בצד שמאל של תרשים הטבלה
פרמטרים של תרשים
table_theme החלת אחת מחמש אפשרויות צביעה של טבלה על תצוגה חזותית של טבלה
show_row_numbers הגדרה אם להציג מספר שורה בתחילת כל שורה בטבלה
hide_totals ההגדרה קובעת אם בתצוגה החזותית של הטבלה יוצגו סכומי העמודות
hide_row_totals ההגדרה קובעת אם בתצוגה החזותית של הטבלה יוצגו סכומי השורות
transpose הגדרה אם להמיר שורות בטבלה לעמודות
hidden_fields מציין את השדות שבהם צריך להשתמש בשאילתה אבל להסתיר מהתרשים
limit_displayed_rows הצגה או הסתרה של שורות בתצוגה חזותית על סמך המיקום שלהן בתוצאות
פרמטרים של סדרות
truncate_text מקצר את הכותרות של העמודות ואת הטקסט בתוך תאי הנתונים באמצעות שלוש נקודות (…)
show_view_names הצגת שם התצוגה המפורטת לצד שם השדה של כל כותרת עמודה
size_to_fit הרוחב של כל העמודות משתנה באופן אוטומטי כך שהטבלה מתאימה בדיוק לרוחב של הרכיב שבו היא מוצגת
dynamic_fields כולל חישובים בטבלה או שדות בהתאמה אישית בתרשים הטבלה
series_labels מציינת תווית מותאמת אישית לכל עמודה בתצוגה החזותית
series_column_widths מציינת רוחב ספציפי לעמודות בתצוגה החזותית
series_cell_visualizations ההגדרה קובעת אם העמודות משתמשות באפשרות התצוגה החזותית Cell Visualization. לפרמטר הזה יש את תתי-הפרמטרים is_active,‏ palette ו-value_display.
series_text_format מציין את פריסת הטקסט בתא לכל עמודה. לפרמטר הזה יש את תתי-הפרמטרים fg_color,‏ bg_color,‏ bold,‏ italic ו-align.
series_collapsed מציינת אם עמודה שיש בה סכומי ביניים תופיע במצב מכווץ
series_value_format הגדרת פורמט הערך של עמודה באמצעות עיצוב מותאם אישית
פרמטרים של עיצוב
color_application הוספת צבעים לרכיבים חזותיים בתאים ולעיצוב מותנה
header_font_color החלת צבע גופן על כותרות העמודות
header_background_color החלת צבע על הרקעים של כותרות העמודות
header_text_alignment יישור לשמאל, לימין או למרכז של כותרות העמודות
header_font_size החלת גודל גופן על כותרות של עמודות
rows_font_size החלת גודל גופן על טקסט בתאי נתונים
enable_conditional_formatting מגדירים את הערך true כדי לקבוע כללים לקידוד צבעים בתצוגה חזותית של טבלה
conditional_formatting_include_totals מציינת אם הסכומים הכוללים נכללים בסכימת הקידוד בצבעים
conditional_formatting_include_nulls מציין אם ערכי null צריכים להיות מיוצגים כאפס
conditional_formatting משתמש ב-conditional_formatting ובתת-הפרמטרים שלו כדי להגדיר את הכללים שלפיהם הטבלה תסומן בצבעים

פרמטרים בסיסיים

כשמגדירים רכיב בלוח הבקרה של LookML, צריך לציין ערכים לפחות לפרמטרים name ו-type. פרמטרים בסיסיים אחרים כמו title,‏ height ו-width משפיעים על המיקום והמראה של רכיב במרכז הבקרה.

name

הקטע הזה מתייחס לפרמטר name שהוא חלק מרכיב בלוח הבקרה.

אפשר גם להשתמש ב-name כחלק ממסנן של מרכז הבקרה, כפי שמתואר בדף התיעוד פרמטרים של מרכז הבקרה.

כל הצהרה של name יוצרת רכיב חדש בלוח הבקרה ומקצה לו שם. שמות הרכיבים חייבים להיות ייחודיים. לפעמים יש הפניות לשמות בפרמטר elements כשמשתמשים במרכזי בקרה של layout: grid, או בפרמטר group של רכיבי צאצא כשמארגנים רכיבים בקבוצת משבצות (type: group).

- name: orders_by_date

title

הקטע הזה מתייחס לפרמטר title שהוא חלק מרכיב בלוח הבקרה.

אפשר להשתמש ב-title גם כחלק ממרכז בקרה, כפי שמתואר בדף התיעוד פרמטרים של מרכז הבקרה.

אפשר גם להשתמש ב-title כחלק ממסנן של מרכז הבקרה, כפי שמתואר בדף התיעוד פרמטרים של מרכז הבקרה.

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

לדוגמה:

- name: sales_overview
  title: '1) Sales Overview'

אם תשתמשו בפורמט הזה, במקום שהרכיב יופיע בתור סקירה כללית של מכירות, הוא יופיע בתור 1) סקירה כללית של מכירות.

type

הקטע הזה מתייחס לפרמטר type שהוא חלק מרכיב בלוח הבקרה.

אפשר גם להשתמש ב-type כחלק ממסנן של מרכז הבקרה, כפי שמתואר בדף התיעוד פרמטרים של מרכז הבקרה.

אפשר להשתמש ב-type גם כחלק מצירוף, כפי שמתואר בדף התיעוד של הפרמטר type (לצירופים).

אפשר להשתמש ב-type גם כחלק ממאפיין, כפי שמתואר בדף התיעוד סוגי מאפיינים, מסננים ופרמטרים.

אפשר להשתמש ב-type גם כחלק מיחידת מידה, כפי שמתואר בדף התיעוד סוגי יחידות מידה.

הפרמטר type קובע את סוג ההצגה החזותית שבה ייעשה שימוש ברכיב.

- name: element_name
  type: text | looker_grid | table | single_value | looker_single_record |
        looker_column | looker_bar | looker_scatter | looker_line | looker_area |
        looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
        looker_map | looker_google_map | looker_geo_coordinates | looker_geo_choropleth |
        looker_waterfall | looker_wordcloud | looker_boxplot | button | group

בדף התיעוד type (למרכזי בקרה של LookML) יש סקירה כללית של הסוגים השונים של רכיבים במרכז הבקרה של LookML.

height

הקטע הזה מתייחס לפרמטר height שהוא חלק מרכיב בלוח הבקרה.

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

למרכזי בקרה עם פריסות של tile או static

הפרמטר height מגדיר את הגובה של רכיב, ביחידות של tile_size (שמוגדר בפיקסלים), למרכזי בקרה של layout: tile ו-layout: static.

לדוגמה, הקוד הבא מציין את tile_size: 100 ו-height: 4, כך שהגובה של הרכיב orders_by_date הוא 400 פיקסלים.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    height: 4
    ...

למרכזי בקרה עם פריסת newspaper

הפרמטר height מגדיר את הגובה של רכיב, ביחידות של שורה, במרכזי בקרה מסוג layout: newspaper.

כברירת מחדל, לוח בקרה עם פריסת עיתון כולל רכיבים בגובה של 6 שורות, או כ-300 פיקסלים. הגובה המינימלי הוא שורה אחת למרכזי בקרה שבהם הפרמטר preferred viewer מוגדר לערך dashboards-next. הגובה המינימלי הוא 2 שורות למרכזי בקרה עם פרמטר preferred viewer שמוגדר ל-dashboards.

לדוגמה, הקוד הבא מגדיר רכיב בגובה של 12 שורות, או בגובה כפול מרכיבים אחרים שמוגדרים כברירת המחדל:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    height: 12
    ...

width

הקטע הזה מתייחס לפרמטר width שהוא חלק מרכיב בלוח הבקרה.

אפשר להשתמש ב-width גם כחלק ממרכז בקרה, כפי שמתואר בדף התיעוד פרמטרים של מרכז הבקרה.

הפרמטר width מגדיר את הרוחב של רכיב, ביחידות של tile_size, במרכזי הבקרה layout: tile ו-layout: static.

לדוגמה, הקוד הבא מציין את tile_size: 100 ו-width: 4, כך שרוחב הרכיב orders_by_date הוא 400 פיקסלים.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    width: 4
    ...

הפרמטר width מגדיר את הרוחב של רכיב, ביחידות של עמודות, במרכזי בקרה של layout: newspaper.

כברירת מחדל, הרוחב של מרכז בקרה עם פריסת עיתון הוא 24 עמודות.

לדוגמה, הקוד הבא מגדיר את הרכיב לחצי מהרוחב של מרכז הבקרה:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    width: 12
    ...

top

הפרמטר top מגדיר את המיקום של רכיב מלמעלה למטה, ביחידות של tile_size, במרכזי בקרה מסוג layout: static.

לדוגמה, הקוד הבא מציין את tile_size: 100 ו-top: 4, וממקם את הקצה העליון של הרכיב orders_by_date במרחק של 400 פיקסלים מהחלק העליון של מרכז הבקרה.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    top: 4
    ...

left

הפרמטר left מגדיר את המיקום של רכיב משמאל לימין, ביחידות של tile_size, במרכזי בקרה של layout: static.

לדוגמה, הקוד הבא מציין את tile_size: 100 ו-left: 4, וממקם את הקצה השמאלי של הרכיב orders_by_date במרחק של 400 פיקסלים מהצד השמאלי של מרכז הבקרה.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    left: 4
    ...

row

בלוחות הבקרה של layout: newspaper, הפרמטר row מגדיר את השורה שבה נמצא הקצה העליון של הרכיב. אם הרכיב ממוקם בתוך קבוצת משבצות באמצעות הפרמטר group, הפרמטר row מגדיר את מיקום השורה של הרכיב ביחס לחלק העליון של מאגר הקבוצה (row: 0).

לוח הבקרה מתחיל בשורה 0 בחלק העליון של לוח הבקרה. בלוח בקרה עם פריסת עיתון, גובה ברירת המחדל של רכיב בלוח הבקרה הוא 6 שורות. כלומר, רכיבי לוח הבקרה בחלק העליון של לוח הבקרה (row: 0) יתפסו כברירת מחדל את שורות 0-5.

הגובה של כל שורה הוא 50 פיקסלים, כלומר הגובה של רכיב ברירת המחדל של 6 שורות הוא 300 פיקסלים.

לדוגמה, הקוד הבא מגדיר רכיב שיופיע בשורה השנייה של הרכיבים במרכז הבקרה, בהנחה שהרכיבים מוגדרים בגובה ברירת המחדל:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    row: 6
    ...

col

בלוחות בקרה של layout: newspaper, הפרמטר col מגדיר את העמודה שבה ממוקם הקצה השמאלי של הרכיב. אם הרכיב ממוקם בתוך קבוצת משבצות באמצעות הפרמטר group, הפרמטר col מגדיר את מיקום העמודה של הרכיב ביחס לקצה השמאלי של מאגר הקבוצה (col: 0).

מרכזי הבקרה מחולקים ל-24 עמודות. מרכז הבקרה מתחיל בעמודה 0 בצד ימין של מרכז הבקרה. בלוח בקרה עם פריסת עיתון, רוחב הרכיב שמוגדר כברירת מחדל הוא 8 עמודות, כלומר הרכיבים בלוח הבקרה שמופיעים בצד ימין של לוח הבקרה (col: 0) יתפסו כברירת מחדל את עמודות 0-7.

לדוגמה, הקוד הבא מגדיר רכיב שיוצג בעמודה השלישית של הרכיבים במרכז הבקרה:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    col: 16
    ...

refresh

הקטע הזה מתייחס לפרמטר refresh שהוא חלק מרכיב בלוח הבקרה.

אפשר להשתמש ב-refresh גם כחלק ממרכז בקרה, כפי שמתואר בדף התיעוד פרמטרים של מרכז הבקרה.

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

קצב הרענון יכול להיות כל מספר (ללא נקודה עשרונית) של שניות, דקות, שעות או ימים. לדוגמה:

- name: orders_by_date
  refresh: 2 hours

חשוב להיזהר כשמגדירים מרווחי רענון קצרים. אם השאילתה שמאחורי הרכיב דורשת משאבים רבים, רכיבים מסוימים עלולים להעמיס על מסד הנתונים יותר מהרצוי.

note_state

הפרמטר note_state קובע אם הערה תכווץ או תורחב אם היא גדולה מדי מכדי להתאים לשורה אחת ברוחב של הרכיב. אם בוחרים באפשרות collapsed וההערה ארוכה מדי, היא תסתיים בשלוש נקודות (...) שאפשר ללחוץ עליהן כדי לקרוא את ההערה המלאה. אם בוחרים באפשרות expanded וההערה ארוכה, היא תמשיך לשורות נוספות.

note_display

הפרמטר note_display מגדיר איפה ההערה מוצגת ברכיב. above ממקם את ההערה בחלק העליון של הרכיב, below ממקם אותה בחלק התחתון של הרכיב, ו-hover מחייב את המשתמש להעביר את העכבר מעל סמל ? כדי לראות את ההערה.

note_text

הפרמטר note_text מציין את הטקסט שמוצג בהערה של רכיב.

פרמטרים של שאילתה

כשמגדירים רכיב בלוח הבקרה של LookML, צריך לציין ערכים לפחות לפרמטרים של השאילתה model ו-explore, ולציין לפחות שדה אחד באמצעות הפרמטר dimensions, הפרמטר measures או הפרמטר fields. אתם יכולים גם להשתמש בפרמטרים האחרים של השאילתה שמתוארים בקטע הזה כדי לשלוט באופן שבו הנתונים מוצגים ברכיב בלוח הבקרה.

model

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

- name: orders_by_date
  model: ecommerce

הפרמטר model מקבל קבועים של LookML. אפשר להגדיר קבוע בקובץ המניפסט של הפרויקט, ואז להשתמש בתחביר "@{constant_name}" כדי להגדיר את הקבוע כערך של model. שימוש בקבוע מאפשר לכם להגדיר את השם של המודל במקום אחד, וזה שימושי במיוחד אם אתם מעדכנים את השם של מודל שמשמש כמה רכיבים בלוח הבקרה.

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

explore

הקטע הזה מתייחס לפרמטר explore שהוא חלק מרכיב בלוח הבקרה.

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

אפשר גם להשתמש ב-explore כחלק ממסנן של מרכז הבקרה, כפי שמתואר בדף התיעוד פרמטרים של מרכז הבקרה.

הפרמטר explore מגדיר את ה-Explore שבו צריך להשתמש בשאילתה של הרכיב.

- name: orders_by_date
  explore: order

הפרמטר explore מקבל קבועים של LookML. אפשר להגדיר קבוע בקובץ המניפסט של הפרויקט, ואז להשתמש בתחביר "@{constant_name}" כדי להגדיר את הקבוע כערך של explore. שימוש בקבוע מאפשר לכם להגדיר את השם של ניתוח נתונים במקום אחד, וזה שימושי במיוחד אם אתם מעדכנים את השם של ניתוח נתונים שמשמש כמה רכיבים בלוח הבקרה.

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

fields

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

## single field example
- name: orders_by_date
  fields: order.order_date

## multiple fields example
- name: orders_by_date
  fields: [order.order_date, order.order_count]

אם משתמשים בפרמטר fields, לא צריך להשתמש בפרמטרים dimensions ו-measures.

dimensions

הפרמטר dimensions מגדיר את המאפיין או המאפיינים שבהם צריך להשתמש בשאילתת הרכיב. כדי לציין את המאפיין, משתמשים בתחביר view_name.dimension_name. אל תכלול את dimensions אם אין כאלה בשאילתה.

## single dimension example
- name: orders_by_date
  dimensions: order.order_date

## multiple dimension example
- name: orders_by_date
  dimensions: [order.order_date, customer.name]

measures

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

## single measure example
- name: orders_by_date
  measures: order.count

## multiple measure example
- name: orders_by_date
  measures: [order.count, order_item.count]

sorts

הפרמטר sorts מגדיר את אופן המיון של השאילתה של הרכיב. מציינים קודם את שדה המיון הראשי, ואחריו את שדות המיון המשניים. משתמשים בתחביר view_name.field_name כדי לציין את המאפיין או המדד שלפיהם רוצים למיין.

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

בדוגמה הבאה מוגדר מיון יחיד:

- name: orders_by_date
  sorts: order.order_date desc

בדוגמה הבאה מוגדרים כמה מיון:

- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

אם אתם משתמשים בטבלת צירים של מאפיינים, אתם יכולים למיין את תוצאות השאילתה על ידי ציון שם המדד, כיוון המיון ומספר האינדקס מבוסס-האפס של עמודת היעד בטבלת הנתונים. לדוגמה, הרכיב הבא ממיין לפי עמודת הציר הראשונה באמצעות האינדקס 0:

- name: orders_by_category
  sorts: [orders.count desc 0]

כדי למיין לפי סך כל השורות, מציינים את האינדקס של עמודת הסכומים הכוללים. לדוגמה, הרכיב הבא ממיין לפי סך השורות באמצעות האינדקס 2, שמייצג את עמודת הסכומים הכוללים של שאילתה עם שתי עמודות ציר:

- name: orders_by_cohort
  sorts: [users.count desc 2]

pivots

הפרמטר pivots מגדיר את המאפיינים שצריך להציג בתצוגת ציר בשאילתת הרכיב. כדי לציין את המאפיין, משתמשים בתחביר view_name.dimension_name. אל תכלול את pivots אם אין כאלה בשאילתה.

## single pivot example
- name: orders_by_date
  pivots: customer.gender

## multiple pivot example
- name: orders_by_date
  pivots: [customer.gender, customer.age_tier]

fill_fields

הפרמטר fill_fields מגדיר את המאפיינים שמשתמשים באפשרות מילוי מאפיינים. כדי לציין את המידות, משתמשים בתחביר view_name.dimension_name.

- name: orders_by_date
  fill_fields: [orders.created_date, orders.shipped_date]

subtotals

הפרמטר subtotals מגדיר את המאפיינים שמשתמשים באפשרות subtotals. כדי לציין את המידות, משתמשים בתחביר view_name.dimension_name.

subtotals: [products.department, distribution_centers.name]

total

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

total: true | false

## default value: false

row_total

הפרמטר row_total קובע אם עמודת הסכומים הכוללים תוצג בצד ימין או בצד שמאל של הטבלה. הפעולה הזו עובדת רק אם יש ציר. מידע נוסף זמין במאמר הצגת סכומים כוללים.

row_total: right | left | false

## default value: false

limit

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

- name: orders_by_date
  limit: 100

column_limit

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

- name: orders_by_date
  column_limit: 100

filters

הקטע הזה מתייחס לפרמטר filters שהוא חלק מרכיב בלוח הבקרה.

אפשר להשתמש ב-filters גם כחלק ממרכז בקרה, כפי שמתואר בדף התיעוד פרמטרים של מרכז הבקרה.

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

הפרמטר filters מגדיר את המסננים שלא ניתנים לשינוי שבהם צריך להשתמש בשאילתה של הרכיב. אם אתם רוצים להגדיר מסננים שמשתמש יכול לשנות במרכז הבקרה, אתם צריכים להגדיר את המסננים באמצעות filters למרכזי בקרה, ואז להחיל אותם על הרכיבים באמצעות listen.

התחביר של filters הוא:

- name: element_name
  filters:
    orders.created_date: 2020/01/10 for 3 days
    orders.status: Shipped
    # You can create multiple filter statements

כל מסנן יכול לקבל ביטוי סינון של Looker או ערך קבוע. אפשר גם להשתמש במשתני Liquid‏ _localization או _user_attributes בביטוי הסינון כדי לקבל ערכי סינון גמישים.

filter_expression

הפרמטר filter_expression מגדיר מסנן מותאם אישית שלא ניתן לשינוי לשאילתה של הרכיב. אם אתם רוצים להגדיר מסננים שמשתמש יכול לשנות במרכז הבקרה, אתם צריכים להגדיר את המסננים באמצעות filters למרכזי בקרה, ואז להחיל אותם על הרכיבים באמצעות listen.

- name: element_name
  filter_expression:
  - diff_days(${users.created_date},${user_order_facts.first_order_date}) > 60

בדף התיעוד ביטויי סינון ב-Looker מפורטים ביטויי הסינון ב-Looker.

listen

מסננים של לוח הבקרה מאפשרים לצופים לחדד באופן אינטראקטיבי את הנתונים שמוצגים ברכיבים בלוח הבקרה. הגדרת מסננים של מרכז שליטה באמצעות הפרמטר filters במרכזי שליטה של LookML. לאחר מכן, משתמשים בפרמטר listen כדי לקשר רכיבים בלוח הבקרה למסנן של לוח הבקרה.

התחביר של listen הוא:

- name: element_name
  listen:
    filter_name_goes_here: dimension or measure on which to apply
                           the filter using view_name.field_name syntax
    # You can add more than one listen statement

מוסיפים את הפרמטר listen לרכיב, ואז מציינים את שם המסנן ואחריו נקודתיים והפניה לשדה שעליו רוצים להחיל את המסנן, באמצעות התחביר view_name.field_name. לדוגמה, אפשר ליצור מסנן בשם Date שמחייב את המשתמש להזין תאריך בשדה המסנן בממשק המשתמש. לאחר מכן, אפשר להחיל את הערך שהמשתמש מזין על הרכיב orders_by_date באופן הבא:

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

  elements:
 - name: orders_by_date
    listen:
      date: order.order_date
    ...

אם המסנן שמאזינים לו מוגדר עם הפרמטר vis_filter: true, פקד הסינון מופיע בסרגל סינון ישירות בחלק העליון של משבצת התצוגה החזותית, ולא בסרגל הסינון העליון של מרכז הבקרה.

דוגמאות נוספות לשימוש בפרמטר filters ובפרמטר listen כדי להחיל מסננים של מרכז הבקרה על רכיבים ספציפיים במרכז הבקרה, זמינות במאמר יצירת מרכזי בקרה של LookML.

query_timezone

הפרמטר query_timezone מציין את אזור הזמן שבו השאילתה תופעל. האפשרויות של אזורי הזמן מוצגות בדף התיעוד ערכים של timezone. אם רוצים שהשאילתה תפעל לפי אזור הזמן של הצופה, אפשר להקצות את הערך user_timezone.

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

analysis_config

אפשר להשתמש בתת-הפרמטרים הבאים כדי להגדיר ניתוחים:

כדי ליצור תחזית, אפשר להשתמש בתחביר כמו זה:


  analysis_config:
    - forecasting:
      confidence_interval: 0.95
      field_name: orders.count
      forecast_n: 14
      forecast_interval: day
      seasonality: 7

forecasting

‫forecasting הוא סוג ניתוח שמחיל תחזית על תרשים להמחשה. התחזיות מאפשרות למנתחי נתונים להוסיף במהירות תחזיות נתונים לשאילתות חדשות או קיימות בכלי הניתוחים, כדי לעזור למשתמשים לחזות נקודות על הגרף ספציפיות ולעקוב אחריהן.

מידע נוסף זמין בדף התיעוד חיזוי בתצוגות חזותיות.

כדי להוסיף תחזיות להמחשות חזותיות, צריך להפעיל את תכונת Labs Forecasting.

confidence_interval

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


confidence_interval: 0.99 | 0.98 | 0.95 | 0.90 | 0.80

אפשר לעיין בקטע מרווח חיזוי בדף התיעוד חיזוי בתצוגות חזותיות.

כדי להוסיף תחזיות להמחשות, צריך להפעיל את תכונת Labs Forecasting.

field_name

‫field_name מציין את שמות המדדים – עד חמישה – שייכללו בתחזיות.


field_name: view_name.field_name

forecast_n

‫forecast_n מציין את אורך התחזית.


forecast_n: N # An integer that represents the length of the forecast

אפשר לעיין בקטע Length בדף התיעוד Forecasting in visualizations.

כדי להוסיף תחזיות להמחשות, צריך להפעיל את תכונת Labs Forecasting.

forecast_interval

‫forecast_interval מגדיר את מרווח הזמן לחיזוי ערכי הנתונים. השדה forecast_interval מאוכלס באופן אוטומטי על סמך מאפיין מסגרת הזמן בשאילתה של Explore.


forecast_interval: day | month # a timeframe with dimension fill

אפשר לעיין בדף התיעוד של Length.

כדי להוסיף תחזיות להמחשות חזותיות, צריך להפעיל את תכונת Labs Forecasting.

seasonality

‫seasonality מאפשר לאנליסטים להביא בחשבון מחזורים ידועים או מגמות נתונים שחוזרות על עצמן בתחזית. השדה seasonality הוא אופציונלי וריק כברירת מחדל.


seasonality: N # An integer that represents the number of rows over which a cycle or pattern repeats

הגדרת העונתיות אוטומטית מיוצגת כערך seasonality ריק.

אפשר לעיין בקטע עונתיות בדף התיעוד חיזוי בתצוגות חזותיות.

כדי להוסיף תחזיות להמחשות חזותיות, צריך להפעיל את תכונת Labs Forecasting.

merged_queries

הפרמטר merged_queries מאפשר לשלב את התוצאות של כמה שאילתות ברכיב אחד בלוח הבקרה. מגדירים כל שאילתת מקור בפרמטר merged_queries של הרכיב, ומשתמשים בתת-הפרמטר join_fields כדי לציין איך למזג את התוצאות.

קוד ה-LookML לדוגמה הבא יוצר רכיב של תוצאות ממוזגות ב-type: looker_grid. בדוגמה הזו, הפרמטר merged_queries משמש ליצירת רכיב בלוח הבקרה שמשלב נתונים משתי שאילתות נפרדות בתרשים טבלה אחד:

- name: merged_results_element
  title: Merged Results Tile
  type: looker_grid
  merged_queries:
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.count, users.city]
    sorts: [users.count desc 0]
    limit: 5000
    column_limit: 50
    query_timezone: UTC
    listen:
    - State: users.state
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.city]
    sorts: [users.state]
    limit: 500
    column_limit: 50
    query_timezone: UTC
    join_fields:
    - field_name: users.state
      source_field_name: users.state
    - field_name: users.city
      source_field_name: users.city
    listen:
    - State: users.state

בדוגמה הזו, הרכיב בלוח הבקרה משלב נתונים משתי שאילתות מקור שמבוססות על ה-Explore‏ users במודל ecommerce. השאילתה הראשית כוללת את השדות users.state,‏ users.count ו-users.city, והיא ממיינת את התוצאות לפי השדה users.count. שאילתת המקור השנייה כוללת את השדות users.state ו-users.city וממיינת את התוצאות לפי השדה users.state.

הפרמטר join_field ממזג את שאילתות המקור על סמך ערכים תואמים בשדות users.state ו-users.city.

הפרמטר listen מחיל מסנן State על שתי השאילתות, ומאפשר לצופים במרכז הבקרה לצמצם את תוצאות השאילתה שמוצגות במשבצת של מרכז הבקרה על ידי בחירת מדינה ספציפית.

דוגמה: מיזוג נתוני חברה

נניח שאתם רוצים ליצור שאילתה ממוזגת שמשלבת מידע על חברות משני חקירות שונות: company_info ו-companies. אתם רוצים לצרף את השאילתות בשדות ipo.stock_symbol,‏ companies.name ו-companies.contact_email מכל חקירה כדי ליצור שאילתה שמחזירה תוצאות של שם החברה, כתובת האימייל ליצירת קשר עם החברה, שנת ההנפקה, סמל המניה, מספר העובדים ומספר המשרות. אפשר להגדיר את רכיב השאילתה הממוזגת ב-LookML באופן הבא:

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email

החלת מסננים על רכיבי שאילתה ממוזגים

בדוגמה הקודמת של רכיב שאילתה ממוזגת אפשר לראות איך להחיל מסננים בתוך הקוד ישירות בכל שאילתת מקור באמצעות הפרמטר filters. לדוגמה, המסננים companies.contact_email: "-NULL" ו-ipo.valuation_amount: NOT NULL בשאילתה הראשית מגבילים את התוצאות לחברות שיש להן כתובות אימייל ליצירת קשר והערכות שווי תקינות. המסננים האלה ברמת השאילתה מבצעים סינון מקדים של הנתונים לפני מיזוג השאילתות, והמשתמש לא יכול לשנות אותם.

אפשר גם להחיל מסננים של מרכז הבקרה על רכיבים של שאילתות ממוזגות באמצעות הפרמטר listen בהגדרה של כל שאילתת מקור. לדוגמה, נניח שיש לכם מסנן של מרכז הבקרה בשם Industry שהגדרתם ברמת מרכז הבקרה באמצעות הפרמטר filters למרכזי בקרה של LookML:

filters:
- name: Industry
  title: Industry
  type: field_filter
  ui_config:
    type: dropdown_menu
    display: inline
  model: market_research
  explore: company_info
  field: companies.industry

כדי להחיל את המסנן Industry על השדה companies.industry בשתי שאילתות המקור, מוסיפים את הפרמטר listen לכל אחת מההגדרות של שאילתות המקור של השאילתה הממוזגת, באופן הבא:

listen:
  Industry: companies.industry

לדוגמה, קוד לדוגמה הבא מוסיף את המסנן Industry לשתי שאילתות המקור ברכיב התוצאות הממוזגות מהדוגמה הקודמת.

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
    listen:
      Industry: companies.industry
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email
    listen:
      Industry: companies.industry

עם התוספת הזו, כשמשתמש מבצע פעולה במסנן של מרכז הבקרה Industry, שאילתת המקור התואמת ברכיב השאילתה הממוזגת תסונן בהתאם.

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

הפרמטרים הבאים תואמים ליכולת להזיז ולהצמיד עמודות בתרשימי טבלה.

auto_size_all_columns

הפרמטר auto_size_all_columns משנה באופן אוטומטי את הגודל של כל עמודה בטבלה לרוחב של כותרת העמודה או של ערך הנתונים הארוך ביותר, לפי הרחב מביניהם. הפרמטר הזה מבטל את הפרמטרים series_column_widths ו-size_to_fit, אם הם מוגדרים.

- name: orders_by_date
  auto_size_all_columns: true

column_order

הפרמטר column_order מגדיר את סדר העמודות בתרשים הטבלה.

- name: orders_by_date
  column_order: [customer.city, customer.state, customer.count]

pinned_columns

הפרמטר pinned_columns מגדיר את העמודות שמוצמדות לצד ימין של תרשים הטבלה.

- name: orders_by_date
  pinned_columns:
    orders.created_date: left
    distribution_centers.name: left

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

הפרמטרים הבאים תואמים לאפשרויות בתפריט Plot של עורך התצוגה החזותית של תרשימי טבלה.

table_theme

משתמשים בפרמטר table_theme כדי להחיל אחת מהאפשרויות הבאות לצביעת טבלה על רכיב טבלה:

  • editable: בטבלה יש מאפיינים בכחול, מדדים בכתום וחישובים בטבלה בירוק.
  • ‫white: כותרת הטבלה לבנה, שורות הנתונים הן בצבעים לבן ואפור לסירוגין והטקסט שחור.
  • gray: כותרת הטבלה אפורה, שורות הנתונים מתחלפות בין לבן לאפור בהיר והטקסט אפור כהה.
  • transparent: כותרת הטבלה שקופה לחלוטין, שורות הנתונים מתחלפות בין שקופות לחלוטין לאפורות שקופות למחצה, וצבע הטקסט משתנה משחור ללבן לפי הצורך בהתאם לצבע הרקע שמופיע. הגדרת table_theme לערך transparent יכולה להיות שימושית כשמשתמשים במרכז בקרה מוטמע בהתאמה אישית, כדי שצבע הרקע של המשבצת יופיע בתצוגה החזותית.
  • ‫unstyled: כותרת הטבלה ושורות הנתונים לבנות, והטקסט שחור.

table_theme: editable | white | gray | transparent | unstyled

show_row_numbers

הפרמטר show_row_numbers קובע אם מספר שורה יוצג בתחילת כל שורה בטבלה.


show_row_numbers: true | false

hide_totals

אם ה-Explore כולל סכומי עמודות, הפרמטר hide_totals קובע אם התצוגה החזותית תציג את הסכומים הכוללים.


hide_totals: true | false

hide_row_totals

אם הניתוח כולל סכומי שורות, hide_row_totals קובע אם סכומי השורות יוצגו בתצוגה החזותית.


hide_row_totals: true | false

transpose

הפרמטר transpose מאפשר להמיר שורות בטבלה לעמודות. אפשר להזין בו את הערך true או false.

- name: orders_by_date
  transpose: true

hidden_fields

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

hidden_fields: [inventory_items.count, distribution_centers.id]

limit_displayed_rows

הפרמטר limit_displayed_rows מאפשר להציג או להסתיר שורות בתצוגה חזותית, על סמך המיקום שלהן בתוצאות. לדוגמה, אם בתצוגה החזותית מוצג ממוצע נע של 7 ימים, יכול להיות שתרצו להסתיר את 6 השורות הראשונות. הגדרה של true מאפשרת לציין את הערכים והמיקומים בתצוגה החזותית שעליהם חלה ההגדרה, באמצעות הפרמטר limit_displays_rows_values ותת-הפרמטרים שלו.

limit_displayed_rows: true
limit_displayed_rows_values:
  show_hide: hide | show
  first_last: first | last
  num_rows: '10'

limit_displayed_rows_values

משתמשים בפרמטר limit_displayed_rows_values ובתת-הפרמטרים שלו show_hide,‏ first_last ו-num_rows, עם limit_displayed_rows כדי לציין אילו שורות להציג או להסתיר בתצוגה חזותית. בקטע limit_displayed_rows מופיעות דוגמאות לשימוש.

show_hide

תת-הפרמטר show_hide קובע אם להסתיר שורות מסוימות מהתצוגה החזותית. מגדירים את show_hide לערך show כדי להציג רק מספר מוגבל של שורות בתצוגה החזותית, ומגדירים את show_hide לערך hide כדי להחריג שורות מסוימות מהתצוגה החזותית.

first_last

תת-הפרמטר first_last קובע אם השורות שיוסרו או יוצגו יהיו השורות הראשונות או האחרונות בקבוצת התוצאות. אם מגדירים את first_last לערך first, השורות הראשונות מוצגות או מוסתרות. אם מגדירים את first_last לערך last, השורות האחרונות מוצגות או מוסתרות.

num_rows

התת-פרמטר num_rows מגדיר את מספר השורות שיוסתר או יוצג. לדוגמה, num_rows: '10' יציג או יסתיר את 10 השורות הראשונות או האחרונות של קבוצת התוצאות מהתצוגה החזותית.

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

הפרמטרים הבאים תואמים לאפשרויות בתפריט Series של עורך התצוגה החזותית של תרשימי טבלה.

truncate_text

הפרמטר truncate_text קובע אם הכותרות של העמודות והטקסט בתוך תאי הנתונים יקוצרו באמצעות שלוש נקודות (…).


truncate_text: true | false

show_view_names

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

show_view_names: true | false

## default value: true

size_to_fit

הפרמטר size_to_fit קובע אם לשנות את הרוחב של כל העמודות כך שהטבלה תתאים בדיוק לרוחב של הרכיב שבו היא מוצגת. אם הפרמטר auto_size_all_columns מוגדר לערך true, הוא מבטל את size_to_fit.


size_to_fit: true | false

dynamic_fields

הפרמטר dynamic_fields ותת-הפרמטרים שלו מתארים את החישובים בטבלה או את השדות בהתאמה אישית שבהם צריך להשתמש בתצוגה החזותית. כדי להוסיף description באורך של עד 255 תווים או כדי להשתמש ב-calculation_type לקבוצות בהתאמה אישית או לחלוקה לקטגוריות בהתאמה אישית, צריך הרשאה ליצור שדות בהתאמה אישית. כדי להוסיף description של עד 255 תווים לחישובים בטבלה או כדי להשתמש ב-calculation_type לחישובים מקוצרים, צריכה להיות לכם הרשאה ליצור חישובים בטבלה.

אפשר להשתמש בתת-הפרמטרים הבאים כדי להגדיר שדות דינמיים:

אפשר ליצור חישוב בטבלה באמצעות תחביר כמו זה:

dynamic_fields:
  - table_calculation: running_total
    label: Running Total of Items
    expression: running_total(${inventory_items.count})
    value_format_name: decimal_0
    description: your description of up to 255 characters here
    _kind_hint: measure
    _type_hint: number
    is_disabled: false

אפשר ליצור חישובי קיצור דרך לכמה סוגי חישובים באמצעות תחביר כמו זה:

dynamic_fields:
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent of Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_of_column_sum
  table_calculation: percent_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent of previous - Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_of_previous
  table_calculation: percent_of_previous_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent change from previous - Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_difference_from_previous
  table_calculation: percent_change_from_previous_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Rank of Orders Count
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: rank_of_column
  table_calculation: rank_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Running total of Orders Count
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: running_total
  table_calculation: running_total_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number

אתם יכולים ליצור מדד בהתאמה אישית לשימוש בתצוגה החזותית באמצעות תחביר כמו זה:

dynamic_fields:
  - measure: avg_sale_price
    label: Average Sale Price
    based_on: products.sale_price
    type: average
    value_format_name: usd
    description: your description of up to 255 characters here
    _kind_hint: measure
    _type_hint: number

אתם יכולים ליצור מדד מותאם אישית מסונן לשימוש בתצוגה החזותית באמצעות תחביר כמו זה:

dynamic_fields:
  - measure: order_count_for_25_47_year_olds
    based_on: order_items.order_count
    type: count_distinct
    label: Order Count for 25- to 47-Year-Olds
    description: your description of up to 255 characters here
    value_format: 00#
    _kind_hint: measure
    _type_hint: number
    filter_expression: "${users.age} >= 25 AND ${users.age} <= 47"

אתם יכולים ליצור מאפיין מותאם אישית לשימוש בתצוגה החזותית באמצעות תחביר כמו זה:

dynamic_fields:
  - dimension: user_city_state
    label: User City and State
    expression: concat(${users.city}, ", ", ${users.state})
    description: your description of up to 255 characters here
    _kind_hint: dimension
    _type_hint: string

אתם יכולים ליצור קבוצות בהתאמה אישית למאפיין שבו אתם רוצים להשתמש בתצוגה החזותית, באמצעות תחביר כמו זה:

  - category: dimension
  description: 'States by region'
  label: State Groups
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: group_by
  dimension: state_groups
  args:
  - users.state
  - - label: Pacific Northwest
      filter: Oregon,Idaho,Washington
  - Other
  _kind_hint: dimension
  _type_hint: string

אתם יכולים ליצור קבוצות מותאמות אישית למאפיין שבו אתם רוצים להשתמש בתצוגה החזותית, באמצעות תחביר כמו זה:

- category: dimension
  description: Order item sale prices, in tiers of 10
  label: Sale Price Bins
  value_format:
  value_format_name:
  calculation_type: bin
  dimension: sale_price_bins
  args:
  - order_items.sale_price
  - '10'
  - '0'
  - '100'
  -
  - classic
  _kind_hint: dimension
  _type_hint: string

אפשר להוסיף כמה שדות דינמיים לרכיב. לא צריך להוסיף חישובים בטבלה לפרמטר fields כדי שהם יופיעו בתצוגה החזותית, אבל צריך להוסיף סוגים אחרים של שדות דינמיים ל-fields כדי שהם יופיעו.

table_calculation

אם מגדירים חישוב בטבלה, תת-הפרמטר table_calculation נותן שם לחישוב בטבלה. זה השם שבו צריך להשתמש כשמפנים לחישוב בטבלה ב-LookML.

measure

תת-הפרמטר measure מגדיר את השם של מדד מותאם אישית או של מדד מותאם אישית מסונן. זה השם שבו משתמשים כדי להפנות למדד ב-LookML.

dimension

תת-הפרמטר dimension מגדיר את השם של מאפיין מותאם אישית. זה השם שצריך להשתמש בו כדי להפנות למאפיין ב-LookML.

label

תת-הפרמטר label מגדיר את הכותרת של השדה הדינמי כפי שאתם רוצים שהיא תופיע בתצוגה החזותית. השם הזה יכול להיות זהה לשם שצוין בתת-הפרמטרים table_calculation,‏ measure או dimension, או שונה ממנו.

based_on

אם אתם משתמשים במדד מותאם אישית או במדד מותאם אישית מסונן, תת-הפרמטר based_on מזהה את המדד שעליו הוא מבוסס, באמצעות התחביר view_name.field_name.

type

אם אתם משתמשים במדד בהתאמה אישית, תת-הפרמטר type מזהה את סוג הצבירה. הערכים האפשריים הם count_distinct,‏ sum,‏ average,‏ min,‏ max או median.

description

אפשר להוסיף תיאור של עד 255 תווים לכל שדה מותאם אישית או חישוב בטבלה באמצעות תת-הפרמטר description. התיאור מוצג ב-Looker כשהמשתמש לוחץ על סמל המידע שמשמאל לשם השדה בבחירת השדות, וכשהמשתמש מעביר את העכבר מעל שם העמודה בטבלה או בתצוגה חזותית של תרשים טבלה ב-Explore, במרכז בקרה או ב-Look.

expression

אם משתמשים בחישוב בטבלה, תת-הפרמטר expression מגדיר את הביטוי של Looker שמשמש ליצירת החישוב בטבלה.

filter_expression

אם אתם משתמשים במדד מסונן בהתאמה אישית, תת-הפרמטר filter_expression מגדיר את הביטוי של Looker שמשמש לסינון המדד.

value_format

תת-הפרמטר האופציונלי value_format מגדיר את פורמט הערך של שדה דינמי כשמשתמשים בפורמט מותאם אישית. אם רוצים להשתמש בפורמט ברירת המחדל של Looker, צריך להשתמש ב-value_format_name.

value_format_name

תת-הפרמטר האופציונלי value_format_name מחיל פורמט ברירת מחדל על השדה הדינמי. אם רוצים להשתמש בפורמט מותאם אישית, צריך להשתמש ב-value_format.

calculation_type

תת-הפרמטר calculation_type מגדיר את הסוג של הפונקציה Group או Shortcut Calculation כדי ליצור חישוב בטבלה, או כדי ליצור קבוצה בהתאמה אישית למאפיין:

אפשרויות של calculation_type שדות בהתאמה אישית:

  • ‫group_by – מקבץ ערכי מאפיינים בתוויות קבועות בהתאמה אישית, על סמך תנאי מותאם אישית שצוין. דומה ל-CASE WHEN ב-SQL, או לפרמטר השדה case ב-LookML.
  • ‫bin — מקבץ ערכים בקטגוריות או ברמות מותאמות אישית, למאפיינים מסוג מספרי ולמאפיינים מותאמים אישית. דומה לסוג המאפיין tier ב-LookML.

אפשרויות לחישובים בטבלה calculation_type:

  • percent_of_column_sum — ערך של שורה חלקי סכום הערכים בעמודה. החישוב הזה כולל רק ערכים שנמצאים בטבלת הנתונים כשהשאילתה מגיעה למגבלת השורות.
  • percent_of_previous — הערך של השורה הנוכחית חלקי הערך של השורה הבאה.
  • ‫percent_difference_from_previous — ההפרש בין הערך של השורה הנוכחית לבין הערך של השורה הבאה, חלקי הערך של השורה הבאה.
  • ‫rank_of_column — הדירוג של ערך בשורה מסוימת מבין כל הערכים בעמודה. החישוב הזה כולל רק ערכים שנמצאים בטבלת הנתונים כשהשאילתה מגיעה למגבלת השורות.
  • running_total — הסכום המצטבר של הערך בשורה הנוכחית וכל הערכים בשורות הקודמות בעמודה.
  • percent_of_previous_column — בשדות של טבלת צירים, הערך של העמודה הנוכחית חלקי הערך של העמודה שמימין לה.
  • percent_change_from_previous_column — בשדות של טבלת צירים, ההפרש בין הערך של העמודה הנוכחית לבין הערך של העמודה שמימין, חלקי הערך של העמודה שמימין.
  • ‫percent_of_row – בשדות של טבלת צירים, האחוז של הערך בעמודה הנוכחית חלקי סכום השורה של השדה הזה.
  • ‫running_row_total – בשדות שעברו סיבוב, הסכום המצטבר של העמודה הנוכחית וכל העמודות הקודמות בשורה הזו.

‫args לקבוצות בהתאמה אישית

אם אתם משתמשים בקבוצות בהתאמה אישית למאפיין, args מציין את הארגומנטים להחלת תוויות קבועות על ערכי מאפיינים. הפורמט של args הוא:

args:
- view_name.field_name
  - label: specified custom label
    filter: condition for values
  - label: another specified custom label
    filter: a different condition for values
- Other ## An optional customizable group label for values that do not meet specified conditions.

אפשר להוסיף כמה תנאי label ו-filter שרוצים, בהתאם למספר הקבוצות הרצוי.

אפשר לעיין בדוגמה הקודמת.

args לקטגוריות בהתאמה אישית

אם אתם משתמשים בקטגוריות מותאמות אישית למאפיין מספרי, הפרמטר args מציין את הארגומנטים להחלת שכבות קבועות על ערכי המאפיינים. הפורמט של args הוא:

  args:
  - view_name.field_name
  - bin_size ## The numeric interval on which to base each bin, in single quotes
  - min ## The numeric value of the minimum bin size, in single quotes
  - max ## The numeric value of the maximum bin size, in single quotes
  - override ## A value will only appear when a custom bin uses a Custom-sized bin type.
  - style ## The bin display style. Currently, only classic is supported.

אפשר לעיין בדוגמה הקודמת.

‫args לחישובים מהירים

בתת-הפרמטר args מציינים את השמות של השדות המספריים שבהם משתמשים בחישוב מקוצר. הפורמט של ארגומנט הוא:

- args:
  - view_name.field_name   ## the field on which the calculation is based

אפשר לעיין בדוגמה הקודמת.

_kind_hint

תת-הפרמטר האופציונלי _kind_hint מציין אם השדה הדינמי מחזיר מאפיין או מדד. אפשר להזין בו את הערכים dimension ו-measure.

_type_hint

תת-הפרמטר האופציונלי _type_hint מזהה את סוג הנתונים שהביטוי של השדה הדינמי אמור להפיק.

is_disabled

תת-הפרמטר האופציונלי is_disabled מציין אם חישוב בטבלה מופיע בתצוגה החזותית וב-Explore הבסיסי שלה. אפשר להזין בו את הערכים true ו-false.

series_labels

הגדרת התוויות של סדרה אחת או יותר על סמך שם הסדרה, באמצעות צמדים של name: label.

בתרשים ציר, שמות הסדרות הם שמות הצירים.

series_labels:
  'Yes': iOS Users
  'No': Android Users

בתרשים עם כמה מדדים, שמות הסדרות הם שמות השדות של המדדים.

series_labels:
  inventory_items.count: Inventory
  orders.count: Orders

series_column_widths

הגדרת הרוחב של עמודה אחת או יותר על סמך שם הסדרה. אם הפרמטר auto_size_all_columns מוגדר לערך true, הוא מבטל את series_column_widths.

series_column_widths:
  order_times.shipping_time: 50
  orders.count: 60

series_cell_visualizations

מציינים אם עמודה אחת או יותר משתמשות באפשרות הצגה חזותית של תאים על ידי ציון שם הסדרה בפורמט view_name.field_name. לפרמטר series_cell_visualizations יש את תתי-הפרמטרים is_active,‏ palette ו-value_display.

series_cell_visualizations:
  order_items.count:
    is_active: true
    palette:
      palette_id: my-custom-colors-sequential-0
      collection_id: my-custom-colors
    value_display: true

is_active

תת-הפרמטר האופציונלי is_active מקבל את הערכים true או false כדי לציין אם התצוגות החזותיות של העמודות מופעלות בסדרה הזו. אם is_active לא מוגדר, ברירת המחדל היא true.

palette

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

אם משתמשים ב-palette, הפרמטרים הצאצאים palette_id ו-collection_id מחילים את הצבעים מלוח צבעים ספציפי על התצוגות החזותיות של העמודות. ב-palette_id, צריך להשתמש במזהה של פלטה רציפה או מפוצלת. מידע נוסף על מזהי פלטות ומזהי אוספי צבעים זמין בקטע color_application.

‫palette כולל פרמטר צאצא חלופי, custom_colors, שבאמצעותו אפשר להגדיר בין שניים לחמישה צבעים בהתאמה אישית לעמודות:

series_cell_visualizations:
  order_items.count:
    palette:
      custom_colors:
      - orange
      - "#0000ff"
      - red

value_display

תת-הפרמטר האופציונלי value_display מקבל את הערכים true או false כדי לציין אם הערכים של כל תא נתונים מוצגים יחד עם התצוגה החזותית של התא. אם value_display לא מוגדר, ברירת המחדל היא true.

series_text_format

הפרמטר series_text_format ותת-הפרמטרים שלו מציינים את פריסת הטקסט בתאים בכל עמודה. הסדרה שרוצים לעצב מצוינת באמצעות התחביר view_name.field_name, ותת-הפרמטרים מתארים את העיצוב.

כל תתי-הפרמטרים הם אופציונליים. השתמשו רק באלה שאתם צריכים.

  series_text_format:
    order_items.shipping_time:
      align: right
    order_items.shipped_date:
      align: center
      fg_color: "#EA8A2F"
      bg_color: "#64518A"
      bold: true
      italic: true

fg_color

תת-הפרמטר fg_color מציין את צבע הגופן של הטקסט בתא. ערך הצבע יכול להיות מחרוזת הקסדצימלית, כמו #2ca6cd, או מחרוזת צבע עם שם ב-CSS, כמו mediumblue.

bg_color

תת-הפרמטר bg_color מציין את צבע הרקע של התא. ערך הצבע יכול להיות מחרוזת הקסדצימלית, כמו #2ca6cd, או מחרוזת צבע עם שם ב-CSS, כמו mediumblue.

bold

תת-הפרמטר bold מציין אם הטקסט בתא מודגש ומקבל את הערכים true או false.

italic

תת-הפרמטר italic מציין אם הטקסט בתא הוא נטוי ומקבל את הערכים true או false.

align

התת-פרמטר align מציין את היישור של הטקסט בתא, והערכים שלו יכולים להיות left,‏ center או right.

series_collapsed

הפרמטר series_collapsed קובע אם לכווץ או להרחיב את סכומי הביניים של סדרה מסוימת. מזהים את הסדרה באמצעות התחביר view_name.field_name ו-true או false.

series_collapsed:
  users.city: false
  users.state: true

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

series_value_format

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

מזהים את הסדרה שרוצים לעצב באמצעות התחביר view_name.field_name.

תת-הפרמטר format_string מאפשר להגדיר את הפורמט של הסדרה באמצעות עיצוב בסגנון Excel.

series_value_format:
  products.retail_price:
    format_string: "$#,##0.00"

אפשר גם להגדיר את העיצוב כך:


series_value_format:
  order_items.count: "00#"

העיצוב שמשמש בתת-הפרמטר format_string זהה לעיצוב שמשמש בפרמטר LookML‏ value_format. אפשר לקרוא איך לציין את הפורמטים האלה בדף התיעוד הוספת עיצוב מותאם אישית לשדות מספריים.

פרמטרים של עיצוב

הפרמטרים הבאים תואמים לאפשרויות בתפריט Formatting של עורך התצוגה החזותית של תרשימי טבלה.

color_application

אפשר להשתמש בפרמטר color_application ובתת-הפרמטרים שלו collection_id ו-palette_id כדי להחיל אוסף צבעים ופלטת צבעים ספציפיים על רכיב בלוח הבקרה. לסקירה כללית של אוספי הצבעים המקוריים של Looker, עיינו בדף התיעוד בנושא אוספי צבעים.

אם יש לכם את מזהה האוסף ומזהה לוח הצבעים שאתם רוצים להשתמש בו, אתם יכולים להזין את המזהים האלה בתת-הפרמטרים collection_id ו-palette_id. מזהה של אוסף או מזהה של פלטה יכול להיות קוד אלפאנומרי או להתבסס על השם של אוסף הצבעים. קודים אלפאנומריים משמשים לאוספים המקוריים של Looker. הם ספציפיים למכונה ונראים כך:


color_application:
  collection_id: 1297dk12-86a7-4xe0-8dfc-82de20b3806a
  palette_id: 93c8aeb7-3f8a-4ca7-6fee-88c3617516a1

אוספי צבעים בהתאמה אישית משתמשים במזהי אוספים ולוחות צבעים על סמך השם של אוסף הצבעים. המזהים האלה ניידים בין מופעים ונראים כך:


color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0

אפשר גם להשתמש בממשק המשתמש כדי למצוא את הצבעים, האוספים או לוחות הצבעים הרצויים וליצור את ה-LookML כדי להוסיף אותם למרכז הבקרה. עוברים לתוכן שמוגדר על ידי המשתמש (כמו Look, מרכז בקרה או Explore), ומשתמשים בממשק המשתמש כדי להחיל את הצבעים, האוסף או לוח הצבעים שרוצים על התצוגה החזותית של התוכן. אחרי שעושים את זה, אפשר לפעול לפי השלבים לקבלת LookML של מרכז בקרה, להעתיק את ה-LookML שנוצר ולהדביק אותו בקטע color_application.

header_font_color

הפרמטר header_font_color מחיל צבע גופן על כותרות העמודות.

ערך הצבע יכול להיות מחרוזת הקסדצימלית, כמו #2ca6cd, או מחרוזת צבע עם שם ב-CSS, כמו mediumblue.


header_font_color: purple

צבע ברירת המחדל תלוי בעיצוב הטבלה שמוגדר באמצעות הפרמטר table_theme.

header_background_color

הפרמטר header_background_color מחיל צבע על הרקע של כותרות העמודות.

ערך הצבע יכול להיות מחרוזת הקסדצימלית, כמו #2ca6cd, או מחרוזת צבע עם שם ב-CSS, כמו mediumblue.


header_background_color: #add8e6

צבע ברירת המחדל תלוי בעיצוב הטבלה שמוגדר באמצעות הפרמטר table_theme.

header_text_alignment

הפרמטר header_text_alignment מחיל יישור left, right או center על כותרות העמודות.


header_text_alignment: center

ברירת המחדל היא left.

header_font_size

הפרמטר header_font_size מחיל גודל גופן מ-1 עד 99 על כותרות העמודות.


header_font_size: 16

גודל ברירת המחדל של הגופנים בכותרת ובשורות הוא 12.

rows_font_size

הפרמטר rows_font_size מחיל גודל גופן מ-1 עד 99 על טקסט בתוך תאי נתונים, אבל לא על כותרות של עמודות.


rows_font_size: 8

גודל ברירת המחדל של גופני הכותרת והשורות הוא 12.

enable_conditional_formatting

הגדרת enable_conditional_formatting ל-true מאפשרת להגדיר כללים שיוצרים קוד צבעים בתצוגה החזותית של הטבלה, בסולם או על ידי ציון ערכים רלוונטיים.


enable_conditional_formatting: true | false

conditional_formatting_include_totals

אם המדיניות enable_conditional_formatting מוגדרת לערך true, המדיניות conditional_formatting_include_totals מציינת אם הסכומים הכוללים נכללים בסכימת קידוד הצבעים.


conditional_formatting_include_totals: true | false

conditional_formatting_include_nulls

אם enable_conditional_formatting מוגדר כ-true, הפרמטר conditional_formatting_include_nulls מציין אם ערכי null צריכים להיות מיוצגים כאפסים.


conditional_formatting_include_nulls: true | false

conditional_formatting

כשהפרמטר enable_conditional_formatting מוגדר לערך true, משתמשים בפרמטר conditional_formatting כדי להגדיר את הכללים שלפיהם הטבלה תסומן בצבעים. בכל כלל עיצוב מותנה, אפשר לציין הגדרות עם הפרמטרים הבאים:

דוגמה לכלל של עיצוב מותנה:


conditional_formatting: [{type: less than, value: 20, background_color: "#9fdee0",
  font_color: "#b15928", bold: true, italic: false, strikethrough: false,
  fields: [order_items.count], color_application: {collection_id: my-custom-colors,
  palette_id: my-custom-colors-sequential-0}}]

type

הפרמטר type מציין אם לצבוע ערכים לפי סולם או לפי תנאי לוגי.

אם אתם מקודדים ערכים בצבעים בסולם, אתם יכולים להגדיר type עד along a scale....

אם אתם מקודדים ערכים בצבעים על סמך תנאי לוגי, אתם יכולים לציין אחד מהערכים הבאים עבור type, יחד עם ערך עבור value:

  • ‫equal to: הכלל חל על ערכים ששווים למספר שצוין בשדה value.
  • ‫not equal to: הכלל חל על ערכים שלא שווים למספר שצוין בשדה value.
  • ‫greater than: הכלל חל על ערכים שגדולים מהמספר שצוין בשדה value.
  • ‫less than: הכלל חל על ערכים שקטנים מהמספר שצוין בשדה value.
  • ‫between: הכלל חל על ערכים שנמצאים בין שני המספרים שצוינו בשדה value.
  • ‫not between: הכלל חל על ערכים שלא נמצאים בין שני המספרים שצוינו בשדה value.
  • ‫'null': הכלל חל רק על ערכי null.
  • ‫not null: הכלל חל רק על ערכים שהם לא null.

type: along a scale... | equal to | not equal to | less than | between | not between | 'null' | not null

value

אם אתם מקודדים ערכים בצבעים על סמך תנאי לוגי שאינו 'null' או not null, ציינו את הערך שהכלל חל עליו. הפרמטר value מקבל מספר אחד, או קבוצה של שני מספרים אם הפרמטר type מוגדר כ-between או כ-not between.


value: N | [N, N]

background_color

אם קידוד הצבעים מבוסס על תנאי לוגי (type מוגדר לכל דבר מלבד along a scale...), צריך להשתמש בפרמטר background_color כדי לציין צבע רקע לערכים שהכלל חל עליהם.


background_color: "#49cec1"

font_color

אם קידוד הצבעים מבוסס על תנאי לוגי (type מוגדר לערך שאינו along a scale...), צריך להשתמש בפרמטר font_color כדי לציין צבע גופן לערכים שהכלל חל עליהם.


font_color: "#1f3e5a"

color_application

אפשר להשתמש בפרמטר color_application ובתת-הפרמטרים שלו collection_id,‏ palette_id ו-options כדי להחיל אוסף צבעים ופלטת צבעים ספציפיים על כלל עיצוב מותנה.

אם יש לכם את מזהה האוסף ומזהה פלטת הצבעים, אתם יכולים להוסיף צבעים למרכז שליטה של LookML. אפשר גם להשתמש בממשק המשתמש כדי למצוא את הצבעים הרצויים וליצור את ה-LookML כדי להוסיף אותם למרכז הבקרה. עוברים לתוכן שמוגדר על ידי המשתמש (כמו Look, מרכז בקרה או Explore), ומחילים את הצבעים הרצויים על התצוגה החזותית של התוכן הזה באמצעות ממשק המשתמש. אחרי שעושים את זה, אפשר לפעול לפי השלבים לקבלת LookML של מרכז בקרה, להעתיק את ה-LookML שנוצר ולהדביק אותו בקטע color_application. לסקירה כללית של אוספי הצבעים המוגדרים מראש של Looker, עיינו בדף התיעוד בנושא אוספי צבעים.

אפשר להשתמש בתת-הפרמטר options כשהערך של type הוא along a scale.... יש לו את הפרמטרים הצאצאים הבאים:

  • steps: הפרמטר הזה מגביל את מספר הצבעים שבהם נעשה שימוש לערך שצוין, ומפריד את הנתונים למספר הקבוצות הזה. כשלא משתמשים בפרמטר הזה, הנתונים נצבעים לפי שיפוע שמכסה את כל לוח הצבעים. אפשר להזין בו ערכים מ-2 עד 100.
  • ‫mirror: כשהפרמטר הזה מוגדר כ-true, הוא מחיל שינויי צבע שווים בכל אחד מהצדדים של פלטת הצבעים, עבור ערכים שווים בכל אחד מהצדדים של נקודת מרכז מוגדרת. אפשר להזין בו את הערך true או false.
  • ‫constraints: הפרמטר הזה מגדיר את טווח הנתונים שהעיצוב המותנה חל עליו, ומגדיר נקודת מרכז שתשמש להחלת לוח הצבעים. התחביר שלו הוא: constraints: {min: {type: number, value: 3}, max: {type: percentile, value: 99}, mid: {type: average}}
  • ‫reverse: הפרמטר הזה קובע אם להפוך את לוח הצבעים במהלך החלת הצבע. אפשר להזין בו את הערך true או false.

bold

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


bold: true | false

italic

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


italic: true | false

strikethrough

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


strikethrough: true | false

fields

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


fields: [ view_name.field_name ]