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

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

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

דוגמה לשימוש

הסימן N מציין שצריך להזין ערך מספרי. מירכאות בודדות מציינות טקסט תיאורי ואין לכלול אותן בקוד פעיל.


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

## QUERY PARAMETERS
model: model_name
explore: explore_name
fields: [view_name.field_name, 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, …]
limit: N
filters:
  view_name.field_name: 'looker filter expression'
listen:
  dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone
hidden_fields: [view_name.field_name, view_name.field_name, …]

## SERIES PARAMETERS

color_application:
  collection_id: 'collection ID'
  palette_id: 'palette ID'
  options:
    reverse: true | false

## STYLE PARAMETERS

show_view_names: true | false

## X-AXIS PARAMETERS

show_x_axis_label: true | false
x_axis_label: 'desired x-axis label'
show_x_axis_ticks: true | false
x_axis_gridlines: true | false
x_axis_reversed: true | false
x_axis_zoom: true | false

## Y-AXIS PARAMETERS

show_y_axis_labels: true | false
y_axis_labels: ['desired y-axis label']
show_y_axis_ticks: true | false
y_axis_gridlines: true | false
y_axis_min: ['N']
y_axis_max: ['N']
y_axis_tick_density: default | custom
y_axis_tick_density_custom: 'N'
y_axis_reversed: true | false
y_axis_value_format: ['Excel-style formatting']
y_axis_zoom: true | false

## ADVANCED VISUALIZATION CONFIGURATION PARAMETERS
advanced_vis_config: 'Highcharts JSON snippet'

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

שם הפרמטר תיאור
פרמטרים בסיסיים
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 התחלת קטע של LookML כדי להגדיר הערה לרכיב. לפרמטר הזה יש את תתי-הפרמטרים text,‏ state ו-display.
פרמטרים של שאילתה
model הגדרת המודל שישמש לשאילתה של הרכיב
explore (לרכיבים) הגדרת ה-Explore שבו ייעשה שימוש בשאילתה של הרכיב
fields מגדיר את השדות שישמשו לשאילתה של הרכיב. אפשר להשתמש בו במקום dimensions ו-measures.
dimensions הגדרת המאפיינים שישמשו לשאילתה של הרכיב
measures הגדרת המדדים שישמשו לשאילתה של הרכיב
sorts הגדרת המיונים שישמשו לשאילתה של הרכיב
limit הגדרת מגבלת השורות שבהן ייעשה שימוש בשאילתה של הרכיב
filters (לרכיבים) מגדיר את המסננים שאי אפשר לשנות בשאילתה של הרכיב
listen מגדיר את המסננים שאפשר לשנות בשאילתה של הרכיב, אם נוצרו filters (למרכז הבקרה)
query_timezone מגדיר את אזור הזמן שבו צריך להשתמש כשהשאילתה מופעלת
hidden_fields מציין את השדות שבהם צריך להשתמש בשאילתה אבל להסתיר בתרשים
פרמטרים של סדרות
color_application החלת אוסף צבעים ולוח צבעים על התרשים
פרמטרים של סגנון
show_view_names הצגה או הסתרה של שמות התצוגות בתוויות של התרשים
פרמטרים של ציר ה-X
show_x_axis_label הצגה או הסתרה של התווית של ציר ה-X
x_axis_label הגדרת תווית מותאמת אישית לציר ה-X
show_x_axis_ticks הצגת ערכים בציר ה-X
x_axis_gridlines הרחבת קווי הרשת מציר ה-X
x_axis_reversed הפיכת הכיוון של ציר ה-X
x_axis_zoom מציינת אם לאפשר התקרבות לאורך ציר ה-X
פרמטרים של ציר ה-Y
show_y_axis_labels הצגה או הסתרה של התווית של ציר ה-Y
y_axis_labels הגדרת תווית מותאמת אישית לציר ה-Y
show_y_axis_ticks הצגת ערכים בציר ה-Y
y_axis_gridlines הרחבת קווי הרשת מציר ה-Y
y_axis_min מגדיר ערך מינימלי לציר ה-Y
y_axis_max הגדרת ערך מקסימלי לציר ה-Y
y_axis_tick_density הפעלת האפשרות להגדיר צפיפות מותאמת אישית של שנתות בציר ה-Y באמצעות הפרמטר y_axis_tick_density_custom
y_axis_tick_density_custom מגדיר את צפיפות השנתות בציר ה-Y כשהערך של y_axis_tick_density הוא custom
y_axis_reversed הפיכת הכיוון של ציר ה-Y
y_axis_value_format מגדיר את פורמט המספרים של הערכים בציר ה-Y
y_axis_zoom מציינת אם לאפשר שינוי מרחק התצוגה לאורך ציר ה-Y. מושבת אם x_axis_zoom: false.
פרמטרים מתקדמים להגדרת תצוגות חזותיות
advanced_viz_config מקבל קטע קוד JSON של HighCharts שיכול לשנות כמה הגדרות של תצוגה חזותית

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

כשמגדירים רכיב בלוח הבקרה של 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

אתם יכולים להוסיף הערות תיאוריות לרכיבים, למשל:

- name: element_name
  note:
    text: 'note text'
    state: collapsed | expanded
    display: above | below | hover

לפרמטר note יש את תתי-הפרמטרים text,‏ state ו-display.

text

תת-הפרמטר text מציין את הטקסט שמוצג בהערה. אפשר להתאים את הטקסט לשוק המקומי.

state

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

display

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

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

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

רכיבים של type: looker_boxplot דורשים גם לפחות מאפיין אחד ושניים, שלושה או חמישה מהסוגים הבאים של מידות (שצריך לציין בסדר הזה):

  • מינימום: מדד שמייצג את ערך הנתונים המינימלי. אפשר להגדיר את זה ב-LookML כמדד של type: min.
  • האחוזון ה-25: מדד שמייצג את האחוזון ה-25, או את הרבעון הראשון. רבע מערכי הנתונים קטנים מהערך הזה או שווים לו. אפשר להגדיר את זה ב-LookML כמדד של type: percentile כשהערך של percentile מוגדר כ-25.
  • חציון: מדד שמייצג את החציון או את נקודת האמצע של קבוצת הנתונים, או את הרבעון השני. חצי מערכי הנתונים קטנים מהערך הזה או שווים לו. אפשר להגדיר את זה ב-LookML כמדד של type: median.
  • האחוזון ה-75: מדד שמייצג את האחוזון ה-75, או את הרבעון השלישי. שלושה רבעים מערכי הנתונים קטנים מהערך הזה או שווים לו. אפשר להגדיר את זה ב-LookML כמדד של type: percentile כשהערך של percentile מוגדר כ-75.
  • מקסימום: מדד שמייצג את הערך המקסימלי. אפשר להגדיר את זה ב-LookML כמדד של type: max.

אתם יכולים להשתמש בפרמטר fields, או בשני הפרמטרים dimensions ו-measures, כדי לציין את המאפיינים והמדדים שעליהם מבוסס רכיב תרשים התיבה. למידע נוסף על יצירת תרשים Boxplot בממשק המשתמש של Looker, עיינו בקטע יצירת תרשים Boxplot בדף התיעוד אפשרויות של תרשים Boxplot.

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

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]

limit

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

- name: orders_by_date
  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 בביטוי הסינון כדי לקבל ערכי סינון גמישים.

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

hidden_fields

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

hidden_fields: [inventory_items.count, distribution_centers.id]

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

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.

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

color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0
  options:
    reverse: true

פרמטרים של סגנון

show_view_names

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

show_view_names: true | false

## default value: true

פרמטרים של ציר ה-X

show_x_axis_label

הפרמטר הזה קובע אם התווית של ציר ה-X תוצג.

show_x_axis_label: true | false

## default value: true

x_axis_label

הפרמטר הזה מציין תווית לציר ה-X. אפשר להשתמש בפרמטר הזה כשהערך של show_x_axis_label מוגדר כ-true.

x_axis_label: Order Date

show_x_axis_ticks

הפרמטר הזה קובע אם תוויות הערכים יוצגו בציר ה-X.

show_x_axis_ticks: true | false

## default value: true

x_axis_gridlines

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

x_axis_gridlines: true | false

## default value: false

x_axis_reversed

הפרמטר הזה מגדיר את הכיוון של ציר ה-X. כשהמאפיין x_axis_reversed מוגדר לערך false, הערכים גדלים משמאל לימין. כשהוא מוגדר כ-true, הערכים יורדים משמאל לימין.


x_axis_reversed: true | false

x_axis_zoom

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

אם המדיניות x_axis_zoom מוגדרת לערך false, המדיניות y_axis_zoom מושבתת.

x_axis_zoom: true | false

# default value: true

פרמטרים של ציר ה-Y

show_y_axis_labels

הפרמטר הזה קובע אם תוויות יוצגו בציר ה-Y.

show_y_axis_labels: true | false

## default value: true

y_axis_labels

הפרמטר הזה מציין תווית לציר ה-Y. אפשר להשתמש בפרמטר הזה כשהערך של show_y_axis_labels מוגדר כ-true.

y_axis_labels: ['label']

show_y_axis_ticks

הפרמטר הזה קובע אם הערכים יוצגו בציר ה-Y.

show_y_axis_ticks: true | false

## default value: true

y_axis_gridlines

הפרמטר הזה קובע אם קווי הרשת נמתחים מציר ה-Y.

y_axis_gridlines: true | false

## default value: true

y_axis_min

הפרמטר הזה מגדיר את הערך המינימלי של ציר ה-Y.

y_axis_min: ['10']

## default value: true

y_axis_max

הפרמטר הזה מגדיר את הערך המקסימלי של ציר ה-Y.

y_axis_max: ['100']

## default value: true

y_axis_tick_density

הפרמטר הזה מאפשר להגדיר את צפיפות השנתות בציר ה-Y. כדי להפעיל את התכונה הזו, מגדירים את y_axis_tick_density לערך custom, ואז משתמשים בפרמטר y_axis_tick_density_custom כדי להגדיר את הצפיפות.

y_axis_tick_density: default | custom

## default value: default

y_axis_tick_density_custom

הפרמטר הזה מאפשר להגדיר את צפיפות השנתות בציר ה-Y, אם הערך של y_axis_tick_density מוגדר כ-custom. הוא מקבל מספר שלם שמייצג את מספר השנתות שרוצים להציג.

y_axis_tick_density_custom: 10

## default value: 5

y_axis_reversed

הפרמטר הזה מגדיר את הכיוון של ציר ה-Y. כשהמאפיין y_axis_reversed מוגדר כ-false, הערכים עולים ככל שעולים בציר. כשהוא מוגדר כ-true, הערכים יורדים לאורך הציר.


## y_axis_reversed: true | false

# default value: false

y_axis_value_format

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

הערך שאתם מציינים לפרמטר y_axis_value_format צריך להיות מוקף במירכאות כפולות:


y_axis_value_format: "*00#.00"

במדריך המלא של Excel מוסבר איך לציין את הפורמטים האלה. עם זאת, בשלב הזה אין תמיכה ב-Looker בעיצוב תאריכים ובעיצוב צבעים.

אלה כמה מאפשרויות העיצוב הנפוצות ביותר:

פורמט הערך משמעות
# מספר שלם (123)
*00# מספר שלם עם אפסים משמאל עד 3 ספרות (001)
0.## מספר עם עד 2 ספרות אחרי הנקודה העשרונית (1. או 1.2 או 1.23)
0.00 מספר עם 2 ספרות בדיוק אחרי הנקודה העשרונית (1.23)
*00#.00 מספר עם ריפוד באפסים עד 3 מקומות ובדיוק 2 ספרות אחרי הנקודה העשרונית (01.23)
#,### מספר עם פסיק בין אלפים (1,234)
#,##0.00 מספר עם פסיק בין האלפים ו-2 ספרות אחרי הנקודה העשרונית (1,234.00)
0.000,," M" מספר במיליונים עם 3 ספרות אחרי הנקודה העשרונית (1.234 מיליון). החלוקה במיליון מתבצעת באופן אוטומטי.
$# דולרים ללא ספרות עשרוניות ($123)
$0.00 דולרים עם 2 ספרות אחרי הנקודה העשרונית ($123.00)
$#,##0.00 דולרים עם פסיק בין אלפים ו-2 ספרות אחרי הנקודה העשרונית ($1,234.00)
#% אחוזים בלי ספרות אחרי הנקודה העשרונית (1%). ההכפלה ב-100 מתבצעת באופן אוטומטי.
0.00% אחוז עם 2 ספרות אחרי הנקודה העשרונית (1.00%). ההכפלה ב-100 מתבצעת באופן אוטומטי.
0.00\% אחוז עם 2 ספרות אחרי הנקודה העשרונית (1.00%). הכפלה ב-100 לא מתבצעת באופן אוטומטי.

y_axis_zoom

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

כשהמדיניות y_axis_zoom מוגדרת לערך false, המשתמשים לא יכולים להגדיל חלקים קטנים יותר של ציר ה-Y. עם זאת, יכול להיות שהמשתמשים עדיין יוכלו להגדיל חלקים קטנים יותר של ציר ה-X אם הפרמטר x_axis_zoom מוגדר כ-true.

אם המדיניות x_axis_zoom מוגדרת לערך false, המדיניות y_axis_zoom מושבתת.

y_axis_zoom: true | false

# default value: true

הגדרת תצוגה חזותית מתקדמת

הפרמטרים שמתוארים בקטע הזה תואמים להגדרות האופציונליות של התרשים, שאפשר להחיל על תרשים בלחיצה על הלחצן Edit Chart Config בקטע Plot של עורך התצוגה החזותית.

advanced_vis_config

הפרמטר הזה מקבל קטע קוד JSON של HighCharts שמבטל כמה הגדרות של תצוגה חזותית ופותח יכולות חדשות. בדף התיעוד התאמה אישית של תצוגות חזותיות באמצעות Chart Config Editor מופיעות דוגמאות לשימוש ב-HighCharts JSON בתרחישים נפוצים.


advanced_vis_config: "{ series: [{ formatters: [{ select: 'value >= 50', style: { color: 'orange' } }]}]}"

# This example changes the color to orange for any series value that is greater than or equal to 50.

# default value: null