Project LookML adalah kumpulan file LookML yang memberi tahu Looker cara terhubung ke database Anda, cara membuat kueri data, dan cara mengontrol perilaku antarmuka pengguna. Anda dapat mengakses file project LookML dari bagian Mengembangkan di Looker atau dari UI, seperti yang dijelaskan di halaman dokumentasi Mengakses file project LookML.
File project dikelola oleh developer Looker Anda menggunakan folder di IDE.
Project LookML terdiri dari setidaknya satu file model dan setidaknya satu file tampilan, dan mungkin beberapa jenis file lain yang dijelaskan di halaman ini. Semua file project memiliki ekstensi, meskipun ekstensi tersebut disembunyikan dalam daftar IDE jika project tidak diaktifkan untuk folder di IDE.
Pilih link berikut untuk mendapatkan informasi selengkapnya tentang setiap jenis file yang dapat digunakan dalam project LookML:
- File model dengan ekstensi
.model.lkml
- Lihat file dengan ekstensi
.view.lkml
- File dasbor dengan ekstensi
.dashboard.lookml
- File data dengan ekstensi
.topojson
atau.geojson
atau.json
- File dokumen dengan ekstensi
.md
- File manifes project yang selalu bernama
manifest.lkml
- File kunci manifes dengan ekstensi
.lkml
- File string lokal dengan ekstensi
.strings.json
- Jelajahi file dengan ekstensi
.explore.lkml
- File pengujian data dengan ekstensi
.lkml
- File penyempurnaan dengan ekstensi
.lkml
- File lain dengan ekstensi file apa pun yang tidak tercantum di atas
Setelah membuat project LookML, Anda dapat mengakses file project serta menambahkan file dan folder baru ke project tersebut menggunakan Looker IDE.
File model
File model menentukan koneksi database dan kumpulan Jelajah yang menggunakan koneksi tersebut. File model juga menentukan Jelajah itu sendiri dan hubungannya dengan tampilan lain. Explore adalah tempat awal untuk mengkueri data Anda. Dalam istilah SQL, Explore adalah klausa FROM
dari sebuah kueri. Jelajah yang Anda tentukan dalam model akan dilihat oleh pengguna saat mereka melihat menu Jelajah Looker.
Dengan kata lain, file model adalah tempat Anda menentukan tabel data mana yang harus digunakan (seperti tampilan yang disertakan) dan bagaimana tabel data tersebut harus digabungkan, jika perlu.
Lihat halaman dokumentasi Mengelola file dan folder LookML untuk mendapatkan petunjuk tentang cara membuat file project LookML, termasuk file model.
Struktur dan sintaksis umum
Dalam tanda kurung kurawal Explore, { }
, Anda dapat menentukan parameter untuk Explore. Anda dapat menggunakan parameter join
untuk menggabungkan tampilan lain ke Jelajah dalam file model.
Pada contoh berikut, LookML dalam file model contoh menentukan Jelajah yang disebut inventory_items
, beserta tampilan gabungannya:
connection: "thelook_events"
explore: inventory_items {
join: products {
type: left_outer
sql_on: ${inventory_items.product_id} = ${products.id} ;;
relationship: many_to_one
}
join: distribution_centers {
type: left_outer
sql_on: ${products.distribution_center_id} = ${distribution_center.id} ;;
relationship: many_to_one
}
}
Definisi LookML ini menyebabkan Item Inventaris muncul di bagian Jelajahi pada navigasi Looker dan menggabungkan data dari tampilan products
dan distribution_centers
ke tampilan inventory_items
.
Untuk informasi lebih spesifik tentang struktur LookML dalam file model, lihat halaman dokumentasi istilah dan konsep LookML.
Baca halaman dokumentasi Parameter model, Jelajahi parameter, dan Menggabungkan parameter untuk mempelajari lebih lanjut parameter LookML dalam file model.
Lihat file
File tampilan umumnya menentukan satu "tampilan" dalam Looker. Tampilan sesuai dengan satu tabel di database Anda atau satu tabel turunan. File tampilan menentukan tabel untuk kueri dan kolom (dimensi dan ukuran) yang akan disertakan dari tabel tersebut sehingga pengguna dapat membuat kueri dengan kolom tersebut di UI Looker.
Lihat halaman dokumentasi Mengelola file dan folder LookML untuk mendapatkan petunjuk tentang cara membuat file project LookML, termasuk file tampilan.
Struktur dan sintaksis umum
Dalam tanda kurung kurawal setiap tampilan, { }
, terdapat definisi kolom, yang biasanya sesuai dengan kolom dalam tabel pokok atau penghitungan di Looker. Looker mengategorikan sebagian besar dimensi dan metrik tersebut sebagai dimensi atau ukuran.
Dalam contoh file tampilan berikut, file orders.view
menyertakan definisi untuk dimensi id
, status
, dan user_id
, grup dimensi created
, dan ukuran count
:
view: orders {
sql_table_name: demo_db.orders ;;
drill_fields: [id]
dimension: id {
primary_key: yes
type: number
sql: ${TABLE}.id ;;
}
dimension: status {
type: string
sql: ${TABLE}.status ;;
}
dimension: user_id {
type: number
# hidden: yes
sql: ${TABLE}.user_id ;;
}
dimension_group: created {
type: time
timeframes: [
raw,
time,
date,
week,
month,
quarter,
year
]
sql: ${TABLE}.created_at ;;
}
measure: count {
type: count
drill_fields: [id, users.id, users.first_name, users.last_name, order_items.count]
}
}
Definisi kolom ini dalam tampilan orders
mengekspos kolom Tanggal Dibuat, ID, Status, User ID, dan Jumlah di alat pilih kolom untuk Eksplorasi Pesanan.
Pengguna yang memiliki akses ke Eksplorasi Pesanan dapat mengkueri Jelajah Pesanan dengan memilih dan memfilter kolom tersebut.
Selain dimensi dan ukuran, Anda juga dapat membuat beberapa dimensi berbasis waktu sekaligus menggunakan grup dimensi atau menentukan filter untuk pengguna dengan kolom filter. Kunjungi halaman dokumentasi Melihat parameter untuk mempelajari lebih lanjut parameter LookML dalam file tampilan, dan buka halaman dokumentasi Parameter kolom untuk mengetahui informasi tentang parameter LookML yang digunakan untuk menentukan dimensi, ukuran, grup dimensi, dan kolom filter di LookML.
File dasbor
Looker mendukung dua jenis dasbor:
- Dasbor buatan pengguna, yang dapat dibuat oleh pengguna non-developer tanpa menggunakan LookML. Untuk mengetahui detailnya, lihat halaman dokumentasi Membuat dasbor buatan pengguna.
- Dasbor LookML, yang disimpan sebagai file yang dikontrol versi yang dikaitkan dengan project.
Jika project Anda berisi dasbor LookML, dasbor tersebut akan ditentukan dalam file dasbor khusus di IDE, dengan ekstensi .dashboard.lookml
.
Untuk informasi selengkapnya tentang dasbor LookML, lihat halaman dokumentasi Membuat dasbor LookML.
File dokumen
File dokumen Looker memungkinkan Anda menulis dokumentasi atau catatan lain tentang model data Looker Anda menggunakan Markdown sesuai GitHub. Hal ini dapat membantu pengguna memahami cara organisasi Anda menggunakan Looker.
Lihat halaman dokumentasi Mengelola file dan folder LookML untuk mengetahui petunjuk cara membuat file project LookML, termasuk file dokumen.
Menampilkan dokumen di luar IDE
Untuk melihat dokumen di luar IDE, yang perlu Anda lakukan untuk memanfaatkan fitur navigasi yang dijelaskan di halaman ini, pilih opsi View Document dari menu See file actions untuk file dokumen:
Anda dapat mendistribusikan URL halaman yang dihasilkan kepada pengguna lain sehingga mereka tidak perlu membuka bagian developer Looker untuk menjangkaunya.
Menambahkan struktur navigasi ke dokumen
Anda dapat menambahkan sidebar ke file dokumen sehingga pengguna dapat dengan mudah melihat struktur informasi dan menavigasi di antara dokumen.
Untuk menambahkan navigasi sidebar untuk dokumen, buat bagian navigasi yang dimulai dari baris pertama dokumen. Tandai awal dan akhir bagian navigasi dengan tiga tanda hubung (---
).
Anda dapat menggunakan parameter berikut di bagian navigasi:
navigation
Anda dapat menggunakan navigation: true
di file dokumen untuk menambahkan sidebar navigasi ke dokumen tersebut. Misalnya, Anda dapat menambahkan kode berikut ke bagian atas {i>file <i}Markdown:
---
navigation: true
---
Kode ini menambahkan sidebar navigasi dengan link ke semua dokumen project ke dokumen. Jika Anda hanya menyertakan navigation: true
dalam dokumen, sidebar dokumen tersebut akan mencantumkan semua dokumen project dalam urutan abjad berdasarkan nama file.
Selain itu, Anda mungkin menemukan bahwa mengatur nama file berdasarkan abjad tidaklah ideal, atau Anda mungkin memiliki beberapa dokumen yang tidak ingin ditampilkan di navigasi:
Dalam contoh ini, Anda mungkin ingin mencantumkan dokumen Dokumen Satu, Dokumen Dua, Dokumen Tiga, dan Dokumen Empat dalam urutan numerik, bukan urutan abjad, serta untuk menyembunyikan dokumen Jangan Tampilkan dari sidebar navigasi.
Untuk mengubah urutan dokumen di sidebar navigasi, atau untuk hanya menampilkan sebagian dokumen di sidebar, Anda dapat menggunakan format ini:
---
navigation:
- document_one
- document_two
- document_three
- document_four
---
Sekarang, navigasi hanya akan menampilkan file dokumen yang ingin Anda tampilkan, dan file tersebut akan muncul dalam urutan yang lebih logis:
title
Secara default, sidebar menampilkan judul dokumen (jika dokumen diawali dengan heading), atau nama file dokumen jika tidak ada heading dalam file. Anda dapat menambahkan parameter title
di bagian atas dokumen untuk mengubah cara dokumen ditampilkan di sidebar navigasi:
---
title: New Title for Users
---
Judul ini akan digunakan sebagai teks link di sidebar navigasi semua dokumen, kecuali jika Anda menentukan label
yang berbeda di bagian navigasi dokumen.
label
Jika ingin mengubah cara dokumen dicantumkan di sidebar navigasi, Anda dapat menggunakan parameter document
dan label
seperti ini:
---
navigation:
- document_one
- document: document_two
label: Customized Label for Document Two
- document_three
- document_four
---
Nilai label
menentukan cara dokumen ditampilkan di navigasi sidebar dokumen, meskipun dokumen yang dirujuk memiliki parameter title
sendiri.
Contoh sebelumnya terlihat seperti ini di sidebar dokumen:
section
Jika ingin membagi sidebar navigasi menjadi beberapa bagian, Anda dapat menggunakan parameter section
seperti ini:
---
navigation:
- document_one
- document_two
- section: My Section Name
- document_three
- document_four
---
Dalam contoh ini, parameter section
menambahkan batas bagian dan judul teks My Bagian Name ke sidebar.
Judul teks bukanlah tautan itu sendiri; judul tersebut tidak merujuk ke file dokumen Anda.
File data
File data adalah file JSON dengan ekstensi file .json
, .topojson
, atau .geojson
.
Parameter map_layer
memungkinkan Anda menggunakan file JSON sebagai peta kustom yang kemudian dapat digunakan untuk memetakan data di Looker.
Anda kemudian menggunakan parameter map_layer_name dengan dimensi agar dapat mengaitkan nilai data (seperti "Paris") dengan wilayah geografis di peta kustom Anda.
Anda dapat mengedit file JSON di LookML IDE, lalu memilih Save.
Untuk proses debug, Anda dapat memilih View Raw dengan memilih menu See file actions di samping nama file untuk melihat file dalam format raw. Jika memiliki ekstensi yang tepat untuk melihat JSON di browser, Anda juga akan memiliki opsi untuk melihat file dalam format Parsed.
Lihat halaman dokumentasi Mengelola file dan folder LookML untuk mendapatkan petunjuk tentang cara mengupload file JSON ke project LookML.
File manifes project
Project Anda mungkin berisi file manifes project, yang digunakan untuk tugas berikut:
- Menentukan project lain yang akan diimpor ke project saat ini
- Menentukan setelan pelokalan model
- Menentukan konstanta LookML
- Menambahkan ekstensi ke project Anda
- Menambahkan visualisasi kustom ke project Anda
Setiap project hanya dapat memiliki satu file manifes, dan harus diberi nama manifest.lkml
serta berada di level root struktur direktori project dan di repo Git Anda.
Lihat halaman dokumentasi Mengelola file dan folder LookML untuk mendapatkan petunjuk tentang cara membuat file project LookML, termasuk file manifes project.
File kunci manifes
File kunci manifes dibuat secara otomatis saat dependensi jarak jauh ditambahkan ke file manifes project. Looker menggunakan file kunci manifes untuk melacak versi project jarak jauh yang ditentukan dalam file manifes. File kunci manifes tercantum di panel browser file Looker IDE dan memiliki nama file manifest_lock.lkml
.
Developer Looker tidak perlu membuat atau mengedit file kunci manifes, karena file kunci dikelola secara otomatis oleh Looker.
Untuk informasi selengkapnya, lihat halaman dokumentasi Mengimpor file dari project lain.
Melokalkan file string
Jika melokalkan model data, Anda harus membuat file string lokalitas untuk setiap lokalitas yang ingin dilokalkan, termasuk lokalitas default Anda (misalnya, sering kali bahasa Inggris di AS).
File string lokal mencantumkan pasangan nilai kunci untuk setiap label dan deskripsi yang dilokalkan dalam model Anda. File string untuk setiap lokal harus menyediakan terjemahan lokalitas tersebut untuk setiap label atau deskripsi. Informasi selengkapnya tentang cara membuat file string lokalitas ditampilkan di halaman dokumentasi Melokalkan model LookML Anda.
Lihat halaman dokumentasi Mengelola file dan folder LookML untuk mendapatkan petunjuk tentang cara membuat file project LookML, termasuk file string lokalitas.
Menjelajahi file
Jelajahi adalah tampilan yang dapat dikueri pengguna. Explore adalah titik awal untuk kueri atau, dalam istilah SQL, FROM
dalam pernyataan SQL. Lihat halaman dokumentasi Melihat dan berinteraksi dengan Jelajah di Looker untuk mendapatkan informasi tentang cara pengguna berinteraksi dengan Jelajah untuk mengkueri data Anda.
Jelajah biasanya ditentukan dalam file model. Namun, terkadang Anda memerlukan file Jelajah terpisah untuk tabel turunan, atau untuk memperluas atau menyaring Jelajah di seluruh model.
Lihat halaman dokumentasi Mengelola file dan folder LookML untuk mengetahui petunjuk cara membuat file project LookML, termasuk file Explore.
File pengujian data
Project Anda mungkin memiliki file pengujian data yang digunakan untuk memverifikasi logika model LookML Anda. Pengujian data dapat ditampung dalam file model atau file tampilan, tetapi jika developer Anda ingin menggunakan pengujian data yang sama di beberapa model yang berbeda, sebaiknya simpan pengujian data di file tersendiri yang mereka buat.
Lihat halaman dokumentasi Mengelola file dan folder LookML untuk mengetahui petunjuk cara membuat file project LookML, termasuk file pengujian data.
File penajaman
Project Anda mungkin memiliki file yang digunakan untuk penyempitan LookerML. Dengan penyempurnaan LookML, Anda dapat menyesuaikan tampilan atau Explore yang ada tanpa mengedit file LookML yang berisinya. Peningkatan LookML dapat ditampung dalam file model, tampilan, atau Explore, atau dalam file khususnya sendiri.
Lihat halaman dokumentasi Mengelola file dan folder LookML untuk mendapatkan petunjuk tentang cara membuat file project LookML, termasuk file penajaman.
File lainnya
Banyak elemen LookML dapat ditempatkan di berbagai file dalam project Anda, atau dalam file khususnya sendiri. Misalnya, pengujian data dapat disimpan dalam file model, file tampilan, atau file .lkml
khusus miliknya sendiri.