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

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

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

דוגמה לשימוש

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


## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_map
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, …]
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, …]
limit: N
column_limit: N
filters:
  view_name.field_name: 'looker filter expression'
listen:
  dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone

## PLOT PARAMETERS
map_plot_mode: points | automagic_heatmap | lines | areas
heatmap_gridlines: true | false
heatmap_gridlines_empty: true | false
heatmap_opacity: 'number between 0 and 1'

## MAP PARAMETERS
map_tile_provider: light | light_no_labels | dark | dark_no_labels | satellite_streets |
                    satellite | streets | outdoors | traffic_day | traffic_night
map_position: fit_data | custom
map_latitude: 'latitude value'
map_longitude: 'longitude value'
map_zoom: N
map_scale_indicator: 'off' | metric | imperial | metric_imperial
map_pannable: true | false
map_zoomable: true | false
show_view_names: true | false
show_legend: true | false
show_region_field: true | false
draw_map_labels_above_data: true | false

## POINT PARAMETERS
map_marker_type: circle | icon | circle_and_icon | none
map_marker_icon_name: default | airplane | ambulance | anchor | beaker | bell | bolt | briefcase |
                      building | camera | car | checkmark | coffee | comment | envelope | file |
                      gamepad | gavel | gift | glass | headphones | heart | house | key | leaf |
                      microphone | music | person | phone | restaurant | school | shopping_cart |
                      star | suitcase | taxi | tree | trophy | truck | university | wrench
map_marker_radius_mode: proportional_value | equal_to_value | fixed
map_marker_radius_fixed: N
map_marker_radius_min: N
map_marker_radius_max: N
map_marker_proportional_scale_type: linear | log
map_marker_units: meters | pixels
map_marker_color_mode: value | fixed
map_marker_color: ['color value']

## VALUE PARAMETERS
map_value_colors: ['one or more color values']
quantize_map_value_colors: true | false
reverse_map_value_colors: true | false
map_value_scale_clamp_min: N
map_value_scale_clamp_max: N

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

שם הפרמטר תיאור
פרמטרים בסיסיים
‫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 (לרכיבים) הגדרת הניתוח בכלי הניתוחים שישמש לשאילתה של הרכיב
fields הגדרת השדות שישמשו לשאילתה של הרכיב. אפשר להשתמש ב-dimensions במקום ב-measures וב-measures.
dimensions הגדרת המאפיינים שישמשו לשאילתה של הרכיב
measures הגדרת המדדים שישמשו לשאילתה של הרכיב
sorts הגדרת המיון שישמש לשאילתה של הרכיב
pivots הגדרת המאפיינים שישמשו כמאפייני ציר בשאילתה של הרכיב
limit הגדרת מגבלת השורות שתשמש לשאילתה של הרכיב
column_limit הגדרת מגבלת העמודות שתשמש לשאילתה של הרכיב
‫filters (לרכיבים) הגדרת המסננים שאי אפשר לשנות בשאילתה של הרכיב
listen המאפיין מגדיר את המסננים שאפשר לשנות בשאילתה של הרכיב, אם נוצרו filters (ללוח בקרה)
query_timezone הפרמטר הזה מגדיר את אזור הזמן שבו צריך להשתמש כשמריצים את השאילתה
פרמטרים של תרשים
map_plot_mode ההגדרה הזו מגדירה איך נתוני המיקום שלכם מוצגים ברכיב של type: looker_map
heatmap_gridlines הוספת גבול מסביב לכל אחד מקווי הרשת שמשמשים לרכיב של מפת חום
heatmap_gridlines_empty במפות חום עם heatmap_gridlines שמוגדר ל-true, מוצג קו מתאר סביב אזורים במפה שאין להם נתונים משויכים
heatmap_opacity הגדרת השקיפות של הצבעים במפת חום
פרמטרים של מפה
map_tile_provider הגדרת סוג מפת הרקע והאם תוויות המפה מוצגות
map_position הגדרת נקודת המרכז ורמת הזום של המפה הגלויה
map_latitude הגדרת קו הרוחב של מפה עם הערך map_position שמוגדר כ-custom
map_longitude הגדרת קו האורך של מפה עם הערך map_position שמוגדר ל-custom
map_zoom הגדרת הזום של מפה עם map_position שמוגדר ל-custom
map_scale_indicator ההגדרה קובעת אם יוצג קנה מידה של המפה ואת סוג היחידות שיוצגו
map_pannable ההגדרה קובעת אם המשתמשים יכולים לשנות את מיקום המפה על ידי גרירתה
map_zoomable ההגדרה קובעת אם המשתמשים יכולים להגדיל ולהקטין את התצוגה של המפה
show_view_names ההגדרה קובעת אם להציג את שם התצוגה לצד שם השדה בתיאורי הכלים של המפה
show_legend קובעת אם מקרא של מפה יוצג בפינה השמאלית התחתונה של התרשים
show_region_field הגדרה שקובעת אם להציג את פרטי האזור בתיאור הכלים של המפה
draw_map_labels_above_data התוויות של המפה מוצגות מעל או מתחת למפת החום
פרמטרים של נקודות
map_marker_type מציין את סוג הנקודה שמוצגת במפה, עבור רכיבים עם map_plot_mode שהוגדר כ-points, ‏lines או areas
map_marker_icon_name מציין את סוג הסמל שיוצג בכל סמני המפה, עבור רכיבים שהערך של map_marker_type שלהם הוא icon או circle_and_icon
map_marker_radius_mode הגדרה של אופן קביעת הגודל של העיגולים, עבור רכיבים עם map_marker_type שהוגדר כ-circle או circle_and_icon
map_marker_radius_fixed ההגדרה הזו קובעת רדיוס קבוע שחל על כל סמני המפה, עבור רכיבים שבהם map_marker_type מוגדר כ-circle או כ-circle_and_icon ו-map_marker_radius_mode מוגדר כ-fixed
map_marker_radius_min הגדרת הרדיוס המינימלי של עיגולים, לרכיבים עם map_marker_radius_mode שהוגדר ל-proportional_value
map_marker_radius_max הגדרת הרדיוס המקסימלי של עיגולים, לרכיבים עם map_marker_radius_mode שמוגדר כ-proportional_value
map_marker_proportional_scale_type מציינת אם גודל העיגול מבוסס על סולם לינארי או לוגריתמי, עבור רכיבים עם map_marker_type שמוגדר ל-circle או ל-circle_and_icon ועם map_marker_radius_mode שמוגדר ל-proportional_value
map_marker_units מגדירה את היחידות שמשמשות לרדיוס של עיגול ל-meters או ל-pixels, עבור רכיבים עם map_marker_type שמוגדר ל-circle או ל-circle_and_icon
map_marker_color_mode קובעת אם הצבע של סמני המפה קבוע או שהצבעים מוקצים באופן דינמי לסמנים על סמך הערכים של השאילתה הבסיסית
map_marker_color מציין צבע יחיד שיוחל על כל סמני המפה, עבור רכיבים עם map_marker_color_mode שהוגדר ל-fixed
פרמטרים של ערכים
map_value_colors מציין את הצבעים של נקודות במפה, או מגדיר את טווח הצבעים שבהם יש להשתמש אם מקודדים לפי צבעים בהתאם למדד
quantize_map_value_colors השינוי של סולם הצבעים ממעבר הדרגתי חלק לצבעים הספציפיים שהגדרתם
reverse_map_value_colors החלפת הצבעים שמציינים ערכים גבוהים ונמוכים בתרשים, והיפוך של מעבר הצבעים
map_value_scale_clamp_min הגדרת הערך המינימלי של טווח הצבעים
map_value_scale_clamp_max הגדרת הערך המקסימלי של טווח הצבעים

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

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

name

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

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

כל הצהרה של name יוצרת רכיב בלוח הבקרה חדש ומקצה לו שם. שמות הרכיבים צריכים להיות ייחודיים. לפעמים יש הפניה לשמות בפרמטר elements כשמשתמשים בלוחות בקרה של layout: grid.

- 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

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

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

לוחות הבקרה מחולקים ל-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.

במקרה של רכיבי לוח בקרה מסוג LookML‏ type: looker_map, צריך לציין לפחות שדה גיאוגרפי אחד כערך של הפרמטר dimensions או fields. שדה גיאוגרפי יכול להיות אחד מהבאים:

  • מאפיין שמבוסס על נתוני קו רוחב וקו אורך, ומוגדר ב-LookML כמאפיין מסוג type: location.
  • מאפיין שהוקצתה לו שכבת מפה. מפתחי LookML יכולים להוסיף מדד שכבת מפה מובנית או שכבת מפה בהתאמה אישית באמצעות הפרמטר map_layer_name.
  • מאפיין מיקוד. אזורים לפי מיקוד מבוססים על אזורי טבלה של מיקודים (ZCTAs) משנת 2010. אם אתם יוצרים תרשימים להמחשה של מיקודים, יכול להיות שלא תהיה התאמה בין המיקודים לבין אזורי המיקוד שמשמשים ליצירת תרשימים להמחשה של מפות, ולכן יכול להיות שלא כל הנקודות יוצגו במפה.

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

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

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

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

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

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

הפרמטרים שאפשר להשתמש בהם עם רכיב של type: looker_map תלויים בשאילתה. אם השאילתה כוללת מאפיין של type: location או שיש לה שכבת מפה שמשויכת אליה.

map_plot_mode

הפרמטר map_plot_mode מגדיר את האופן שבו הנתונים מוצגים בתרשים ברכיב type: looker_map שמבוסס על מאפיין type: location. הפרמטר הזה לא זמין למפות שמבוססות על מאפיין עם שכבת מפה משויכת או על מאפיינים של מיקוד. הפרמטר map_plot_mode מקבל את הערכים הבאים:

points

ההגדרה map_plot_mode ל-points מציגה כל שורה בטבלת הנתונים הבסיסית כנקודה נפרדת במפה.

מאפיין של type: location לבדו מציב נקודות בגודל ובצבע אחידים במפה. הוספת מדד לשאילתה מאפשרת לשנות את גודל הנקודות או את הצבע שלהן באמצעות הפרמטרים map_marker_radius_mode ו-map_marker_color_mode.

automagic_heatmap

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

כדי שהתרשים הזה יפעל בצורה תקינה, השאילתה צריכה לכלול גם מאפיין של type: location וגם מדד.

lines

הגדרה של map_plot_mode ל-lines לוקחת שני מאפיינים של type: location מהשאילתה ומקשרת אותם יחד בתרשים ההמחשה. אם מוסיפים מדד לשאילתה, אפשר להוסיף סולם צבעים לקווים.

areas

הגדרת map_plot_mode ל-areas לוקחת מימד אחד של type: location ומחברת את כל הנקודות בסדר שבו הן ממוינות. כך נוצרים גבולות של אזור ברכיב המפה. הוספת מדד לשאילתה מאפשרת לכם לעצב את הגודל והצבע של נקודות המיקום הספציפיות שיוצרות את הגבולות של האזור.

heatmap_gridlines

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


heatmap_gridlines: true | false

heatmap_gridlines_empty

אם הערך של heatmap_gridlines הוא true עבור רכיבי מפת חום, והערך של heatmap_gridlines_empty הוא true, יוצג קו מתאר מסביב לאזורים במפה שלא משויכים אליהם נתונים.


heatmap_gridlines_empty: true | false

heatmap_opacity

ברכיבים של מפת חום, אפשר להשתמש ב-heatmap_opacity כדי לציין את האטימות של הצבעים שמשמשים במפת החום. מציינים מספר בין 0 ל-1 כערך של heatmap_opacity, כאשר 0 מציין שאין צבע ו-1 מציין אטימות מלאה.


heatmap_opacity: 0.5

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

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

map_tile_provider

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

  • light: מפה עדינה בצבעים בהירים שנועדה לספק הקשר גיאוגרפי תוך הדגשת הנתונים
  • ‫light_no_labels: כמו light, אבל במפה לא מופיעות תוויות כמו שמות של ערים
  • ‫dark: מפה עדינה בצבעים כהים שנועדה לספק הקשר גיאוגרפי תוך הדגשת הנתונים
  • ‫dark_no_labels: כמו dark, אבל במפה לא מופיעות תוויות כמו שמות של ערים
  • ‫satellite_streets: מפה שמוצגים בה תצלומי אוויר ותצלומי לוויין גלובליים
  • ‫satellite: כמו satellite_streets, אבל במפה לא מופיעות תוויות כמו שמות של ערים
  • ‫streets: מפה לשימוש כללי עם דגש על עיצוב קריא של רשתות כבישים ותחבורה ציבורית
  • ‫outdoors: מפה לשימוש כללי שמותאמת לטיולים רגליים, לרכיבה על אופניים ולשימושים אחרים בחוץ
  • ‫traffic_day: מפה בצבעים בהירים עם דגש על רשתות תחבורה ציבורית וכבישים, כולל מידע עדכני על התנועה
  • ‫traffic_night: מפה בצבעים כהים עם דגש על רשתות תחבורה ציבורית וכבישים, כולל מידע עדכני על התנועה

map_tile_provider: light | light_no_labels | dark | dark_no_labels | satellite_streets |
                    satellite | streets | outdoors | traffic_day | traffic_night

map_position

אפשר להשתמש בפרמטר map_position כדי להגדיר את נקודת המרכז ואת רמת הזום של המפה שמוצגת. יש שתי אפשרויות לציין את המיקום הזה:

  • ‫fit_data: המפה מתמקדת אוטומטית ומשנה את רמת הזום כך שכל נקודות הנתונים של השאילתה יהיו גלויות
  • ‫custom: מאפשר להגדיר באופן ידני את קו הרוחב, קו האורך ורמת הזום באמצעות הפרמטרים map_latitude,‏ map_longitude ו-map_zoom

map_position: fit_data | custom

map_latitude

הפרמטר map_latitude מציין את קו הרוחב של רכיב במפה, כשהפרמטר map_position מוגדר לערך custom.


map_latitude: -5.804047131379801

map_longitude

הפרמטר map_longitude מציין את קו האורך של רכיב במפה, כשהערך של map_position מוגדר ל-custom.


 map_longitude: 113.34732055664064

map_zoom

הפרמטר map_zoom מאפשר לציין את רמת הזום של רכיב במפה עם map_position שהוגדר ל-custom. מספרים גבוהים יותר יוצרים רמת זום קרובה יותר.


map_zoom: 10

map_scale_indicator

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


map_scale_indicator: 'off' | metric | imperial | metric_imperial

map_pannable

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


map_pannable: true | false

map_zoomable

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


map_zoomable: true | false

show_view_names

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


show_view_names: true | false

show_legend

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

הפרמטר show_legend זמין כשמציינים את אפשרויות התרשים הבאות:


show_legend: true | false

show_region_field

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


show_region_field: true | false

draw_map_labels_above_data

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


draw_map_labels_above_data: true | false

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

אפשרויות הנקודות לא זמינות במפות שבהן הערך של map_plot_mode מוגדר כ-automagic_heatmap.

map_marker_type

במפות שמבוססות על מאפיין מיקום ושהפרמטר map_plot_mode שלהן מוגדר לערך points, lines או areas, הפרמטר map_marker_type מגדיר את סוג הנקודה שמוצגת ברכיב המפה. הפרמטר map_marker_type מקבל את הערכים הבאים:

  • circle
  • icon
  • circle_and_icon
  • none

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

map_marker_icon_name

אם הערך של map_marker_type הוא icon או circle_and_icon, אפשר להשתמש בפרמטר map_marker_icon_name כדי להגדיר את סוג הסמל שיוצג בכל סמני המפה.


map_marker_icon_name: default | airplane | ambulance | anchor | beaker | bell | bolt | briefcase |
                      building | camera | car | checkmark | coffee | comment | envelope | file |
                      gamepad | gavel | gift | glass | headphones | heart | house | key | leaf |
                      microphone | music | person | phone | restaurant | school | shopping_cart |
                      star | suitcase | taxi | tree | trophy | truck | university | wrench

map_marker_radius_mode

במפות שבהן הערך של map_marker_type מוגדר ל-circle או ל-circle_and_icon, אפשר להשתמש בפרמטר map_marker_radius_mode כדי להגדיר את הגודל של העיגולים לפי האפשרויות הבאות:

  • ‫proportional_value: האפשרות הזו משנה את הגודל היחסי של העיגולים בהתאם למדדים שהוספתם לשאילתה. אפשר להשתמש בפרמטרים map_marker_radius_min ו-map_marker_radius_max עם האפשרות הזו כדי להגדיר רדיוס מינימלי ורדיוס מקסימלי לעיגולים. אפשר גם להשתמש בפרמטר map_marker_proportional_scale_type כדי להגדיר אם להשתמש בסולם לינארי או בסולם לוגריתמי כדי לקבוע את גודל העיגולים.
  • ‫equal_to_value: ההגדרה הזו משנה את הרדיוס של העיגולים לערכי המדידה בפועל בשאילתה הבסיסית.
  • ‫fixed: האפשרות הזו מאפשרת להגדיר רדיוס קבוע שיחול על כל סמני המפה באמצעות הפרמטר map_marker_radius_fixed. ערך ברירת המחדל הוא 500.

map_marker_radius_mode: proportional_value | equal_to_value | fixed

map_marker_radius_fixed

אם הערך של map_marker_radius_mode הוא fixed והערך של map_marker_type הוא circle או circle_and_icon, אפשר להשתמש בפרמטר map_marker_radius_fixed כדי להגדיר רדיוס קבוע שחל על כל סמני המפה.


map_marker_type: circle
map_marker_radius_mode: fixed
map_marker_radius_fixed: 60

map_marker_radius_min

במפות שבהן הערך של map_marker_type הוא circle או circle_and_icon והערך של map_marker_radius_mode הוא proportional_value, אפשר להשתמש בפרמטר map_marker_radius_min כדי להגדיר את הרדיוס המינימלי של עיגול.


map_marker_type: circle
map_marker_radius_mode: proportional_value
map_marker_radius_min: 5

map_marker_radius_max

במפות שבהן הערך של map_marker_type הוא circle או circle_and_icon והערך של map_marker_radius_mode הוא proportional_value, אפשר להשתמש בפרמטר map_marker_radius_max כדי להגדיר את הרדיוס המקסימלי של העיגול.


map_marker_type: circle
map_marker_radius_mode: proportional_value
map_marker_radius_max: 50

map_marker_proportional_scale_type

במפות שבהן הערך של map_marker_type מוגדר כ-circle או כ-circle_and_icon והערך של map_marker_radius_mode מוגדר כ-proportional_value, אפשר להשתמש בפרמטר map_marker_proportional_scale_type כדי להגדיר את גודל העיגול על סמך סולם לינארי או לוגריתמי. הערך של הפרמטר הזה יכול להיות linear או log.


map_marker_radius_mode: proportional_value
map_marker_proportional_scale_type: linear | log

map_marker_units

במפות שבהן הערך של map_marker_type מוגדר ל-circle או ל-circle_and_icon, אפשר להשתמש בפרמטר map_marker_units כדי להגדיר את היחידות שמשמשות לציון הרדיוס של עיגול ל-meters או ל-pixels.


map_marker_units: meters | pixels

map_marker_color_mode

אפשר להשתמש ב-map_marker_color_mode כדי להגדיר את הצבעים של סמני המפה:

  • אם הערך של map_marker_color_mode הוא value, הצבעים מוקצים לסמנים באופן דינמי על סמך הערכים של השאילתה הבסיסית. אפשר להשתמש בפרמטרים של ערכים כדי להגדיר את הצבעים במקרא של האפשרות הזו.
  • אם הערך של map_marker_color_mode מוגדר כ-fixed, אפשר להשתמש בפרמטר map_marker_color כדי להגדיר צבע יחיד לשימוש בכל סמני המפה. ערך הצבע יכול להיות בפורמט של מחרוזת הקסדצימלית של RGB, כמו 2ca6cd, או בפורמט של שם צבע ב-CSS, כמו mediumblue.

map_marker_color

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


map_marker_color: [mediumblue]

פרמטרים של ערכים

אפשר להשתמש בפרמטרים האלה כדי להגדיר את הצבעים שיוקצו באופן דינמי לסמנים על סמך הערכים של השאילתה הבסיסית כשמגדירים את map_marker_color_mode לערך value, או לרכיבי מפה כשמגדירים את map_plot_mode לערך automagic_heatmap,‏ lines או areas.

map_value_colors

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


map_value_colors: [green, mediumblue]

quantize_map_value_colors

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


quantize_map_value_colors: true | false

reverse_map_value_colors

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


reverse_map_value_colors: true | false

map_value_scale_clamp_min

אפשר להשתמש בפרמטר map_value_scale_clamp_min כדי להגדיר את הערך המינימלי לטווח הצבעים. כך אפשר להקצות צבע לכל הנקודות שמתחת לסף מסוים (המספר שצוין) באמצעות הצבע הנמוך ביותר שצוין בפרמטר map_value_colors. כברירת מחדל, הערך המינימלי שמוצג במקרא הוא הערך המינימלי מהשאילתה.


map_value_scale_clamp_min: 1000

map_value_scale_clamp_max

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


map_value_scale_clamp_max: 50000