פרמטרים של מפות בלוחות בקרה של 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 (לרכיבים) הגדרת ה-Explore שבו ייעשה שימוש בשאילתה של הרכיב
fields מגדיר את השדות שישמשו לשאילתה של הרכיב. אפשר להשתמש בו במקום dimensions ו-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, או בפרמטר 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.

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

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

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

- 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