label (untuk kolom)

Bagian ini mengacu pada parameter label yang merupakan bagian dari kolom.

label juga dapat digunakan sebagai bagian dari model, yang dijelaskan di halaman dokumentasi parameter label (untuk model).

label juga dapat digunakan sebagai bagian dari Eksplorasi, yang dijelaskan di halaman dokumentasi parameter label (untuk Eksplorasi) .

label juga dapat digunakan sebagai bagian dari tampilan, yang dijelaskan di halaman dokumentasi parameter label (untuk tampilan).

label juga dapat digunakan sebagai bagian dari garis referensi, yang dijelaskan di halaman dokumentasi Parameter garis referensi dasbor.

Penggunaan

view: view_name {
  dimension: field_name {
    label: "desired label name"
  }
}

Hierarki Lihat File view Jenis Kolom label

Jenis Kolom yang Mungkin Dimensi, Grup Dimensi, Ukuran, Filter, Parameter Menerima String

Definisi

label membantu membuat Eksplorasi lebih mudah digunakan dengan memungkinkan Anda memilih cara nama kolom muncul di pemilih kolom dan di tabel data Eksplorasi. Jika tidak ada label yang ditentukan, label akan ditetapkan secara default ke nama kolom.

Catatan: label hanya memengaruhi cara nama kolom ditampilkan dalam konten Looker. label tidak memengaruhi cara Anda merujuk kolom di LookML atau mengubah nilai dalam database. Gunakan sintaksis ${view_name.field_name} dalam file LookML Anda untuk mereferensikan kolom dengan label.

Variabel Liquid dengan label

Anda dapat menggunakan variabel Liquid dengan parameter label. Variabel Liquid memungkinkan Anda mengakses data seperti informasi tentang model atau Eksplorasi, filter yang diterapkan ke kolom, dan nilai atribut pengguna. Anda dapat menggunakan variabel Liquid untuk mengubah nilai label secara dinamis, sehingga mengubah tampilan kolom di pemilih kolom dan visualisasi data.

Variabel Liquid yang menampilkan nilai berdasarkan filter, seperti _filters, atau yang mengharuskan kueri dijalankan terlebih dahulu, seperti in_query, tidak akan mengubah nama kolom di pemilih kolom. Dalam kasus tersebut, nama kolom hanya akan diubah dalam visualisasi yang dihasilkan.

Misalnya, variabel Liquid {{ _user_attributes['name_of_attribute'] }} menggantikan variabel Liquid dengan nilai atribut pengguna yang ditentukan. Jika pengguna memiliki atribut pengguna bernama name dengan nilai "John Smith", sintaksis label berikut akan mengubah nama kolom di pemilih kolom menjadi John Smith:

label: "{{ _user_attributes['name'] }}"

Pada contoh berikutnya, dimensi name menggunakan struktur Liquid {% if %} {% else %} {% endif %} dengan variabel Liquid _user_attributes['name_of_attribute'] untuk mengubah nilai label-nya, bergantung pada atribut pengguna perusahaan:

dimension: name {
  label: "{% if _user_attributes['company'] == 'Looker' %} Employee Name {% else %} Customer Name {% endif %}"
  sql: ${TABLE}.name ;;
}

Anda dapat melihat contoh tambahan penggunaan label dengan variabel Liquid untuk menentukan label dinamis di halaman Praktik Terbaik Cara menarik menggunakan Liquid dalam label.

Contoh

Buat ukuran ini muncul sebagai # Pelanggan, bukan Jumlah Pelanggan Unik di pemilih kolom.

measure: customer_count_distinct {
  label: "# of Customers"
  type: count_distinct
  sql: ${customer.id} ;;
}

Hal-hal yang perlu dipertimbangkan

IDE menandai label duplikat dalam tampilan

Untuk mencegah label kolom duplikat dalam tampilan yang sama, Looker IDE menampilkan ikon informasi berdasarkan nomor baris label kolom duplikat dalam file tampilan LookML. Jika Anda mengarahkan kursor ke ikon informasi berdasarkan nomor baris, tooltip akan menunjukkan bahwa sudah ada kolom dengan label dalam tampilan.

IDE Looker akan menampilkan informasi yang sama ini di panel Bantuan Cepat jika Anda memilih teks pernyataan label di IDE: