deskripsi (untuk kolom)

Halaman ini mengacu pada parameter description yang merupakan bagian dari kolom.

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

description juga dapat digunakan sebagai bagian dari dasbor, yang dijelaskan di halaman dokumentasi Parameter dasbor.

Penggunaan

view: view_name {
  dimension: field_name {
    description: "description string"
  }
}

Hierarki Lihat File view Jenis Kolom description

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

Definisi

Anda dapat menambahkan deskripsi ke kolom. 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 kolom di beberapa tempat.

Misalnya, untuk dimensi yang ditentukan dengan LookML ini:

dimension: id {
  primary_key: yes
  description: "Unique ID for the order"
  type: string
  sql: ${TABLE}.id ;;

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 Look.

Menggunakan variabel Liquid dalam parameter description

Anda dapat menggunakan variabel Liquid dengan parameter description untuk kolom. Hal ini berguna, misalnya, saat Anda ingin Looker menampilkan deskripsi yang berbeda untuk kolom berdasarkan atribut pengguna, atau berdasarkan Eksplorasi tempat kueri dijalankan.

Misalnya, jika Anda ingin deskripsi untuk kolom berbeda-beda bergantung pada Eksplorasi tempat kueri dijalankan, Anda dapat menggunakan variabel Liquid _explore._name dalam struktur {% else %} {% endif %} {% if %} Liquid:

dimension: user_id {
  description:
   "{% if _explore._name == 'order_items' %}
      The user ID for the Order Items Explore
    {% elsif _explore._name == 'inventory_items' %}
      The user ID for the Inventory Items Explore
    {% else %}
      The user ID
    {% endif %}"
}

Dalam contoh ini, jika kueri dijalankan di Eksplorasi Item Pesanan, deskripsi untuk dimensi ID Pengguna adalah ID pengguna untuk Eksplorasi Item Pesanan. Di Eksplorasi Item Inventaris, deskripsinya adalah ID pengguna untuk Eksplorasi Item Inventaris. Di Eksplorasi lainnya, deskripsi ID pengguna akan ditampilkan.

Sebagai contoh lain, misalkan Anda ingin menampilkan deskripsi yang berbeda kepada pengguna yang berbeda, bergantung pada departemen mereka. Jika Anda telah menentukan atribut pengguna bernama Departemen, Anda dapat menggunakan variabel Liquid _user_attributes['name_of_attribute'] dalam struktur {% if %} {% else %} {% endif %} Liquid untuk menentukan deskripsi yang berbeda, bergantung pada nilai atribut pengguna Departemen:

dimension: gross_margin {
  description:
   "{% if _user_attributes['department'] == 'Marketing' %}
      The standard margin for a field
    {% elsif _user_attributes['department'] == 'Sales' %}
      The operating margin for a field
    {% else %} The gross margin for a field {% endif %}"
  type: number
  value_format_name: usd
  sql: ${sale_price} - ${inventory_items.cost} ;;
}

Dalam contoh ini, deskripsi yang ditampilkan untuk dimensi Margin Kotor berbeda-beda, bergantung pada apakah pengguna adalah bagian dari tim Pemasaran, Penjualan, atau tim lainnya.

Anda dapat menggunakan variabel Liquid seperti _model._name, _view._name, _explore._name, _field._name, dan _user_attributes['name_of_attribute'] dengan parameter description. Lihat halaman dokumentasi Referensi variabel Liquid untuk mengetahui informasi selengkapnya tentang penggunaan parameter Liquid dengan LookML, dan untuk melihat variabel Liquid mana yang dapat digunakan dengan parameter description.

Yang perlu diketahui

Deskripsi ditampilkan satu kali per grup dimensi

Untuk grup dimensi, Looker hanya menampilkan deskripsi satu kali untuk seluruh grup, dan bukan untuk setiap dimensi jangka waktu dalam grup.