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

קובץ מודל מציין חיבור למסד נתונים, מגדיר את קבוצת הניתוחים שמשתמשים בחיבור הזה ומגדיר את הקשרים של הניתוחים לתצוגות אחרות. בניגוד לרכיבי LookML אחרים, מודל לא מוצהר באמצעות פרמטר ספציפי של 'מודל'. במקום זאת, מפתח LookML מגדיר מודל על ידי יצירת פרויקט של LookML עם סיומת הקובץ .model.lkml. שם המודל נלקח משם הקובץ.

שם המודל חייב להיות ייחודי בכל הפרויקטים במופע שלכם. אם המופע שלכם מכיל שני קובצי .model.lkml עם אותו שם, סביר להניח שתיתקלו בשגיאות, כמו שגיאות בהגדרת המודל בדף LookML Projects ושגיאות עיבוד של מרכזי שליטה של LookML, כי מרכזי שליטה של LookML משתמשים בשם המודל בפורמט כתובת ה-URL שלהם (<hostname>/dashboard/model_name::<dashboard_name>).

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

קובץ מודל מכיל בדרך כלל הצהרות explore, וגם מספר הגדרות ברמת המודל.

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

דוגמה לשימוש

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

## STRUCTURAL PARAMETERS
include:"filename_or_pattern"
## Possibly more include declarations

explore: explore_name {
  # Desired explore parameters (described on Explore Parameters page)
}
## Possibly more explore declarations

access_grant: access_grant_name{
  user_attribute: user_attribute_name
  allowed_values: ["value_1", "value_2", ...]
}
## Possibly more access_grant 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

## DISPLAY PARAMETERS
label: "desired label"

## FILTER PARAMETERS
case_sensitive: yes | no

## QUERY PARAMETERS
connection: "connection_name"
datagroup: datagroup_name{
  label: "desired label"
  description: "desired description"
  max_cache_age: "N (minutes | hours | days)"
  sql_trigger: SQL query ;;
}
## Possibly more datagroup declarations
fiscal_month_offset: N
persist_for: "N (seconds | minutes | hours)"
persist_with: datagroup_name
week_start_day: monday | tuesday | wednesday | thursday | friday | saturday | sunday

## VISUALIZATION AND FORMATTING PARAMETERS
map_layer: map_name{
  extents_json_url: "URL to JSON extents file"
  feature_key: "Name of TopoJSON object"
  file: "TopoJSON or GeoJSON filename" # or use the url subparameter
  format: topojson | vector_tile_region
  label: "desired label"
  max_zoom_level: number indicating max zoom
  min_zoom_level: number indicating min zoom
  projection: Preferred geographic projection
  property_key: "TopoJSON property"
  property_label_key: "Label for TopoJSON property"
  url: "URL that contains map file" # or use the file subparameter
}
## Possibly more map layer declarations

named_value_format: desired_name {
  value_format: "excel formatting string"
  strict_value_format: yes | no
 }
## Possibly more named value format declarations

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

שם הפרמטר	תיאור
פרמטרים מבניים
access_grant	יוצרת מענק גישה שמגביל את הגישה למבני LookML רק למשתמשים שהוקצה להם ערך מאושר של מאפיין משתמש. לפרמטר הזה יש את הפרמטרים המשניים user_attribute ו-allowed_values.
explore	הצגת תצוגה בתפריט 'ניתוח'. מידע נוסף על ניתוחים ועל הפרמטרים שלהם זמין בדף חומר עזר בנושא פרמטרים של ניתוחים.
include	הוספת קבצים למודל
test	יוצר בדיקת נתונים כדי לאמת את הלוגיקה של המודל. הגדרות הפרויקט כוללות אפשרות לדרוש בדיקות נתונים. כשהאפשרות הזו מופעלת בפרויקט, המפתחים בפרויקט צריכים להריץ בדיקות נתונים לפני שהם פורסים את השינויים שלהם בסביבת הייצור. לפרמטר הזה יש את הפרמטרים המשניים explore_source ו-assert.
פרמטרים של תצוגה
‫label (למודל)	שינוי האופן שבו מודל מופיע בתפריט 'ניתוח נתונים'
פרמטרים של מסננים
‫case_sensitive (למודל)	מציין אם המסננים הם תלויי אותיות רישיות במודל
פרמטרים של שאילתה
connection	שינוי החיבור למסד הנתונים של מודל
datagroup	יוצר מדיניות של אחסון במטמון של קבוצת נתונים עבור מודל. לפרמטר הזה יש את פרמטרי המשנה label,‏ description,‏ max_cache_age ו-sql_trigger.
fiscal_month_offset	מציינים את החודש שבו מתחילה השנה הפיסקלית (אם היא שונה מהשנה הקלנדרית)
‫persist_for (למודל)	שינוי הגדרות המטמון של מודל
‫persist_with (למודל)	מציין את קבוצת הנתונים שבה יש להשתמש בשביל מדיניות השמירה במטמון של המודל
week_start_day	מציין את היום בשבוע שבו צריכים להתחיל המדדים שקשורים לשבוע
פרמטרים של תצוגה חזותית ועיצוב
‫map_layer (למודל)	יצירת מפות בהתאמה אישית לשימוש עם map_layer_name
named_value_format	יוצר פורמט ערך מותאם אישית לשימוש עם value_format_name. לפרמטר הזה יש את הפרמטרים המשניים value_format ו-strict_value_format.
פרמטרים שכדאי להימנע מהם
scoping	Removed 3.52 No longer required
template	Removed 3.30 No longer required