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

תצוגה מייצגת טבלת נתונים ב-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 עבור PDT מצטברות. הערך 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	יש להימנע מ-4.4 הוחלף על ידי label