Mengubah menu Jelajah dan pemilih kolom

Anda dapat menggunakan sejumlah parameter LookML untuk membuat Jelajah lebih mudah digunakan dengan mengubah cara kolom muncul di antarmuka pengguna tanpa mengubah LookML pokok. Halaman ini memberikan ringkasan parameter LookML yang mengubah tampilan menu Jelajah Looker dan pemilih kolom.

Di Looker, pengguna dapat melihat Jelajah yang tercantum di menu Jelajah. Dalam Eksplorasi, pengguna dapat menggunakan pemilih kolom untuk memilih kolom (dimensi dan ukuran) yang akan digunakan untuk membuat kueri data mereka.
Jelajah tercantum di menu Jelajah di bawah nama model yang terkait. Pemilih kolom di Jelajah menampilkan daftar tampilan yang dapat diluaskan yang berisi kolom yang dapat Anda tambahkan ke kueri.

Halaman ini mencantumkan setiap parameter yang umum digunakan dengan link ke halaman referensi lengkapnya, deskripsi singkat tentang fungsinya, dan gambar tentang fungsinya.

Untuk mendapatkan tips dan saran tentang cara membuat Jelajah yang mudah digunakan, lihat halaman Praktik Terbaik Praktik terbaik: Menciptakan pengalaman positif bagi pengguna Looker.

Nama dan menu Jelajahi

Bagian ini menjelaskan perilaku default untuk nama dan tampilan Jelajah di menu Jelajah, lalu menjelaskan parameter LookML yang memungkinkan Anda mengubah perilaku tersebut:

Perilaku default menu Jelajahi

Nama model

Secara default, menu Jelajahi diatur berdasarkan nama model, yang ditentukan oleh nama setiap file model. Menu Jelajahi menampilkan versi nama model yang diformat, dengan garis bawah diubah menjadi spasi dan setiap kata diawali dengan huruf kapital. Di bawah setiap nama model terdapat daftar Jelajah yang ditentukan dalam file model tersebut.

Jelajahi nama

Nama setiap Jelajah di menu didasarkan pada parameter explore yang sesuai dalam file model. Seperti nama model, nama Jelajah diformat di menu sehingga garis bawah diubah menjadi spasi dan setiap kata menggunakan huruf besar. Nama Jelajah juga ditampilkan sebagai judul Jelajah di panel pemilih kolom.

Dalam contoh berikut, order_items Jelajah ditentukan dalam file model e_commerce_model.model:


explore: order_items {
  join: orders {
    type: left_outer
    sql_on: ${order_items.order_id} = ${orders.id} ;;
    relationship: many_to_one
  }
}

Eksplorasi order_items muncul sebagai Item Pesanan di menu Jelajah dan pemilih kolom.

Menu Jelajahi: Pemilih kolom:
Item Pesanan muncul dalam daftar Eksplorasi di menu Eksplorasi. Label Item Urutan muncul di kiri atas panel pemilih kolom.

Untuk informasi selengkapnya tentang file model, lihat halaman dokumentasi Memahami file model dan tampilan. Untuk informasi selengkapnya tentang cara menentukan Jelajah, lihat halaman dokumentasi parameter explore.

label (model)

Parameter label model mengganti nama model di menu Jelajahi tanpa mengubah cara model tersebut direferensikan di LookML. URL Jelajahi, Looker IDE, dan SQL Runner masih mencerminkan nama model yang sebenarnya; cara model harus dirujuk di setelan LookML dan Admin tetap tidak berubah.

Secara default, model market_research.model muncul sebagai Riset Pasar di menu Jelajah.

Anda dapat menggunakan parameter label untuk mengganti nama model di menu Jelajahi. Misalnya, Anda menambahkan kode label: "Marketing R&D" ke file model market_research.model:


label: "Marketing R&D"

Dalam contoh ini, Looker menampilkan nama model sebagai berikut di menu Jelajah:

Model Riset Pasar memiliki label Riset& Pengembangan Pemasaran di menu Jelajahi.

label (Jelajahi)

Parameter label Jelajah mengganti nama Jelajah di menu Jelajah dan di halaman Jelajah tanpa mengubah cara referensinya di LookML.

Jika parameter label tidak digunakan, nama Jelajah akan ditampilkan sesuai dengan perilaku defaultnya.

Jelajah dengan label Informasi Item Pesanan di menu Jelajah dan pemilih kolom.

group_label (Jelajahi)

Parameter group_label Jelajah mengubah pengaturan default menu Jelajah. Daripada mencantumkan setiap Jelajah di bawah nama modelnya, group_label memungkinkan Anda menentukan judul kustom untuk mencantumkan satu atau beberapa Jelajah.

Dalam contoh ini, Jelajahi Pelanggan, Inventaris, Item Pesanan, dan Data Pengguna tercantum di bawah label grup Kueri Toko Online:

Jelajah yang tercantum di bawah label grup Kueri Toko Online di menu Jelajah.

description (Jelajahi)

Parameter description Jelajah memungkinkan Anda menambahkan deskripsi Jelajah ke UI, sehingga pengguna dapat mendapatkan informasi tambahan saat membuat kueri Jelajah.

Pengguna dapat melihat deskripsi dengan mengarahkan kursor ke ikon informasi, di samping nama Jelajahi di bagian atas pemilih kolom. Ikon informasi juga muncul di daftar drop-down Jelajahi. Jika Anda tidak menambahkan deskripsi secara eksplisit ke Jelajahi, tidak ada deskripsi yang ditampilkan.

hidden (Jelajahi)

Parameter hidden Jelajah menyembunyikan Jelajah dari menu Jelajah. Secara default, hidden nonaktif dan Jelajah akan ditampilkan. hidden tidak menyembunyikan LookML atau mencegah akses ke Jelajah melalui URL. hidden tidak dimaksudkan sebagai fitur keamanan, melainkan sebagai fitur presentasi.

Misalnya, menambahkan kode LookML hidden: yes ke LookML untuk inventory Jelajahi dalam contoh berikut akan menyembunyikan Jelajahi Inventaris dari menu Jelajahi:


explore: inventory {
  hidden: yes

  join: order_facts {
    view_label: "Orders"
    relationship: many_to_one
    sql_on: ${order_facts.order_id} = ${order_items.order_id} ;;
  }
}

Pemilih kolom

Bagian ini menjelaskan perilaku default pemilih kolom, lalu menjelaskan parameter LookML yang memungkinkan Anda mengubah perilaku tersebut.

Ubah cara nama tampilan muncul di pemilih kolom dengan:

Ubah cara nama setiap kolom muncul di pemilih kolom dengan:

Ubah cara kolom diatur dalam pemilih kolom dengan:

Perilaku default pemilih kolom

Secara default, pemilih kolom diatur berdasarkan judul yang sesuai dengan tampilan yang ditentukan oleh parameter view LookML. Setiap kolom tampilan dikelompokkan dalam pemilih kolom. Jenis kolom (dimensi, grup dimensi, pengukuran, kolom filter, dan kolom parameter) menentukan tempat kolom ditampilkan dalam tampilan. Kecuali jika parameter label digunakan untuk mengubah nama tampilan, pemilih kolom akan menampilkan versi berformat dari nama kolom atau tampilan LookML, dengan garis bawah diubah menjadi spasi dan setiap kata diawali dengan huruf kapital.

Dalam contoh berikut, Looker menampilkan tampilan accounts sebagai Akun di pemilih kolom, yang merupakan perilaku default:


view: accounts {
  sql_table_name: accounts ;;
}

Contoh berikut menunjukkan cara nama dimensi, grup dimensi, dan ukuran ditampilkan secara default. Format yang sama akan berlaku untuk nama kolom filter dan kolom parameter.


dimension: account_number {
  primary_key: yes
  type: number
  sql: ${TABLE}.account_number ;;
}

dimension: name {
  type: string
  sql: ${TABLE}.name ;;
}

dimension_group: created {
  type: time
  timeframes: [raw, time, date, week, month, quarter, year]
  sql: ${TABLE}.created_date ;;
}

measure: average_annual_revenue {
  type: average
  sql: ${annual_revenue} ;;
  value_format_name: custom_amount_value_format
}

Dalam contoh ini, pemilih kolom menampilkan nama kolom default Account Number, Name, Created Date, dan Average Annual Revenue untuk dimensi account_number dan name, grup dimensi created, dan ukuran average_annual_revenue.

Jika Anda mengubah nama kolom, pemilih kolom akan menyesuaikan dengan nama baru, tetapi Anda mungkin ingin menambahkan parameter alias dengan nama kolom lama. Parameter tersebut memberikan nama alternatif untuk kolom yang mungkin muncul di URL untuk kueri. Hal ini dapat berguna jika nama kolom dalam model berubah, tetapi beberapa orang telah membagikan link ke data dan Anda ingin URL yang sudah ada tersebut tetap berfungsi.

view_label (Jelajahi)

Parameter view_label Jelajah mengubah cara kelompok kolom dari tampilan dasar Jelajah diberi label di pemilih kolom tanpa mengubah cara Jelajah dan kolomnya dirujuk di LookML.

Misalnya, jika Anda menggabungkan tampilan order_facts ke Jelajah yang disebut order_items, Anda dapat menggunakan parameter view_label untuk menetapkan label yang ditampilkan Looker untuk tampilan order_facts di pemilih kolom sebagai berikut:

explore: order_items {
  label: "Order Items"
  join: order_facts {
    view_label: "Orders and more"
    relationship: many_to_one
    sql_on: ${order_facts.order_id} = ${order_items.order_id} ;;
  }
}

Dalam contoh ini, tampilan order_facts muncul sebagai Pesanan dan lainnya di pemilih kolom Jelajahi Item Pesanan.

view_label (bergabung)

Parameter view_label join memungkinkan Anda mengelompokkan kolom dari satu tampilan dalam nama tampilan lain di pemilih kolom. Jika Anda tidak menambahkan view_label secara eksplisit ke join, view_label akan ditetapkan secara default ke nama join.

Misalnya, Anda menggabungkan tampilan products ke Pelajari product_facts:


explore: product_facts {
  join: products {
    type: left_outer
    sql_on: ${product_facts.product_id} = ${products.id} ;;
    relationship: many_to_one
  }
}

Dalam contoh ini, karena label tampilan tidak ditentukan, kolom dari tampilan products dikelompokkan dalam label tampilan Produk di pemilih kolom, terpisah dari tampilan Fakta Produk:

Kolom dari Tampilan produk dikelompokkan di bawah label Tampilan produk secara default.

Anda dapat menggunakan parameter view_label untuk menambahkan label tampilan ke tampilan products yang digabungkan, seperti pada contoh berikut:


explore: product_facts {
  join: products {
    view_label: "Product Facts"
    type: left_outer
    sql_on: ${product_facts.product_id} = ${products.id} ;;
    relationship: many_to_one
  }
}

Tindakan ini mengelompokkan kolom dari tampilan products di bagian label tampilan Fakta Produk di pemilih kolom:

Kolom dari tampilan Produk dikelompokkan dalam label tampilan Fakta Produk.

label (tampilan)

Parameter label tampilan mengubah cara tampilan diberi label di pemilih kolom tanpa mengubah cara tampilan dirujuk di LookML. Jika tidak ditentukan, label akan ditetapkan secara default ke nama tampilan. Tidak seperti view_label (Jelajahi) dan view_label (Gabung), parameter ini memengaruhi semua Jelajah yang menggunakan tampilan.

Misalnya, Anda dapat menggunakan parameter label untuk menentukan label untuk tampilan inventory_items sebagai berikut:


view: inventory_items {
  label: "Items in Inventory"
  sql_table_name: inventory_items ;;
}

Dalam contoh ini, pemilih kolom menampilkan label Items in Inventory untuk tampilan inventory_items, bukan label default Inventory Items.

description (kolom)

Anda dapat menambahkan description ke kolom mana pun. Untuk koneksi BigQuery, jika Anda membuat project LookML dari database, Looker akan otomatis mengisi deskripsi kolom dengan deskripsi dari metadata kolom BigQuery, jika ada.

Pengguna dapat melihat deskripsi ini di beberapa tempat. Looker menampilkan deskripsi saat pengguna memilih ikon informasi di sebelah kanan nama kolom di pemilih kolom.

Selain itu, Looker juga menampilkan deskripsi saat pengguna mengarahkan kursor ke nama kolom dalam visualisasi tabel atau diagram tabel di Jelajahi, dasbor, atau Tampilan.

hidden (kolom)

Secara default, kolom yang ditentukan dalam tampilan akan ditampilkan di pemilih kolom. Parameter hidden kolom menyembunyikan kolom di pemilih kolom.

Kolom tersembunyi masih dapat diakses di UI jika ditambahkan secara manual ke URL dan akan muncul di beberapa jendela Looker. Oleh karena itu, anggap hidden sebagai cara untuk menjaga pemilih kolom tetap bersih, dan bukan sebagai fitur keamanan.

Misalnya, menambahkan kode LookML hidden: yes ke LookML untuk dimensi product_id dalam contoh berikut akan menyembunyikan dimensi Product ID dari pemilih kolom:


dimension: product_id {
  hidden: yes
  type: number
  sql: ${TABLE}.product_id ;;
}

fields (kolom)

Parameter fields memungkinkan Anda menentukan kolom dari tampilan dasar dan join Eksplorasi yang ditampilkan di pemilih kolom. Jika Anda tidak menggunakan parameter fields, Looker akan mengekspos semua kolom.

Untuk menentukan kolom yang ingin ditampilkan di pemilih kolom, gunakan daftar kolom atau set yang dipisahkan koma. Untuk menentukan kolom yang ingin Anda sembunyikan dari pemilih kolom, gunakan kumpulan ALL_FIELDS* dengan daftar kolom atau kumpulan yang akan dikecualikan yang dipisahkan koma, dengan tanda hubung (-) di awal setiap kolom atau kumpulan.

Sebagai contoh, Anda dapat menggunakan kode LookML berikut untuk hanya menampilkan pilihan kolom dari Jelajah aircraft di pemilih kolom:


explore: aircraft {
  fields: [
    aircraft.aircraft_model_code,
    aircraft.aircraft_engine_code,
    aircraft.count,
    aircraft.city,
    aircraft.country,
    aircraft.zip,
   ]
}

Dalam contoh ini, Jelajah Aircraft hanya menampilkan dimensi Aircraft Model Code, Aircraft Engine Code, City, Country, dan Zip serta ukuran Count di pemilih kolom.

label (kolom)

Parameter label kolom memungkinkan Anda mengubah cara nama kolom akan muncul di pemilih kolom tanpa mengubah cara kolom tersebut dirujuk di LookML. Jika tidak ada label yang ditentukan, label akan ditetapkan secara default ke nama kolom.

Sebagai contoh, Anda dapat menggunakan parameter label untuk menetapkan label untuk dimensi cost sebagai berikut:


dimension: cost {
  label: "price"
  type: number
  sql: ${TABLE}.cost ;;
}

Dalam contoh ini, dimensi Biaya memiliki label harga di pemilih kolom.

view_label (kolom)

Parameter view_label kolom memungkinkan Anda mengubah nama tampilan tempat kolom tercantum di pemilih kolom tanpa mengubah cara kolom tersebut dirujuk di LookML. Jika tidak ada label yang ditentukan, kolom akan muncul di bawah label untuk tampilan tempat kolom tersebut ditentukan.

Misalnya, Anda dapat menggunakan parameter view_label sebagai berikut untuk menentukan label tampilan untuk dimensi cost:


dimension: cost {
  view_label: "Cost Information"
  type: number
  sql: ${TABLE}.cost ;;
}

Dalam contoh ini, Looker menampilkan dimensi Biaya di bagian label tampilan Informasi Biaya di pemilih kolom.

group_label (kolom)

Parameter group_label memungkinkan Anda menggabungkan kolom dalam daftar drop-down umum dalam tampilan di pemilih kolom.

Dalam contoh ini, grup Info Pengiriman menyertakan kolom Kota Pengiriman, Negara Pengiriman, dan Negara Bagian Pengiriman:

Grup Info Pengiriman di pemilih kolom Eksplorasi.

group_item_label (kolom)

Jika kolom ditampilkan di bawah label grup, kolom tersebut mungkin tidak perlu menampilkan nama atau label kolom lengkapnya di pemilih kolom. Dalam contoh yang ditampilkan sebelumnya untuk group_label (kolom), label grup sudah menunjukkan bahwa kolom tersebut berkaitan dengan pengiriman. Dalam kasus seperti ini, Anda dapat menambahkan parameter group_item_label ke setiap kolom yang dikelompokkan ini untuk mengubah tampilannya di bawah label grup.

Dalam contoh ini, grup Info Pengiriman menyertakan kolom Kota, Negara, dan Negara Bagian:

Grup Info Pengiriman di pemilih kolom Eksplorasi.