File model menentukan koneksi database, menentukan kumpulan Eksplorasi yang menggunakan koneksi tersebut, dan menentukan hubungan Eksplorasi dengan tampilan lainnya. Tidak seperti elemen LookML lainnya, model tidak dideklarasikan dengan parameter "model" tertentu. Sebagai gantinya, developer LookML menentukan model dengan membuat file project LookML yang memiliki ekstensi file .model.lkml. Nama model diambil dari nama file.
Nama model harus unik di semua project pada instance Anda. Jika instance Anda berisi dua file .model.lkml dengan nama yang sama, kemungkinan Anda akan mengalami error, seperti error konfigurasi model di halaman Project LookML dan error rendering untuk error dasbor LookML, karena dasbor LookML menggunakan nama model dalam format URL-nya (<hostname>/dashboard/model_name::<dashboard_name>
Anda dapat menggunakan Validator LookML untuk memverifikasi apakah nama model diduplikasi di seluruh instance Anda. Namun, meskipun Validator LookML mendeteksi nama model duplikat di instance Anda, Anda tetap dapat menerapkan kode ke produksi. Oleh karena itu, pastikan untuk memperbaiki semua error nama model duplikat sebelum Anda men-deploy project LookML ke produksi.
File model biasanya berisi deklarasi explore, beserta sejumlah setelan tingkat model.
Halaman ini menautkan ke parameter LookML tingkat model. Biasanya ditulis di bagian atas file model dan tidak boleh disarangkan dalam parameter lain.
Contoh penggunaan
Arahkan kursor ke nama parameter untuk melihat deskripsi singkat. Klik parameter untuk membuka halaman referensinya. Jika parameter dapat disetel ke salah satu dari beberapa opsi tertentu, nilai default akan dicantumkan terlebih dahulu.
## 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
Definisi parameter
| Nama Parameter | Deskripsi |
|---|---|
| Parameter Struktural | |
access_grant |
Membuat hibah akses yang membatasi akses struktur LookML hanya untuk pengguna yang diberi nilai atribut pengguna yang disetujui. Parameter ini memiliki subparameter user_attribute dan allowed_values. |
explore |
Mengekspos tampilan di menu Jelajahi. Untuk mengetahui informasi selengkapnya tentang Jelajah dan parameternya, lihat halaman Referensi Parameter Jelajah. |
include |
Menambahkan file ke model |
test |
Membuat pengujian data untuk memverifikasi logika model Anda. Setelan project mencakup opsi untuk mewajibkan pengujian data. Jika diaktifkan untuk project, developer di project harus menjalankan pengujian data sebelum men-deploy perubahan mereka ke produksi. Parameter ini memiliki subparameter explore_source dan assert. |
| Parameter Tampilan | |
label (untuk model) |
Mengubah tampilan model di menu Jelajah |
| Parameter Filter | |
case_sensitive (untuk model) |
Menentukan apakah filter peka huruf besar/kecil untuk model |
| Parameter Kueri | |
connection |
Mengubah koneksi database untuk model |
datagroup |
Membuat kebijakan penayangan grup data untuk model. Parameter ini memiliki subparameter label, description, max_cache_age, dan sql_trigger. |
fiscal_month_offset |
Menentukan bulan dimulainya tahun fiskal Anda (jika berbeda dengan tahun kalender) |
persist_for (untuk model) |
Mengubah setelan cache untuk model |
persist_with (untuk model) |
Menentukan grup data yang akan digunakan untuk kebijakan penyimpanan cache model |
week_start_day |
Menentukan hari dalam seminggu saat dimensi terkait minggu harus dimulai |
| Parameter Visualisasi dan Pemformatan | |
map_layer (untuk model) |
Membuat peta kustom untuk digunakan dengan map_layer_name |
named_value_format |
Membuat format nilai kustom untuk digunakan dengan value_format_name. Parameter ini memiliki subparameter value_format dan strict_value_format. |
| Parameter yang Harus Dihindari | |
scoping |
Menghapus 3.52 Tidak lagi diperlukan |
template |
Menghapus 3.30 Tidak lagi diperlukan |