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

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

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

דוגמה לשימוש


## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_scatter
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
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' | 'filter value'
listen:
  dashboard_filter_name: dimension_or_measure_name
query_timezone: 'specific timezone' | user_timezone
merged_queries:
- 'primary query definition'
- 'next source query definition'
  join_fields:
  - field_name: view_name.field_name
    source_field_name: view_name.field_name

## PLOT PARAMETERS
stacking: normal | percent | ''
show_null_points: true | false
swap_axes: true | false
cluster_points: true | false
hide_legend: true | false
legend_position: center | left | right
hidden_fields: [view_name.field_name, view_name.field_name, …]
limit_displayed_rows: true | false
limit_displayed_rows_values:
  show_hide: show | hide
  first_last: first | last
  num_rows: 'N'
quadrants_enabled: true | false
  quadrant_properties:
    '0':
      color: ''
      label: 'Quadrant 1 label'
    '1':
      color: ''
      label: 'Quadrant 2 label'
    '2':
      color: ''
      label: 'Quadrant 3 label'
    '3':
      color: ''
      label: 'Quadrant 4 label'
custom_quadrant_point_x: 3
custom_quadrant_point_y: 6
custom_quadrant_value_x: 55
custom_quadrant_value_y: 40

## SERIES PARAMETERS
colors: [css_color, css_color, …]
show_view_names: true | false
point_style: none | circle | circle_outline
size_by_field: view_name.field_name
plot_size_by_field: true | false
series_colors:
  series_name: css_color
  # Possibly more series color assignments

series_labels:
  'Series Name': desired series label
  # Possibly more series label assignments
series_types:
  series_name: column | line | area | scatter
  # Possibly more series visualization assignments
series_point_styles:
  series_name: square | diamond | triangle | triangle-down | auto

## VALUE PARAMETERS
show_value_labels: true | false
custom_value_label_column: default | series_name
label_color: [css_color, css_color, …]
font_size: Npx
label_value_format: 'value formatting string'
hidden_series: [series_name, series_name, …]

## X-AXIS PARAMETERS
x_axis_scale: auto | linear | ordinal | time
x_axis_reversed: true | false
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_label_rotation: N
x_axis_datetime_label: 'time formatting string'
x_axis_zoom: true | false

## Y-AXIS PARAMETERS
y_axis_gridlines: true | false
y_axis_reversed: true | false
reference_lines:
  # reference line options
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 שבו ייעשה שימוש בשאילתה של הרכיב
dimensions הגדרת המאפיינים שישמשו לשאילתה של הרכיב
measures הגדרת המדדים שישמשו לשאילתה של הרכיב
sorts הגדרת המיונים שישמשו לשאילתה של הרכיב
pivots הגדרת המאפיינים שצריך להפוך לציר כדי להשתמש בהם בשאילתה של הרכיב
limit הגדרת מגבלת השורות שבהן ייעשה שימוש בשאילתה של הרכיב
filters (לרכיבים) מגדיר את המסננים שאי אפשר לשנות בשאילתה של הרכיב
listen מגדיר את המסננים שאפשר לשנות בשאילתה של הרכיב, אם נוצרו filters (למרכז הבקרה)
query_timezone מגדיר את אזור הזמן שבו צריך להשתמש כשהשאילתה מופעלת
merged_queries מגדירה שאילתה של תוצאות ממוזגות
פרמטרים של תרשים
stacking הצגת סדרות נתונים בערימה אחת על גבי השנייה כדי ליצור תרשים עמודות מוערמות
show_null_points מציין אם לשרטט נקודות שיש להן ערכי null
swap_axes הופכת את צירי ה-X וה-Y בתרשים
cluster_points קיבוץ של כמויות גדולות של ערכי נתונים לאשכולות
hide_legend הסתרת המקרא של התרשים
legend_position מציין אם המקרא מופיע משמאל, במרכז או מימין לתרשים
hidden_fields מציין את השדות שבהם צריך להשתמש בשאילתה אבל להסתיר בתרשים
limit_displayed_rows הצגה או הסתרה של שורות בתצוגה חזותית על סמך המיקום שלהן בתוצאות
limit_displayed_rows_values מציינת אילו שורות להציג או להסתיר בתצוגה החזותית. לפרמטר הזה יש את תתי-הפרמטרים show_hide,‏ first_last ו-num_rows.
quadrants_enabled הוספת קווי רבעים לרכיב בלוח הבקרה של type: looker_scatter
custom_quadrant_point_x מגדיר את המיקום של הקו האנכי של הרביע
custom_quadrant_point_y מגדיר את המיקום של קו הרביע האופקי
custom_quadrant_value_x מגדיר את המיקום של הקו האנכי של הרביע על סמך ערך בציר ה-X
custom_quadrant_value_y מגדיר את המיקום של הקו האופקי של הרביע על סמך ערך בציר ה-Y
פרמטרים של סדרות
colors הגדרת הצבעים של סדרות בתרשים לפי הסדר שבו הסדרות מופיעות
show_view_names הסתרת שמות התצוגות מהתווית של התרשים
point_style מגדיר איך הנקודות על הגרף יופיעו
size_by_field קביעת הגודל של כל הנקודות בתרשים לפי שדה ספציפי
plot_size_by_field הגדרה אם השדה שמשמש לקביעת גודל הנקודות ישורטט בנפרד
series_colors הגדרת הצבעים של סדרות בתרשים על סמך שם הסדרה
series_labels שינוי האופן שבו שם הסדרה מוצג למשתמשים
series_types שילוב של סוגי תרשימים להמחשה על ידי הגדרת הסוג של כל סדרה
series_point_styles מציין את הצורה של הנקודות בתרשים
פרמטרים של ערכים
show_value_labels הצגת תוויות לצד נקודות על הגרף
custom_value_label_column הגדרת השדה שישמש כתוויות הערכים של הנקודות על הגרף כשהערך של show_value_labels הוא True
label_color מציינת רשימה מופרדת בפסיקים של ערכי צבעים
font_size הגדרת גודל הגופן של תוויות הערכים
label_value_format מציין עיצוב בסגנון Excel לתווית הערך
hidden_series הסתרה של סדרת תרשימים כשהרכיב נטען
פרמטרים של ציר ה-X
x_axis_scale מציין איך מחושב קנה המידה של ציר ה-X
x_axis_reversed מציין את הכיוון של ציר ה-X
show_x_axis_label הסתרת התווית של ציר ה-X
x_axis_label הגדרת תווית מותאמת אישית לציר ה-X
show_x_axis_ticks הצגת שנתות בציר ה-X
x_axis_gridlines הארכת קווי הרשת מציר ה-X
x_axis_label_rotation סיבוב תוויות ציר ה-X במספר מעלות
x_axis_datetime_label מגדיר מחרוזת פורמט לתוויות של ציר ה-X, אם הן תאריכים
x_axis_zoom מציינת אם לאפשר התקרבות לאורך ציר ה-X
פרמטרים של ציר ה-Y
y_axis_gridlines הרחבת קווי הרשת מציר ה-Y
y_axis_reversed הגדרת הכיוון של ציר ה-X
reference_lines הוספת קווי עזר לתרשים
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, ולציין לפחות שדה אחד באמצעות הפרמטר dimensions או הפרמטר measures. אפשר גם להשתמש בפרמטרים האחרים של השאילתה כדי לקבוע איך הנתונים יוצגו ברכיב בלוח הבקרה.

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.

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

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

merged_queries

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

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

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

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

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

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

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

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

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

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

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

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

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

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

listen:
  Industry: companies.industry

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

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

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

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

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

stacking

הפרמטר stacking מציין איך הסדרות מקובצות באופן חזותי בתרשים.

  • ‫normal: עורם עמודות, קווים ונקודות זה על גבי זה, כמו בתרשים עמודות אנכי מוערם רגיל.

  • percent: עורמים עמודות, קווים ונקודות כדי למלא 100% מהתרשים ומגדירים את הערכים של ציר ה-Y כאחוזים.

  • ‫'': העמודות, הקווים והנקודות לא נערמים, אלא מקובצים.

stacking: normal | percent | ''

## default value: ''

show_null_points

הפרמטר show_null_points קובע אם לשרטט נקודות עם ערכים ריקים. כשהערך הוא true, ערכי null משורטטים באפס בציר ה-Y. כשהיא מוגדרת לערך false, ערכי null לא משורטטים בכלל, והתרשים ישרטט קו ישר בין הנקודות שלפני ואחרי נקודת ה-null. אם רוצים שהתרשים יציג רווח במקום הערך null, אפשר להשתמש ב-discontinuous_nulls: true.

show_null_points: true | false

## default value: true

swap_axes

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

swap_axes: true | false

## default value: false

cluster_points

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


cluster_points: true | false

hide_legend

ההצהרה הזו תסתיר את המקרא מהתצוגה החזותית.

hide_legend: true | false

## default value: false

legend_position

אם hide_legend מוגדר ל-false (ויש יותר מסדרה אחת), אפשר להשתמש בפרמטר legend_position כדי לציין אם מקרא הסדרה יופיע משמאל, במרכז או מימין לתרשים.

legend_position: center | left | right

## default value: false

hidden_fields

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

hidden_fields: [inventory_items.count, distribution_centers.id]

limit_displayed_rows

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

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

limit_displayed_rows_values

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

show_hide

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

first_last

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

num_rows

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

quadrants_enabled

הפרמטר quadrants_enabled מאפשר להוסיף קווי רבעים לרכיב בלוח הבקרה של type: looker_scatter.

אתם יכולים להשתמש בפרמטרים custom_quadrant_point_x ו-custom_quadrant_point_y או בפרמטרים custom_quadrant_value_x ו-custom_quadrant_value_y כדי להגדיר את המיקומים של קווי הרבעים האנכיים והאופקיים, ואתם יכולים להשתמש בפרמטר quadrant_properties כדי להתאים אישית את צבע הרקע והתווית של כל רבע.


quadrants_enabled: true
  quadrant_properties:
    '0':
      color: ''
      label: 'Quadrant 1 label'
    '1':
      color: ''
      label: 'Quadrant 2 label'
    '2':
      color: ''
      label: 'Quadrant 3 label'
    '3':
      color: ''
      label: 'Quadrant 4 label'

custom_quadrant_point_x

אפשר להשתמש בפרמטר custom_quadrant_point_x כדי להגדיר את המיקום של הקו האנכי של הרביע. מגדירים את הפרמטר custom_quadrant_point_x לערך בין 1 ל-9, כולל. ערך ברירת המחדל הוא 5, שממרכז את הקו בתצוגה החזותית.


custom_quadrant_point_x: 6

custom_quadrant_point_y

אפשר להשתמש בפרמטר custom_quadrant_point_y כדי להגדיר את המיקום של הקו האופקי של הרביע. מגדירים את הפרמטר custom_quadrant_point_y לערך בין 1 ל-9, כולל. ערך ברירת המחדל הוא 5, שממרכז את הקו בתצוגה החזותית.


custom_quadrant_point_y: 2

custom_quadrant_value_x

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


custom_quadrant_value_x: 55

custom_quadrant_value_y

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


custom_quadrant_value_y: 40

quadrant_properties

כשהפרמטר quadrants_enabled מוגדר לערך true, אפשר להשתמש בפרמטר quadrants_properties כדי להגדיר תוויות וצבעי רקע בהתאמה אישית לכל אחד מארבעת הרביעים. כדי להגדיר צבעים בהתאמה אישית או תוויות לכל רבע באמצעות הפרמטר quadrant_properties, משתמשים בפרמטר color ובפרמטר label עם המספר המתאים לכל רבע:

  • '0': הרביע הראשון
  • ‫'1': הרביע השני
  • '2': הרבעון השלישי
  • ‫'3': הרביע הרביעי

לדוגמה, קוד ה-LookML הבא מגדיר את הצבע של הרביע הראשון לקוד ההקסדצימלי #EDEDED ומשנה את התווית שתוצג למשתמשים ל-First Quadrant.

quadrant_properties:
  '0':
    color: '#EDEDED'
    label: 'First Quadrant'

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

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

colors

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


colors: [blue, orange, yellow, red, purple]

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

show_view_names

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

show_view_names: true | false

## default value: true

point_style

הפרמטר point_style מציין איך הנקודות על הגרף מופיעות. אלה האפשרויות הזמינות:

  • ‫none: בתרשימי קו ובתרשימי שטח. הנקודות לא מוצגות.
  • ‫circle: מוצגים עיגולים מלאים.
  • ‫circle_outline: מוצגים עיגולים עם קווי מתאר.

size_by_field

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

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


size_by_field: order_items.id

plot_size_by_field

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

series_colors

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

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

series_colors:
  'Yes': skyblue
  'No': '#000000'

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

series_colors:
  inventory_items.count: crimson
  orders.count: green

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

series_labels

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

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

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

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

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

series_types

הפרמטר series_type מאפשר להשתמש בסוגים שונים של תרשימים קרטזיים באותה תצוגה חזותית. משתמשים בפרמטר הזה כדי להקצות סוג תרשים לכל סדרה שרוצים לשנות. האפשרויות לסוג הן line,‏ column,‏ bar,‏ area ו-scatter.

series_types:
  series_a_name: column
  series_b_name: line

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

series_point_styles

מציינים את הצורה של הנקודות בתרשים לסוגי סדרות של קו, שטח או פיזור. אפשר להגדיר את series_point_styles לערכים square,‏ diamond,‏ triangle,‏ triangle-down או auto.


series_point_styles:
  users.count: triangle

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

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

show_value_labels

הצגת הערך של עמודה, קו או נקודה לצד הנקודה על הגרף.

show_value_labels: true | false

## default value: false

custom_value_label_column

כשהפרמטר show_value_labels מוגדר לערך true, הפרמטר custom_value_label_column מופעל.

אפשר להשתמש בפרמטר custom_value_label_column כדי להתאים אישית מאפיין שישמש כתוויות ערכים בתרשים. מקצים לו את המאפיין בפורמט view_name.field_name.

custom_value_label_column: default | products.category

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

מידע נוסף ודוגמה זמינים בדף התיעוד אפשרויות של תרשים פיזור.

labelColor

אם הפרמטר labelColorEnabled מוגדר לערך true, משתמשים בפרמטר labelColor כדי לציין צבע בהתאמה אישית לתווית ולאחוזים. תוויות שבהן labelPosition מוגדר כ-inline יופיעו בצבע שנבחר, ותוויות בכל אחד מהצדדים של התרשים יופיעו בצבע כהה יותר בכ-40% מהצבע שנבחר.


labelColor: "#4FBC89"

font_size

מגדירים את גודל הגופן של תוויות הערכים באמצעות כל גודל CSS תקין, כמו 10px או 12px.


font_size: 14px

label_value_format

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

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

העיצוב שמשמש בפרמטר label_value_format של מרכז השליטה של LookML זהה לעיצוב שמשמש בפרמטר value_format של LookML, אבל הפרמטר value_format של LookML דורש שמחרוזת העיצוב תהיה מוקפת במירכאות כפולות.


label_value_format: '0.00'

hidden_series

הפרמטר hidden_series מציין איזו סדרה תושבת בתרשים, כלומר הסדרה תופיע במקרא של התרשים, אבל באפור. המשתמשים יכולים להפעיל סדרות מושבתות על ידי לחיצה עליהן במקרא של התרשים. לכן, יכול להיות ש-hidden_series לא יעבוד כמו שצריך עם hide_legend: true.

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

hidden_series: ['Yes', 'No']

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

hidden_series: [inventory_items.count, orders.count]

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

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

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

x_axis_scale

הפרמטר הזה קובע איך מחושב קנה המידה של ציר ה-X.

  • auto: קנה המידה יוסק מהנתונים הבסיסיים. זוהי הגדרת ברירת המחדל.
  • linear: הסולם ישורטט כנתונים מספריים לינאריים. הפעולה הזו לא תעבוד אם אי אפשר להמיר את הנתונים הבסיסיים למספרים.
  • ordinal: הנתונים יוצגו כרשומות נפרדות במרווחים שווים.
  • ‫time: הנתונים יוצגו כזמן והציר יתויג בהתאם. הפעולה הזו לא תעבוד אם אי אפשר להמיר את הנתונים הבסיסיים לתאריכים.
x_axis_scale: auto | linear | ordinal | time

## default value: auto

x_axis_reversed

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


x_axis_reversed: true | false

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_label_rotation

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

x_axis_label_rotation: -45

x_axis_datetime_label

הפרמטר הזה מציין מחרוזת פורמט לתוויות של ציר ה-X, אם הן תאריכים. אם המדיניות x_axis_scale לא מוגדרת לערך time, אין לה השפעה.


x_axis_datetime_label: '%b %d'

במאמר עיצוב זמן בתרשימים מוסבר איך לעצב זמנים.

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

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

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

y_axis_gridlines

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

y_axis_gridlines: true | false

## default value: true

y_axis_reversed

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


## y_axis_reversed: true | false

# default value: false

reference_lines

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

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


reference_lines:
   # reference line options

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