אתם צופים בתיעוד של Looker 26.16. כדי לראות את התיעוד העדכני ביותר, לוחצים על הקישור הזה.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

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

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

שם הפרמטר	תיאור
פרמטרים בסיסיים
‫`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` (לרכיבים)	הגדרת הניתוח בכלי הניתוחים שישמש לשאילתה של הרכיב
`dimensions`	הגדרת המאפיינים שישמשו לשאילתה של הרכיב
`measures`	הגדרת המדדים שישמשו לשאילתה של הרכיב
`sorts`	הגדרת המיון שישמש לשאילתה של הרכיב
`pivots`	הגדרת המאפיינים שישמשו כמאפייני ציר בשאילתה של הרכיב
`limit`	הגדרת מגבלת השורות שתשמש לשאילתה של הרכיב
‫`filters` (לרכיבים)	הגדרת המסננים שאי אפשר לשנות בשאילתה של הרכיב
`listen`	המאפיין מגדיר את המסננים שאפשר לשנות בשאילתה של הרכיב, אם נוצרו `filters` (ללוח בקרה)
`query_timezone`	הפרמטר הזה מגדיר את אזור הזמן שבו צריך להשתמש כשמריצים את השאילתה
`merged_queries`	הגדרת שאילתה של תוצאות ממוזגות
`hidden_fields`	מציין שדות לשימוש בשאילתה אבל להסתרה בתרשים
פרמטרים של ציר
`leftAxisLabelVisible`	המדיניות הזו קובעת אם תוצג תווית בציר השמאלי
`leftAxisLabel`	מציינת תווית לציר השמאלי
`rightAxisLabelVisible`	מציין אם תוית מוחלת על הציר הימני
`rightAxisLabel`	מציינים תווית לציר הימני
פרמטרים של בר
`color_application`	החלת לוח צבעים על רכיב בלוח בקרה. לפרמטר הזה יש פרמטרים משניים: `collection_id` ו-`palette_id`.
`smoothedBars`	קובעת אם לחבר את הקצה החיצוני של כל עמודה בתרשים המשפך לעמודות שמעליה ומתחתיה
`isStepped`	Added 21.16 מציין אם להציג את תרשים המשפך בסגנון משפך מחולק לשלבים.
`orientation`	מציינת אם הנתונים לתרשים המשפך נלקחים משורות הטבלה או מהעמודות
`labelScale`	מציינת את הגודל של התוויות שממוקמות גם מעל עמודות התרשים וגם בצדדים של התרשים
פרמטרים של תוויות
`labelPosition`	מציין איפה תוויות הנתונים יופיעו בתרשים
`percentType`	קובעת אם לכל פס מוקצה אחוז
`percentPosition`	מציין איפה אחוזי העמודות יופיעו בתרשים
`valuePosition`	מציין איפה ערכי הנתונים יופיעו בתרשים
`labelColorEnabled`	קובעת אם להגדיר צבע מותאם אישית לתוויות ולאחוזים בתרשים
`labelColor`	מציין צבע מותאם אישית לתווית ולאחוזים

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

כשמגדירים רכיב של לוח בקרה ב-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 מסוג type: looker_funnel, צריך לציין ערכים לפחות לפרמטרים של השאילתה 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]

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

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

`leftAxisLabelVisible`

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


leftAxisLabelVisible: true | false

`leftAxisLabel`

מציינים תווית לציר הימני. הפרמטר leftAxisLabelVisible צריך להיות מוגדר לערך true.


leftAxisLabel: Year

`rightAxisLabelVisible`

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


rightAxisLabelVisible: true | false

`rightAxisLabel`

מציינים תווית לציר הימני. הפרמטר rightAxisLabelVisible צריך להיות מוגדר לערך true.


rightAxisLabel: Count

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

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

`color_application`

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

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


color_application:
  collection_id: 1297dk12-86a7-4xe0-8dfc-82de20b3806a
  palette_id: 93c8aeb7-3f8a-4ca7-6fee-88c3617516a1

באוספי צבעים מותאמים אישית נעשה שימוש במזהי אוסף ופלטה על סמך שם אוסף הצבעים, שאפשר להעביר בין מופעים ונראים כך:


color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0

אפשר גם להשתמש בממשק המשתמש כדי למצוא את הצבעים, האוספים או לוחות הצבעים שרוצים, וליצור את קוד ה-LookML כדי להוסיף אותם למרכז הבקרה. עוברים לחלק בתוכן שהוגדר על ידי המשתמש (כמו Look, לוח בקרה או Explore) ומחילים על ההדמיה של התוכן את הצבעים, האוסף או הפלטה הרצויים באמצעות ממשק המשתמש. אחרי שתעשו את זה, תוכלו לפעול לפי השלבים לקבלת LookML של לוח הבקרה, להעתיק את ה-LookML שנוצר ולהדביק אותו בקטע color_application.

`smoothedBars`

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


smoothedBars: true | false

`isStepped`

מציינים אם להציג את תרשים המשפך בסגנון משפך מחולק לשלבים.


isStepped: true | false

`orientation`

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


orientation: automatic | rows | columns

`labelScale`

מציינים את הגודל של התוויות שממוקמות גם מעל עמודות התרשים וגם בצדדים של התרשים. לתוויות יש גודל מינימלי וגודל מקסימלי שמשתנה בהתאם לגודל התרשים. מגדירים את הערך labelScale ל-'0' כדי לציין שהתוויות יהיו בגודל המינימלי. מגדירים את labelScale ל-'1' כדי לציין שהתוויות יהיו בגודל המקסימלי. מזינים מספר בין 0 ל-1 כדי לציין אחוז, וגודל התווית יוגדר לאחוז הזה בין הגודל המינימלי לגודל המקסימלי.


labelScale: '0.5'

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

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

`labelPosition`

מציינים איפה תוויות הנתונים יופיעו בתרשים. אפשר לציין את הערכים הבאים לפרמטר labelPosition:

left: תוויות הנתונים מופיעות בצד ימין של התרשים.
inline: תוויות הנתונים ממוקמות במרכז התרשים, בתוך עמודות התרשים.
right: תוויות הנתונים מופיעות בצד שמאל של התרשים.
hidden: תוויות הנתונים לא מוצגות.


labelPosition: left | inline | right | hidden

`percentType`

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


percentType: total | prior

`percentPosition`

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

‫left: האחוזים מופיעים בצד ימין של התרשים.
‫inline: תוויות האחוזים מופיעות במרכז התרשים, בתוך העמודות.
‫right: תוויות האחוזים מופיעות בצד שמאל של התרשים.
‫hidden: תוויות האחוזים לא מוצגות.

`valuePosition`

מציינים איפה ערכי הנתונים יופיעו בתרשים. אפשר לציין את הערכים הבאים לפרמטר valuePosition:

‫left: ערכי הנתונים מופיעים בצד ימין של התרשים.
‫inline: ערכי הנתונים מופיעים במרכז התרשים, בתוך העמודות.
‫right: ערכי הנתונים מופיעים בצד שמאל של התרשים.
Hidden: ערכי הנתונים לא מוצגים.

`labelColorEnabled`

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


labelColorEnabled: true | false

`labelColor`

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


labelColor: "#4FBC89"

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

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

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

name

title

type

height

ללוחות בקרה עם פריסות tile או static

למרכזי בקרה עם פריסה של newspaper

width

top

left

row

col

refresh

note

text

state

display

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

model

explore

dimensions

measures

sorts

pivots

limit

filters

listen

query_timezone

merged_queries