Mengubah menu Eksplorasi dan pemilih kolom

Anda dapat menggunakan sejumlah parameter LookML agar Jelajah lebih mudah digunakan dengan mengubah tampilan kolom di antarmuka pengguna tanpa mengubah LookML yang mendasarinya. Halaman ini menyediakan ringkasan parameter LookML yang mengubah tampilan menu Jelajah Looker dan pemilih kolom.

Di Looker, pengguna dapat melihat Jelajah yang tercantum di menu Jelajah. Dalam Jelajah, pengguna dapat menggunakan pemilih kolom untuk memilih kolom (dimensi dan ukuran) yang akan digunakan untuk membuat kueri data.
Jelajah tercantum dalam menu Eksplorasi di bawah nama modelnya. Pemilih kolom di Explore 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 mengetahui tips dan saran tentang cara membuat Explore yang mudah digunakan, lihat halaman Praktik Terbaik Praktik terbaik: Menciptakan pengalaman yang positif bagi pengguna Looker.

Menjelajahi nama dan menu

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

Menjelajahi perilaku default menu

Nama model

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

Nama eksplorasi

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

Pada contoh berikut, Jelajah order_items 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
  }
}

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

Menu Eksplorasi: Pemilih kolom:
Item Pesanan muncul dalam daftar Jelajah di menu Eksplorasi. Label Item Pesanan 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 menentukan Jelajah, lihat halaman dokumentasi parameter explore.

label (model)

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

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

Anda dapat menggunakan parameter label untuk mengganti nama model di menu Eksplorasi. 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 seperti berikut di menu Eksplorasi:

Model Riset Pasar memiliki label R&D Pemasaran di menu Jelajahi.

label (Jelajahi)

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

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

Explore dengan label Informasi Item Pesanan di menu Eksplorasi dan pemilih kolom.

group_label (Jelajahi)

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

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

Jelajah yang tercantum dalam label grup Kueri Toko Online di menu Eksplorasi.

description (Jelajahi)

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

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

hidden (Jelajahi)

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

Sebagai contoh, menambahkan kode LookML hidden: yes ke LookML untuk Explore inventory di contoh berikut akan menyembunyikan Inventory Explore dari menu Explore:


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 tampilan nama tampilan 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 disusun berdasarkan judul yang sesuai dengan tampilan yang ditentukan oleh parameter view LookML. Setiap kolom tampilan dikelompokkan di pemilih kolom. Jenis kolom (dimensi, grup dimensi, ukuran, 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 terformat dari tampilan atau nama kolom LookML, dengan garis bawah diubah menjadi spasi dan setiap kata ditulis dengan huruf kapital.

Dalam contoh berikut, Looker menampilkan tampilan accounts sebagai Akun di alat pilih 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 diterapkan pada 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 menunjukkan nama kolom default Nomor Rekening, Nama, Tanggal Dibuat, dan Pendapatan Tahunan Rata-Rata untuk dimensi account_number dan name, grup dimensi created, dan ukuran average_annual_revenue.

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

view_label (Jelajahi)

Parameter view_label Explore mengubah pelabelan grup kolom dari tampilan dasar Jelajah pada pemilih kolom tanpa mengubah cara Explore dan kolomnya direferensikan di LookML.

Misalnya, jika 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 alat pilih kolom Eksplorasi Item Pesanan.

view_label (gabung)

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

Misalnya, Anda menggabungkan tampilan products ke Eksplorasi 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 ke dalam label tampilan Produk di alat pilih kolom, terpisah dari tampilan Fakta Produk:

Kolom dari tampilan Produk dikelompokkan dalam label Tampilan produk secara default.

Anda dapat menggunakan parameter view_label untuk menambahkan label tampilan ke tampilan products yang digabungkan, seperti dalam 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
  }
}

Langkah ini mengelompokkan kolom dari tampilan products di bawah label tampilan Product Facts di pemilih kolom:

Kolom dari tampilan Produk dikelompokkan ke dalam label tampilan Fakta Produk.

label (tampilan)

Parameter label tampilan mengubah cara pelabelan tampilan di pemilih kolom tanpa mengubah cara mereferensikannya dalam LookML. Jika tidak ditentukan, label secara default akan mengikuti nama tampilan. Tidak seperti view_label (Explore) dan view_label (Join), parameter ini memengaruhi semua Jelajah yang menggunakan tampilan tersebut.

Sebagai contoh, Anda dapat menggunakan parameter label untuk menentukan label bagi tampilan inventory_items seperti berikut:


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

Dalam contoh ini, pemilih kolom menampilkan label Item dalam Inventaris untuk tampilan inventory_items, bukan label default Item Inventaris.

description (kolom)

Anda dapat menambahkan description ke kolom mana pun. Untuk koneksi BigQuery, jika Anda membuat project LookML dari database, Looker akan mengisi deskripsi kolom secara otomatis 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 Eksplorasi, 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, bukan sebagai fitur keamanan.

Sebagai contoh, 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 mana dari tampilan dasar dan gabungan Jelajah yang diekspos di pemilih kolom. Jika Anda tidak menggunakan parameter fields, Looker akan mengekspos semua kolom.

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

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


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

Dalam contoh ini, Jelajah Pesawat hanya menampilkan dimensi Kode Model Pesawat, Kode Mesin Pesawat, Kota, Negara, dan Kode Pos, serta ukuran Jumlah di alat pilih lapangan.

label (kolom)

Parameter label kolom memungkinkan Anda mengubah tampilan nama kolom di pemilih kolom tanpa mengubah cara kolom direferensikan 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 yang digunakan untuk mencantumkan kolom di pemilih kolom tanpa mengubah cara kolom direferensikan di LookML. Jika tidak ada label yang ditentukan, kolom akan muncul di bawah label untuk tampilan tempat kolom ditentukan.

Sebagai contoh, 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 pada label tampilan Informasi Biaya di pemilih kolom.

group_label (kolom)

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

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

Grup Info Pengiriman di pemilih kolom pada Explore.

group_item_label (kolom)

Saat kolom ditampilkan di bawah label grup, kolom tersebut mungkin tidak perlu menampilkan nama lengkap atau label kolom di pemilih kolom. Pada contoh yang ditampilkan sebelumnya untuk group_label (kolom), label grup sudah menunjukkan bahwa kolom terkait 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 mencakup kolom Kota, Negara, dan Negara Bagian:

Grup Info Pengiriman di pemilih kolom pada Explore.