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

קובץ מודל מציין חיבור למסד נתונים, מגדיר את קבוצת הניתוחים שמשתמשים בחיבור הזה ומגדיר את הקשרים בין הניתוחים לתצוגות אחרות. בניגוד לרכיבי 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 (למאפיין model)	שינוי האופן שבו מודל מופיע בתפריט 'ניתוח'
פרמטרים של מסננים
case_sensitive (למאפיין model)	מציין אם המסננים תלויי אותיות רישיות עבור מודל
פרמטרים של שאילתה
connection	שינוי החיבור למסד הנתונים של מודל
datagroup	יוצר מדיניות של שמירת נתונים במטמון של קבוצת נתונים עבור מודל. לפרמטר הזה יש פרמטרים משניים: label,‏ description,‏ max_cache_age ו-sql_trigger.
fiscal_month_offset	מציינים את החודש שבו מתחילה שנת הכספים (אם הוא שונה מהשנה הקלנדרית)
persist_for (למאפיין model)	שינוי הגדרות המטמון של מודל
persist_with (למאפיין model)	מציינת את קבוצת הנתונים שבה יש להשתמש בשביל מדיניות השמירה במטמון של המודל
week_start_day	מציינים את היום בשבוע שבו צריכים להתחיל מדדים שקשורים לשבוע
פרמטרים של המחשה ועיצוב
map_layer (למאפיין model)	יצירת מפות בהתאמה אישית לשימוש עם map_layer_name
named_value_format	יוצר פורמט ערך בהתאמה אישית לשימוש עם value_format_name. לפרמטר הזה יש את הפרמטרים המשניים value_format ו-strict_value_format.
פרמטרים שכדאי להימנע מהם
scoping	הוסרה גרסה 3.52 לא נדרש יותר
template	Removed 3.30 No longer required