Jenis file dalam project LookML

Project LookML adalah kumpulan file LookML yang memberi tahu Looker cara terhubung ke database Anda, cara membuat kueri data Anda, dan cara mengontrol perilaku antarmuka pengguna. Anda dapat mengakses file project LookML dari bagian Develop di Looker atau dari UI, seperti yang dijelaskan di halaman dokumentasi Mengakses file project LookML.

File project diatur oleh developer Looker Anda menggunakan folder di IDE.

Project LookML terdiri dari minimal satu file model dan minimal satu file tampilan, serta mungkin beberapa jenis file lain yang dijelaskan di halaman ini. Semua file project memiliki ekstensi, meskipun ekstensi tersebut disembunyikan dalam daftar IDE jika project Anda tidak diaktifkan untuk folder di IDE.

Pilih link berikut untuk mendapatkan informasi selengkapnya tentang setiap jenis file yang dapat digunakan dalam project LookML:

Setelah membuat project LookML, Anda dapat mengakses file project dan menambahkan file serta folder baru ke project menggunakan Looker IDE.

File model

File model menentukan koneksi database dan kumpulan Eksplorasi yang menggunakan koneksi tersebut. File model juga menentukan Eksplorasi itu sendiri dan hubungannya dengan tampilan lain. Eksplorasi adalah titik awal untuk membuat kueri data Anda. Dalam istilah SQL, Eksplorasi adalah klausa FROM dari kueri. Eksplorasi yang Anda tentukan dalam model akan dilihat oleh pengguna saat mereka melihat menu Eksplorasi Looker.

Dengan kata lain, file model adalah tempat Anda menentukan tabel data mana yang harus digunakan (sebagai tampilan yang disertakan) dan bagaimana tabel tersebut harus digabungkan, jika perlu.

Perhatikan hal-hal berikut terkait file model:

  • Eksplorasi biasanya ditentukan dalam file model. Namun, terkadang Anda memerlukan file Eksplorasi terpisah untuk tabel turunan, atau untuk memperluas Eksplorasi atau untuk menyempurnakan Eksplorasi di seluruh model.
  • File model harus memiliki nama 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 mengirimkan kode ke produksi. Oleh karena itu, pastikan untuk memperbaiki error nama model duplikat sebelum Anda men-deploy project LookML ke produksi.

Lihat halaman dokumentasi Mengelola file dan folder LookML untuk mengetahui petunjuk cara membuat file project LookML, termasuk file model.

Struktur dan sintaksis umum

Dalam tanda kurung kurawal Eksplorasi, { }, Anda menentukan parameter untuk Eksplorasi. Anda dapat menggunakan parameter join untuk menggabungkan tampilan lain ke Eksplorasi dalam file model.

Dalam contoh berikut, LookML dalam file model contoh menentukan Eksplorasi 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 Inventory Items muncul di bagian Explore navigasi Looker dan menggabungkan data dari tampilan products dan distribution_centers ke tampilan inventory_items.

Tampilan Pusat Distribusi, Item Inventaris, dan Produk dapat diakses dari pemilih kolom untuk Eksplorasi Item Inventaris.

Untuk informasi yang lebih spesifik tentang struktur LookML dalam file model, lihat halaman dokumentasi Istilah-istilah dan konsep LookML.

Baca halaman dokumentasi Parameter model, Parameter eksplorasi, dan Parameter gabungan untuk mempelajari parameter LookML lebih lanjut dalam file model.

File tampilan

File tampilan umumnya menentukan satu "tampilan" dalam Looker. Tampilan sesuai dengan satu tabel dalam database Anda atau satu tabel turunan. File tampilan menentukan tabel yang akan dikueri 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 mengetahui petunjuk 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 dasar atau perhitungan di Looker. Looker mengategorikan sebagian besar definisi ini 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 menampilkan kolom Created Date,