בשלבי פיתוח: אנחנו עובדים על הוספת מידע נוסף לדף הזה. בינתיים, אפשר לעיין בדף התיעוד בנושא אפשרויות של תרשימים עם ערך יחיד כדי לקבל מידע על יצירה ועריכה של תרשימים עם ערך יחיד באמצעות התפריט של אפשרויות ההמחשה.
הפרמטרים שמתוארים בדף הזה מיועדים לשימוש ברכיבי לוח בקרה של LookML של type: single_value בקובץ dashboard.lkml.
מידע על יצירת תרשים עם ערך בודד דרך ממשק המשתמש של Looker זמין במאמר בנושא אפשרויות של תרשים עם ערך בודד.
פרמטרים בסיסיים
כשמגדירים רכיב של לוח בקרה ב-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, ולציין לפחות שדה אחד באמצעות הפרמטר 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). לדוגמה, הרכיב הבא ממיין לפי עמודת הציר הראשונה באמצעות האינדקס 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
בדוגמה הזו, רכיב לוח הבקרה משלב נתונים משתי שאילתות מקור שמבוססות על מודל users Explore ב-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, שאילתת המקור התואמת ברכיב השאילתה הממוזגת תסונן בהתאם.
hidden_fields
הפרמטר hidden_fields מציין אילו שדות, אם יש כאלה, נמצאים בשימוש בשאילתה אבל מוסתרים בתרשים. כל השדות המוסתרים יופיעו בקטע של טבלת הנתונים בכלי הניתוחים.
hidden_fields: [inventory_items.count, distribution_centers.id]
פרמטרים של סגנון
הפרמטרים שמתוארים בקטע הזה תואמים לאפשרויות בקטע 'סגנון' בעורך הוויזואליזציה של תרשימים עם ערך יחיד.
colors
הפרמטר colors מציין רשימה של צבעים לסדרה. הצבע הראשון ברשימה מתאים לסדרת הנתונים הראשונה. אם יש יותר סדרות מהצבעים שמופיעים ברשימה, הצבעים יתחילו מההתחלה.
colors: [blue, orange, yellow, red, purple]
בכל מאפייני התרשים שבהם מציינים צבע, ערך הצבע יכול להיות מחרוזת הקסדצימלית, כמו #2ca6cd, או מחרוזת של שם צבע ב-CSS, כמו mediumblue.
custom_color_enabled
הגדרת הפרמטר custom_color_enabled לערך true מאפשרת לציין צבע מותאם אישית להצגה חזותית של ערך יחיד. משתמשים בפרמטר הזה עם הפרמטר custom_color.
custom_color_enabled: true | false
custom_color
מציינים צבע מותאם אישית לטקסט בתרשים של ערך יחיד.
custom_color: #2ca6cd | mediumblue
show_single_value_title
כשהפרמטר הזה מוגדר לערך true, מוצג שם מתחת לערך של השאילתה. אפשר לציין או לשנות את הכותרת באמצעות הפרמטר single_value_title.
show_single_value_title: true | false
single_value_title
מציינים כותרת שתופיע עם הערך של השאילתה. אפשר לתרגם את הטקסט של שם המשחק.
single_value_title: Title
valueFormat
מציינים את פורמט המספר או פורמט התאריך של הערך. הפרמטר מקבל עיצוב בסגנון Excel. אם לא מציינים פורמט, הערך יוצג בפורמט של המאפיין או המדד הבסיסיים.
פרמטרים להשוואה
הפרמטרים שמתוארים בקטע הזה תואמים לאפשרויות השוואה בעורך הוויזואליזציה של תרשימים עם ערך יחיד.
show_comparison
כשמגדירים את הפרמטר show_comparison לערך true, אפשר להוסיף מידע השוואתי לרכיב בלוח הבקרה מסוג type: single_value.
show_comparison: true | false
comparison_type
משתמשים בפרמטר comparison_type כדי לציין איך שדה ההשוואה משמש ברכיב בלוח הבקרה type: single_value.
אפשר לציין אחד מהערכים הבאים לפרמטר comparison_type:
-
value: הערך של שדה ההשוואה מוצג בתחתית התרשים. -
change: הערך של שדה ההשוואה מוצג בתחתית התרשים. אם הערך שלילי, מוצג משולש שמצביע כלפי מטה. אם הערך חיובי, המשולש מצביע כלפי מעלה. -
progress: הערך של השדה שמשמש להצגת נתונים בערך יחיד מחולק בערך של השדה להשוואה. האחוז הזה מוצג כסרגל התקדמות. -
progress_percentage: הערך של השדה שמשמש להצגת נתונים בערך יחיד מחולק בערך של השדה להשוואה. האחוז הזה מוצג כסרגל התקדמות. התווית של העמודה כוללת את אחוז השינוי ואת הערך של שדה ההשוואה.
comparison_type: value | change | progress | progress_percentage
show_comparison_label
מציינים אם התווית מוצגת עם שדה ההשוואה. כברירת מחדל, התווית היא השם של שדה ההשוואה.
show_comparison_label: true | false
comparison_label
מציינים את התווית שתוצג עם שדה ההשוואה. אפשר להתאים לשוק המקומי את הטקסט של תווית ההשוואה.
show_comparison_label: true
comparison_label: Label
comparison_reverse_colors
אם הערך של comparison_type הוא change, אפשר להגדיר את comparison_reverse_colors ל-true כדי להציג מספרים שליליים בשדה השוואה כטקסט ירוק עם משולש ירוק, ומספרים חיוביים כטקסט אדום עם משולש אדום.
comparison_type: change
comparison_reverse_colors: true | false