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

תצוגה מייצגת טבלה של נתונים ב-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, ...]

  # 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