הצגת הפרמטרים

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

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

בדף הזה מתוארות גם כמה הגדרות ברמת התצוגה המפורטת.

דוגמה לשימוש

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

## STRUCTURAL PARAMETERS

include:"filename_or_pattern"
## Possibly more include declarations

test: test_name{
  explore_source: explore_name {
    # Desired subparameters (described on test page)
  }
  assert: assert_statement {
    expression:Looker expression ;;
  }
  # Possibly more assert declarations
}
## Possibly more test declarations

view: view_name {
  extension: required
  extends: [view_name, view_name, ...]

  (dimension | dimension_group | measure | filter):field_name{
    # Desired field parameters (described on Field Parameters page)
  }
  # Possibly more field declarations

  set: set_name{
    fields:[field_or_set, field_or_set, ...]
  }
  # Possibly more set declarations

  drill_fields: [field_or_set, field_or_set, ...]

  # CUSTOM CALENDAR PARAMETERS

    calendar_definition: {
      Custom calendar mapping parameters ;;
    }

  # DISPLAY PARAMETERS

  label: "desired label"
  fields_hidden_by_default: yes | no

  # FILTER PARAMETERS

  suggestions: yes | no

  # QUERY PARAMETERS

  autogenerate_primary_keys: yes | no
  required_access_grants: [access_grant_name, access_grant_name, ...]
  sql_table_name: table_name ;;

  # DERIVED TABLE PARAMETERS

  derived_table: {
    cluster_keys: ["column_name", "column_name", ...]
    create_process: {
      sql_step:SQL query ;;
    }
    datagroup_trigger: datagroup_name
    distribution: "column_name"
    distribution_style: all | even
    explore_source: explore_name {
      # Desired subparameters (described on explore_source page)
    }
    increment_key: "column_name"
    increment_offset: N
    indexes: ["column_name", "column_name", ...]
    interval_trigger: "N (seconds | minutes | hours)"
    materialized_view: yes | no
    partition_keys: ["column_name", "column_name", ...]
    persist_for: "N (seconds | minutes | hours)"
    publish_as_db_view: yes | no
    sortkeys: ["column_name","column_name", ...]
    sql: SQL query ;;
    sql_create: {
      SQL query ;;
    }
    sql_trigger_value: SQL query ;;
    table_compression: GZIP | SNAPPY
    table_format: PARQUET | ORC | AVRO | JSON | TEXTFILE
  }
}

## REFINEMENT PARAMETERS
view: +view_name {
  final: yes
}

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

שם הפרמטר	תיאור
פרמטרים מבניים
‫drill_fields (לתצוגה)	ההגדרה הזו מציינת את רשימת ברירת המחדל של השדות שמוצגים כשמבצעים פירוט של מדדים שהוגדרו בתצוגה
‫extends (לתצוגה)	מציין את התצוגות שיוצגו בהרחבה בתצוגה הזו
‫extension (לתצוגה)	המדיניות הזו מציינת שהתצוגה דורשת תוסף ולא ניתן לחשוף אותה למשתמשים
include	הוספת קבצים לתצוגה
test	יוצר בדיקת נתונים כדי לאמת את הלוגיקה של המודל. הגדרות הפרויקט כוללות אפשרות לדרוש בדיקות נתונים. כשהאפשרות הזו מופעלת בפרויקט, המפתחים בפרויקט צריכים להריץ בדיקות נתונים לפני שהם פורסים את השינויים שלהם בסביבת הייצור. לפרמטר הזה יש פרמטרים משניים: explore_source ו-assert.
set	המאקרו הזה מגדיר קבוצה של מאפיינים ומדדים לשימוש בפרמטרים אחרים
view	יצירת תצוגה
הצגת פרמטרים
‫label (לתצוגה)	מציין איך שם התצוגה יופיע בבורר השדות
fields_hidden_by_default	נוסף בגרסה 21.12 אם מגדירים את הערך yes, כל השדות בתצוגה מוסתרים כברירת מחדל. משתמשים בפרמטר hidden: no בשדה כדי להציג את השדה.
פרמטרים של מסננים
‫suggestions (לתצוגה)	הפעלה או השבתה של ההצעות לכל המאפיינים בתצוגה הזו
פרמטרים של שאילתה
‫autogenerate_primary_keys (לתצוגה)	המתג מפעיל או משבית את היצירה האוטומטית של מפתח ראשי
‫required_access_grants (לתצוגה)	הגבלת הגישה לתצוגה רק למשתמשים שערכי התכונות שלהם תואמים להרשאות הגישה
‫sql_table_name (לתצוגה)	שינוי טבלת ה-SQL שעליה מבוססת התצוגה
פרמטרים של טבלה נגזרת
cluster_keys	מציין ש-PDT יסודר באשכולות לפי שדה אחד או יותר ב-BigQuery נוספה תמיכה ב-cluster_keys ב-Snowflake
create_process	מציין רצף מסודר של שלבים ליצירת PDT בניב של מסד נתונים שנדרשים בו פקודות DDL בהתאמה אישית. לפרמטר הזה יש פרמטר משני sql_step.
datagroup_trigger	הגדרת קבוצת הנתונים שתשמש למדיניות של בנייה מחדש של PDT
derived_table	הגדרת תצוגה שמבוססת על טבלה נגזרת
distribution	הגדרת מפתח ההפצה של PDT שנבנה ב-Redshift או ב-Aster
distribution_style	הגדרת סגנון ההפצה של PDT שנוצר ב-Redshift
explore_source	הגדרת טבלה נגזרת מבוססת LookML‏ (NDT) על סמך ניתוח ב'חיפוש וניתוח נתונים'
increment_key	Added 21.4 הופך את הטבלה הנגזרת לטבלה נגזרת מתמידה מצטברת. התג increment_key מציין את מרווח הזמן שלגביו צריך לשלוח שאילתה לנתונים עדכניים ולצרף אותם ל-PDT.
increment_offset	Added 21.4 משמש בשילוב עם הפרמטר increment_key להוספת PDTs מצטברים. הערך increment_offset מציין את מספר התקופות הקודמות (ברמת הגרנולריות של מפתח הגידול) שנבנות מחדש כדי להתחשב בנתונים שהגיעו באיחור.
interval_trigger	Added 21.20 התג interval_trigger מציין לוח זמנים לבנייה מחדש של טבלה נגזרת מתמידה, בפורמט "N (seconds | minutes | hours)"
materialized_view	Added 21.10 ההצהרה materialized_view: yes יוצרת תצוגה חומרית במסד הנתונים שלכם עבור טבלה נגזרת.
indexes	הגדרת האינדקסים של PDT שנבנה במסד נתונים מסורתי (לדוגמה, MySQL, ‏ Postgres) או מפתח מיון משולב ב-Redshift
partition_keys	מציין שטבלת PDT תחולק למחיצות לפי שדה אחד או יותר ב-Presto, או לפי שדה יחיד של תאריך/שעה ב-BigQuery
persist_for (for derived_table)	הגדרה של הגיל המקסימלי של PDT לפני יצירה מחדש
publish_as_db_view	ההצהרה publish_as_db_view: yes יוצרת תצוגת מסד נתונים יציבה עבור ה-PDT כדי לאפשר שליחת שאילתות לטבלה מחוץ ל-Looker
sortkeys	הגדרת מפתחות המיון של PDT שנבנה ב-Redshift
sql (for derived_table)	הצהרה על שאילתת SQL לטבלה נגזרת
sql_create	הגדרת הצהרת SQL CREATE ליצירת PDT בניב של מסד נתונים שנדרשות בו פקודות DDL בהתאמה אישית
sql_trigger_value	מציין את התנאי שגורם ליצירה מחדש של PDT
table_compression	הגדרת הדחיסה של הטבלה שתשמש ל-PDT ב-Amazon Athena
table_format	הגדרת פורמט הטבלה לשימוש ב-PDT ב-Amazon Athena
פרמטרים לשיפור
view: +view_name	כדי להוסיף שינוי לתצוגה קיימת, מוסיפים סימן פלוס (+) לפני השם של התצוגה הקיימת. מידע נוסף ותרחישי שימוש מופיעים בדף שיפורים ב-LookML.
final	מציין שההגדרה הנוכחית היא ההגדרה הסופית שמותרת לתצוגה. מידע נוסף ותרחישי שימוש מופיעים בדף שיפורים ב-LookML.
פרמטרים שכדאי להימנע מהם
distkey	הוסר 3.26 הוחלף על ידי distribution
view_label	Avoid 4.4 Replaced by label