Parameter diagram tabel (lama) untuk dasbor LookML

Halaman ini menunjukkan cara menambahkan dan menyesuaikan elemen dasbor LookML type: table dengan parameter dasbor LookML dalam file dashboard.lkml.

Untuk mengetahui informasi tentang cara membuat diagram tabel (lama) melalui UI Looker, lihat halaman dokumentasi Opsi diagram tabel (lama).

Contoh penggunaan


## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_table
height: N
width: N
top: N
left: N
row: N
col: N
refresh: N (seconds | minutes | hours | days)
note:
  text: 'note text'
  state: collapsed | expanded
  display: above | below | hover

## QUERY PARAMETERS
model: model_name
explore: explore_name
dimensions: [view_name.field_name, view_name.field_name, …]
measures: [view_name.field_name, view_name.field_name, …]
sorts: [view_name.field_name asc | desc, view_name.field_name, …]
pivots: [view_name.field_name, view_name.field_name, …]
limit: N
column_limit: N
filters:
  view_name.field_name: 'Looker filter expression' | 'filter value'
listen:
  dashboard_filter_name: dimension_or_measure_name
query_timezone: 'specific timezone' | user_timezone
merged_queries:
- 'primary query definition'
- 'next source query definition'
  join_fields:
  - field_name: view_name.field_name
    source_field_name: view_name.field_name

## PLOT PARAMETERS
table_theme: editable | white | gray | transparent | unstyled
total: true | false
row_total: right | left | false
show_row_numbers: true | false
hide_totals: true | false
hide_row_totals: true | false
hidden_fields: [view_name.field_name, view_name.field_name, …]
limit_displayed_rows: true | false
limit_displayed_rows_values:
  show_hide: show | hide
  first_last: first | last
  num_rows: 'N'

## SERIES PARAMETERS
truncate_column_names: true | false
show_view_names: true | false
series_labels:
  view_name.field_name: desired series label

## FORMATTING PARAMETERS
enable_conditional_formatting: true | false
conditional_formatting_include_totals: true | false
conditional_formatting_include_nulls: true | false
conditional_formatting:
  {'desired conditional formatting'}

Definisi parameter

Nama Parameter Deskripsi
Parameter Dasar
name (untuk elemen) Membuat elemen
title (untuk elemen) Mengubah cara nama elemen ditampilkan kepada pengguna
type (untuk elemen) Menentukan jenis visualisasi yang akan digunakan dalam elemen
height (untuk elemen) Menentukan tinggi elemen dalam satuan tile_size untuk dasbor layout: tile dan layout: static
width (untuk elemen) Menentukan lebar elemen dalam satuan tile_size untuk dasbor layout: tile dan layout: static
top Menentukan posisi atas ke bawah elemen dalam satuan tile_size untuk dasbor layout: static
left Menentukan posisi kiri-ke-kanan elemen dalam satuan tile_size untuk dasbor layout: static
row Menentukan posisi atas ke bawah elemen dalam satuan baris untuk dasbor layout: newspaper
col Menentukan posisi kiri ke kanan elemen dalam satuan kolom untuk dasbor layout: newspaper
refresh (untuk elemen) Menetapkan interval untuk elemen agar diperbarui secara otomatis
note Memulai bagian LookML untuk menentukan catatan untuk elemen. Parameter ini memiliki subparameter text, state, dan display.
Parameter Kueri
model Menentukan model yang akan digunakan untuk kueri elemen
explore (untuk elemen) Menentukan Explore yang akan digunakan untuk kueri elemen
dimensions Menentukan dimensi yang akan digunakan untuk kueri elemen
measures Menentukan ukuran yang akan digunakan untuk kueri elemen
sorts Menentukan pengurutan yang akan digunakan untuk kueri elemen
pivots Menentukan dimensi yang harus di-pivot untuk digunakan dalam kueri elemen
limit Menentukan batas baris yang akan digunakan untuk kueri elemen
filters (untuk elemen) Menentukan filter yang tidak dapat diubah untuk kueri elemen
listen Menentukan filter yang dapat diubah untuk kueri elemen, jika filters (untuk dasbor) telah dibuat
query_timezone Menentukan zona waktu yang harus digunakan saat kueri dijalankan
merged_queries Menentukan kueri hasil gabungan
Parameter Plot
table_theme Menerapkan salah satu dari lima opsi pewarnaan tabel ke visualisasi tabel
total Menentukan apakah total kolom ditampilkan untuk visualisasi tabel
row_total Menentukan apakah total baris ditampilkan untuk visualisasi tabel
show_row_numbers Menetapkan apakah akan menampilkan nomor baris di awal setiap baris tabel
hide_totals Menetapkan apakah visualisasi tabel menampilkan total kolom
hide_row_totals Menetapkan apakah visualisasi tabel menampilkan total baris
hidden_fields Menentukan kolom yang akan digunakan dalam kueri, tetapi disembunyikan dalam diagram
limit_displayed_rows Menampilkan atau menyembunyikan baris dalam visualisasi berdasarkan posisinya dalam hasil
limit_displayed_rows_values Menentukan baris yang akan ditampilkan atau disembunyikan dalam visualisasi. Parameter ini memiliki subparameter show_hide, first_last, dan num_rows.
Parameter Deret
truncate_column_names Mempersingkat header kolom dengan elipsis (…)
show_view_names Menampilkan nama tampilan beserta nama kolom untuk setiap header kolom
series_labels Menentukan label kustom untuk setiap kolom dalam visualisasi
Parameter Pemformatan
enable_conditional_formatting Menetapkan ke true untuk menentukan aturan kode warna untuk visualisasi tabel
conditional_formatting_include_totals Menentukan apakah total disertakan dalam skema kode warna
conditional_formatting_include_nulls Menentukan apakah nilai null harus direpresentasikan sebagai nol
conditional_formatting Menggunakan conditional_formatting dan subparameternya untuk menentukan aturan yang memberi kode warna pada visualisasi tabel Anda

Parameter dasar

Saat menentukan elemen dasbor LookML, Anda harus menentukan nilai setidaknya untuk parameter name dan type. Parameter dasar lainnya seperti title, height, dan width memengaruhi posisi dan tampilan elemen di dasbor.

name

Bagian ini mengacu pada parameter name yang merupakan bagian dari elemen dasbor.

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

Setiap deklarasi name membuat elemen dasbor baru dan memberinya nama. Nama elemen harus unik. Nama terkadang direferensikan dalam parameter elements saat Anda menggunakan dasbor layout: grid, atau dalam parameter group elemen turunan saat Anda mengatur elemen ke dalam grup ubin (type: group).

- name: orders_by_date

title

Bagian ini mengacu pada parameter title yang merupakan bagian dari elemen dasbor.

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

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

Parameter title memungkinkan Anda mengubah cara nama elemen akan ditampilkan kepada pengguna. Jika tidak ditentukan, judul akan ditetapkan secara default ke elemen name.

Perhatikan contoh berikut:

- name: sales_overview
  title: '1) Sales Overview'

Jika Anda menggunakan format ini, elemen akan muncul sebagai 1) Sales Overview, bukan Sales Overview.

type

Bagian ini mengacu pada parameter type yang merupakan bagian dari elemen dasbor.

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

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

type juga dapat digunakan sebagai bagian dari dimensi, yang dijelaskan di halaman dokumentasi Jenis dimensi, filter, dan parameter.

type juga dapat digunakan sebagai bagian dari ukuran, yang dijelaskan di halaman dokumentasi Jenis ukuran.

Parameter type menentukan jenis visualisasi yang akan digunakan dalam elemen.

- name: element_name
  type: text | looker_grid | table | single_value | looker_single_record |
        looker_column | looker_bar | looker_scatter | looker_line | looker_area |
        looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
        looker_map | looker_google_map | looker_geo_coordinates | looker_geo_choropleth |
        looker_waterfall | looker_wordcloud | looker_boxplot | button | group

Lihat halaman dokumentasi type (untuk dasbor LookML) guna mengetahui ringkasan berbagai jenis elemen dasbor LookML.

height

Bagian ini mengacu pada parameter height yang merupakan bagian dari elemen dasbor.

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

Untuk dasbor dengan tata letak tile atau static

Parameter height menentukan tinggi elemen, dalam satuan tile_size (yang ditentukan dalam piksel), untuk dasbor layout: tile dan layout: static.

Misalnya, kode berikut menentukan tile_size: 100 dan height: 4, sehingga elemen orders_by_date memiliki tinggi 400 piksel.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    height: 4
    ...

Untuk dasbor dengan tata letak newspaper

Parameter height menentukan tinggi elemen, dalam satuan baris, untuk dasbor layout: newspaper.

Dasbor dengan tata letak surat kabar secara default memiliki tinggi elemen 6 baris, atau sekitar 300 piksel. Tinggi minimum adalah 1 baris untuk dasbor dengan parameter preferred viewer yang ditetapkan ke dashboards-next. Tinggi minimum adalah 2 baris untuk dasbor dengan parameter preferred viewer yang ditetapkan ke dashboards.

Misalnya, kode berikut menetapkan elemen menjadi setinggi 12 baris, atau dua kali lebih tinggi dari elemen lain yang ditetapkan ke default:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    height: 12
    ...

width

Bagian ini mengacu pada parameter width yang merupakan bagian dari elemen dasbor.

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

Parameter width menentukan lebar elemen, dalam satuan tile_size, untuk dasbor layout: tile dan layout: static.

Misalnya, kode berikut menentukan tile_size: 100 dan width: 4, sehingga elemen orders_by_date memiliki lebar 400 piksel.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    width: 4
    ...

Parameter width menentukan lebar elemen, dalam satuan kolom, untuk dasbor layout: newspaper.

Dasbor dengan tata letak koran memiliki lebar default 24 kolom.

Misalnya, kode berikut menetapkan elemen ke setengah lebar dasbor:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    width: 12
    ...

top

Parameter top menentukan posisi elemen dari atas ke bawah, dalam satuan tile_size, untuk dasbor layout: static.

Misalnya, kode berikut menentukan tile_size: 100 dan top: 4, yang memosisikan tepi atas elemen orders_by_date 400 piksel dari bagian atas dasbor.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    top: 4
    ...

left

Parameter left menentukan posisi kiri-ke-kanan elemen, dalam satuan tile_size, untuk dasbor layout: static.

Misalnya, kode berikut menentukan tile_size: 100 dan left: 4, yang memosisikan tepi kiri elemen orders_by_date 400 piksel dari sisi kiri dasbor.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    left: 4
    ...

row

Untuk dasbor layout: newspaper, parameter row menentukan baris tempat tepi atas elemen ditempatkan. Jika elemen ditempatkan di dalam grup kartu menggunakan parameter group, row akan menentukan posisi baris elemen relatif terhadap bagian atas penampung grup (row: 0).

Dasbor dimulai dengan baris 0 di bagian atas dasbor. Dasbor dengan tata letak surat kabar secara default memiliki tinggi elemen 6 baris, yang berarti elemen dasbor di bagian atas dasbor (row: 0) secara default akan menempati baris 0-5.

Setiap baris memiliki tinggi 50 piksel, yang berarti tinggi elemen default 6 baris adalah 300 piksel.

Misalnya, kode berikut menetapkan elemen yang akan ditetapkan pada baris elemen kedua di dasbor, dengan asumsi elemen ditetapkan pada tinggi default:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    row: 6
    ...

col

Untuk dasbor layout: newspaper, parameter col menentukan kolom tempat tepi kiri elemen ditempatkan. Jika elemen ditempatkan di dalam grup kartu menggunakan parameter group, col menentukan posisi kolom elemen relatif terhadap tepi kiri penampung grup (col: 0).

Dasbor dibagi menjadi 24 kolom. Dasbor dimulai dengan kolom 0 di sebelah kiri dasbor. Dasbor dengan tata letak surat kabar secara default memiliki lebar elemen 8 kolom, yang berarti elemen dasbor di sebelah kiri dasbor (col: 0) secara default akan menempati kolom 0-7.

Misalnya, kode berikut menetapkan elemen yang akan ditetapkan di kolom ketiga elemen di dasbor:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    col: 16
    ...

refresh

Bagian ini mengacu pada parameter refresh yang merupakan bagian dari elemen dasbor.

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

Parameter refresh memungkinkan elemen dimuat ulang secara otomatis secara berkala, sehingga mengambil data baru. Hal ini sering kali berguna dalam setelan yang menampilkan dasbor secara terus-menerus, seperti di TV kantor. Perhatikan bahwa dasbor harus dibuka di jendela browser agar parameter ini dapat diterapkan. Setelan ini tidak berjalan di latar belakang untuk "melakukan pra-pemanasan" cache dasbor.

Kecepatan refresh dapat berupa angka (tanpa desimal) detik, menit, jam, atau hari. Contoh:

- name: orders_by_date
  refresh: 2 hours

Berhati-hatilah saat menetapkan interval refresh yang singkat. Jika kueri di balik elemen memerlukan banyak resource, elemen tertentu dapat membebani database Anda lebih dari yang diinginkan.

note

Anda dapat menambahkan catatan deskriptif ke elemen seperti ini:

- name: element_name
  note:
    text: 'note text'
    state: collapsed | expanded
    display: above | below | hover

note memiliki subparameter text, state, dan display.

text

Subparameter text menentukan teks yang ditampilkan dalam catatan. Teks dapat dilokalkan.

state

Subparameter state menentukan apakah catatan akan collapsed atau expanded jika terlalu besar untuk muat dalam satu baris dalam lebar elemen. Jika Anda memilih collapsed dan catatan terlalu panjang, catatan akan diakhiri dengan elipsis yang dapat diklik (...) untuk membaca catatan lengkap.

display

Subparameter display menentukan tempat catatan ditampilkan pada elemen. above menempatkan catatan di bagian atas elemen, below menempatkannya di bagian bawah elemen, dan hover mengharuskan pengguna mengarahkan kursor ke elemen untuk melihat catatan.

Parameter kueri

Saat menentukan elemen dasbor LookML, Anda harus menentukan nilai setidaknya untuk parameter kueri model dan explore, dan setidaknya satu kolom harus ditentukan menggunakan parameter dimensions atau parameter measures. Anda juga dapat menggunakan parameter kueri lain yang dijelaskan di bagian ini untuk mengontrol cara data ditampilkan dalam elemen dasbor.

model

Parameter model menentukan model yang akan digunakan untuk kueri elemen. Jika tidak ditentukan, model akan ditetapkan secara default ke model tempat dasbor berada.

- name: orders_by_date
  model: ecommerce

Parameter model menerima konstanta LookML. Anda dapat menentukan konstanta dalam file manifes untuk project Anda, lalu menggunakan sintaksis "@{constant_name}" untuk menetapkan konstanta sebagai nilai untuk model. Dengan menggunakan konstanta, Anda dapat menentukan nama model di satu tempat, yang sangat berguna jika Anda memperbarui nama model yang digunakan oleh beberapa elemen dasbor.

Untuk mengetahui informasi selengkapnya dan contoh penggunaan konstanta dengan dasbor LookML, lihat halaman dokumentasi parameter constant.

explore

Bagian ini mengacu pada parameter explore yang merupakan bagian dari elemen dasbor.

explore juga dapat digunakan sebagai bagian dari model, yang dijelaskan di halaman dokumentasi parameter explore.

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

Parameter explore menentukan Eksplorasi yang akan digunakan untuk kueri elemen.

- name: orders_by_date
  explore: order

Parameter explore menerima konstanta LookML. Anda dapat menentukan konstanta dalam file manifes untuk project Anda, lalu menggunakan sintaksis "@{constant_name}" untuk menetapkan konstanta sebagai nilai untuk explore. Dengan menggunakan konstanta, Anda dapat menentukan nama Eksplorasi di satu tempat, yang sangat berguna jika Anda memperbarui nama Eksplorasi yang digunakan oleh beberapa elemen dasbor.

Untuk mengetahui informasi selengkapnya dan contoh penggunaan konstanta dengan dasbor LookML, lihat halaman dokumentasi parameter constant.

dimensions

Parameter dimensions menentukan dimensi yang akan digunakan untuk kueri elemen. Gunakan sintaksis view_name.dimension_name untuk menentukan dimensi. Jangan sertakan dimensions jika kueri tidak memilikinya.

## single dimension example
- name: orders_by_date
  dimensions: order.order_date

## multiple dimension example
- name: orders_by_date
  dimensions: [order.order_date, customer.name]

measures

Parameter measures menentukan ukuran yang akan digunakan untuk kueri elemen. Gunakan sintaksis view_name.measure_name untuk menentukan ukuran. Jangan sertakan measures jika kueri tidak memilikinya.

## single measure example
- name: orders_by_date
  measures: order.count

## multiple measure example
- name: orders_by_date
  measures: [order.count, order_item.count]

sorts

Parameter sorts menentukan perilaku pengurutan untuk kueri elemen. Cantumkan kolom pengurutan utama terlebih dahulu, diikuti dengan kolom pengurutan sekunder. Gunakan sintaksis view_name.field_name untuk menentukan dimensi atau ukuran yang akan diurutkan.

Jika Anda menghapus parameter sorts, elemen akan menggunakan urutan pengurutan default Looker. Pengurutan menaik tidak memerlukan akhiran, sedangkan pengurutan menurun memerlukan akhiran desc.

Contoh berikut menentukan satu pengurutan:

- name: orders_by_date
  sorts: order.order_date desc

Contoh berikut menentukan beberapa pengurutan:

- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

Jika melakukan pivot dimensi, Anda dapat mengurutkan hasil kueri dengan menentukan nama ukuran, arah pengurutan, dan nomor indeks berbasis 0 dari kolom target dalam tabel data. Misalnya, elemen berikut mengurutkan berdasarkan kolom pivot pertama menggunakan indeks 0:

- name: orders_by_category
  sorts: [orders.count desc 0]

Untuk mengurutkan berdasarkan total baris, tentukan indeks kolom total. Misalnya, elemen berikut mengurutkan berdasarkan total baris menggunakan indeks 2, yang mewakili kolom total untuk kueri dengan dua kolom pivot:

- name: orders_by_cohort
  sorts: [users.count desc 2]

pivots

Parameter pivots menentukan dimensi yang harus di-pivot untuk kueri elemen. Gunakan sintaksis view_name.dimension_name untuk menentukan dimensi. Jangan sertakan pivots jika kueri tidak memilikinya.

## single pivot example
- name: orders_by_date
  pivots: customer.gender

## multiple pivot example
- name: orders_by_date
  pivots: [customer.gender, customer.age_tier]

limit

Parameter limit menentukan batas baris yang harus digunakan untuk kueri elemen. Batas ini berlaku untuk jumlah baris sebelum pivot diterapkan.

- name: orders_by_date
  limit: 100

filters

Bagian ini mengacu pada parameter filters yang merupakan bagian dari elemen dasbor.

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

filters juga dapat digunakan sebagai bagian dari ukuran, yang dijelaskan di halaman dokumentasi parameter filters.

Parameter filters menentukan filter yang tidak dapat diubah yang harus digunakan untuk kueri elemen. Jika Anda ingin filter yang dapat diubah pengguna di dasbor, Anda harus menyiapkan filter menggunakan filters untuk dasbor, lalu menerapkannya ke elemen menggunakan listen.

Sintaksis untuk filters adalah:

- name: element_name
  filters:
    orders.created_date: 2020/01/10 for 3 days
    orders.status: Shipped
    # You can create multiple filter statements

Setiap filter dapat menerima ekspresi filter Looker atau konstanta nilai. Anda juga dapat menggunakan variabel Liquid _localization atau _user_attributes dalam ekspresi filter untuk nilai filter yang fleksibel.

listen

Filter dasbor memungkinkan pelihat menyaring data yang ditampilkan dalam elemen dasbor secara interaktif. Tentukan filter dasbor dengan parameter filters untuk dasbor LookML. Kemudian, gunakan parameter listen untuk menautkan elemen dasbor ke filter dasbor.

Sintaksis untuk listen adalah sebagai berikut:

- name: element_name
  listen:
    filter_name_goes_here: dimension or measure on which to apply
                           the filter using view_name.field_name syntax
    # You can add more than one listen statement

Tambahkan parameter listen ke elemen, lalu berikan nama filter diikuti dengan titik dua dan referensi ke kolom yang akan diterapkan filter, menggunakan sintaksis view_name.field_name. Misalnya, Anda dapat membuat filter bernama Date yang mengharuskan pengguna memasukkan tanggal ke kolom filter di UI. Kemudian, Anda dapat menerapkan nilai yang dimasukkan pengguna ke elemen orders_by_date seperti ini:

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

  elements:
 - name: orders_by_date
    listen:
      date: order.order_date
    ...

Jika filter yang dipantau dikonfigurasi dengan parameter vis_filter: true, kontrol filter akan muncul di panel filter langsung di bagian atas ubin visualisasi tersebut, bukan di panel filter dasbor atas.

Untuk contoh tambahan penggunaan parameter filters dan parameter listen untuk menerapkan filter dasbor ke elemen dasbor tertentu, lihat Membuat dasbor LookML.

query_timezone

Parameter query_timezone menentukan zona waktu tempat kueri akan dijalankan. Opsi zona waktu ditampilkan di halaman dokumentasi Nilai untuk timezone. Jika ingin kueri dijalankan menggunakan zona waktu pelihat, Anda dapat menetapkan nilainya sebagai user_timezone.

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

merged_queries

Parameter merged_queries memungkinkan Anda menggabungkan hasil beberapa kueri ke dalam satu elemen dasbor. Tentukan setiap kueri sumber dalam parameter merged_queries elemen dan gunakan subparameter join_fields untuk menentukan cara hasil harus digabungkan.

Kode LookML contoh berikut membuat elemen type: looker_grid hasil gabungan. Dalam contoh ini, parameter merged_queries digunakan untuk membuat elemen dasbor yang menggabungkan data dari dua kueri terpisah ke dalam satu diagram tabel:

- name: merged_results_element
  title: Merged Results Tile
  type: looker_grid
  merged_queries:
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.count, users.city]
    sorts: [users.count desc 0]
    limit: 5000
    column_limit: 50
    query_timezone: UTC
    listen:
    - State: users.state
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.city]
    sorts: [users.state]
    limit: 500
    column_limit: 50
    query_timezone: UTC
    join_fields:
    - field_name: users.state
      source_field_name: users.state
    - field_name: users.city
      source_field_name: users.city
    listen:
    - State: users.state

Dalam contoh ini, elemen dasbor menggabungkan data dari dua kueri sumber yang didasarkan pada Eksplorasi users dalam model ecommerce. Kueri utama mencakup kolom users.state, users.count, dan users.city, serta mengurutkan hasilnya berdasarkan kolom users.count. Kueri sumber kedua menyertakan kolom users.state dan users.city serta mengurutkan hasilnya berdasarkan kolom users.state.

Parameter join_field menggabungkan kueri sumber berdasarkan nilai yang cocok di kolom users.state dan users.city.

Parameter listen menerapkan filter State ke kedua kueri, yang memungkinkan pelihat dasbor menyaring hasil kueri yang ditampilkan di tile dasbor dengan memilih negara bagian tertentu.

Contoh: Menggabungkan data perusahaan

Misalkan Anda ingin membuat kueri gabungan yang menggabungkan informasi tentang perusahaan dari dua Eksplorasi yang berbeda: company_info dan companies. Anda ingin menggabungkan kueri pada kolom ipo.stock_symbol, companies.name, dan companies.contact_email dari setiap Explore untuk membuat kueri yang menampilkan hasil untuk nama perusahaan, email kontak perusahaan, tahun IPO, simbol saham, jumlah karyawan, dan jumlah lowongan. Anda dapat menentukan elemen kueri gabungan di LookML sebagai berikut:

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email

Menerapkan filter ke elemen kueri gabungan

Contoh elemen kueri gabungan sebelumnya menunjukkan cara menerapkan filter hard code langsung dalam setiap kueri sumber menggunakan parameter filters. Misalnya, filter companies.contact_email: "-NULL" dan ipo.valuation_amount: NOT NULL dalam kueri utama membatasi hasil untuk perusahaan yang memiliki email kontak dan valuasi yang valid. Filter tingkat kueri ini memfilter data di awal sebelum menggabungkan kueri dan tidak dapat diubah oleh pengguna.

Anda juga dapat menerapkan filter dasbor ke elemen kueri gabungan menggunakan parameter listen dalam definisi setiap kueri sumber. Misalnya, Anda memiliki filter dasbor bernama Industry yang Anda tentukan di tingkat dasbor menggunakan parameter filters untuk dasbor LookML:

filters:
- name: Industry
  title: Industry
  type: field_filter
  ui_config:
    type: dropdown_menu
    display: inline
  model: market_research
  explore: company_info
  field: companies.industry

Untuk menerapkan filter Industry ke kolom companies.industry di kedua kueri sumber, tambahkan parameter listen ke setiap definisi kueri sumber dari kueri gabungan sebagai berikut:

listen:
  Industry: companies.industry

Misalnya, kode contoh berikut menambahkan filter Industry ke kedua kueri sumber dalam elemen hasil gabungan dari contoh sebelumnya.

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
    listen:
      Industry: companies.industry
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email
    listen:
      Industry: companies.industry

Dengan penambahan ini, saat pengguna berinteraksi dengan filter dasbor Industry, kueri sumber yang sesuai dalam elemen kueri gabungan akan difilter sebagaimana mestinya.

Parameter plot

Parameter berikut sesuai dengan opsi di bagian Plot di editor visualisasi untuk diagram tabel (lama).

table_theme

Gunakan parameter table_theme untuk menerapkan salah satu opsi pewarnaan tabel berikut ke elemen tabel:

  • editable: Tabel memiliki dimensi biru, ukuran oranye, dan kalkulasi tabel hijau.
  • white: Header tabel berwarna putih, baris data bergantian antara putih dan abu-abu, dan teks berwarna hitam.
  • gray: Header tabel berwarna abu-abu, baris data bergantian antara putih dan abu-abu muda, dan teks berwarna abu-abu gelap.
  • transparent: Header tabel sepenuhnya transparan, baris data bergantian antara sepenuhnya transparan dan abu-abu tembus cahaya, dan warna teks menyesuaikan sendiri dari hitam menjadi putih sesuai kebutuhan menurut warna latar belakang yang terlihat. Menetapkan table_theme ke transparent dapat berguna saat Anda menggunakan dasbor tersemat yang disesuaikan sehingga warna latar belakang ubin terlihat melalui visualisasi.
  • unstyled: Header tabel dan baris data berwarna putih, dan teks berwarna hitam.

table_theme: editable | white | gray | transparent | unstyled

total

Parameter total menetapkan apakah baris total ditampilkan di bagian bawah tabel. Lihat Menampilkan total untuk mengetahui informasi selengkapnya.

total: true | false

## default value: false

row_total

Parameter row_total menetapkan apakah kolom total ditampilkan di sebelah kanan atau kiri tabel. Hanya berfungsi jika ada pivot. Lihat Menampilkan Total untuk mengetahui informasi selengkapnya.

row_total: right | left | false

## default value: false

show_row_numbers

Parameter show_row_numbers menetapkan apakah nomor baris akan ditampilkan di awal setiap baris tabel.


show_row_numbers: true | false

hide_totals

Jika Eksplorasi Anda menyertakan total kolom, hide_totals akan menetapkan apakah visualisasi menampilkan total tersebut.


hide_totals: true | false

hide_row_totals

Jika Eksplorasi Anda menyertakan total baris, hide_row_totals akan menetapkan apakah total baris akan ditampilkan dalam visualisasi.


hide_row_totals: true | false

hidden_fields

Parameter hidden_fields menunjukkan kolom mana, jika ada, yang digunakan dalam kueri, tetapi disembunyikan dalam diagram. Setiap kolom tersembunyi akan muncul di bagian tabel data di Explore.

hidden_fields: [inventory_items.count, distribution_centers.id]

limit_displayed_rows

Parameter limit_displayed_rows memungkinkan Anda menampilkan atau menyembunyikan baris dalam visualisasi, berdasarkan posisinya dalam hasil. Misalnya, jika visualisasi Anda menampilkan rata-rata penggiliran 7 hari, Anda mungkin ingin menyembunyikan 6 baris pertama. Menetapkan parameter ini ke true memungkinkan Anda menentukan nilai dan posisi dalam visualisasi yang akan diterapkan menggunakan parameter limit_displays_rows_values dan subparameternya.

limit_displayed_rows: true
limit_displayed_rows_values:
  show_hide: hide | show
  first_last: first | last
  num_rows: '10'

limit_displayed_rows_values

Gunakan parameter limit_displayed_rows_values, dan subparameternya show_hide, first_last, dan num_rows, dengan limit_displayed_rows untuk menentukan baris yang akan ditampilkan atau disembunyikan dalam visualisasi. Lihat bagian limit_displayed_rows untuk contoh penggunaan.

show_hide

Subparameter show_hide menetapkan apakah akan menyembunyikan baris tertentu dari visualisasi. Tetapkan show_hide ke show untuk menampilkan hanya sejumlah baris terbatas dalam visualisasi, dan tetapkan show_hide ke hide untuk mengecualikan baris tertentu dari visualisasi.

first_last

Subparameter first_last menetapkan apakah baris yang akan disembunyikan atau ditampilkan akan menjadi baris pertama atau terakhir dalam kumpulan hasil. Menetapkan first_last ke first akan menampilkan atau menyembunyikan baris pertama, sedangkan menetapkan first_last ke last akan menampilkan atau menyembunyikan baris terakhir.

num_rows

Subparameter num_rows menetapkan jumlah baris yang akan disembunyikan atau ditampilkan. Misalnya, num_rows: '10' akan menampilkan atau menyembunyikan 10 baris pertama atau terakhir dari set hasil dari visualisasi.

Parameter deret

Parameter berikut sesuai dengan opsi di bagian Series di editor visualisasi untuk diagram tabel (lama).

truncate_column_names

Parameter truncate_column_names menetapkan apakah header kolom harus dipersingkat dengan elipsis (...).


truncate_column_names: true | false

show_view_names

Parameter show_view_names menentukan apakah nama tampilan ditampilkan di label diagram, seperti nama sumbu dan nama kolom.

show_view_names: true | false

## default value: true

series_labels

Tetapkan label satu atau beberapa deret berdasarkan nama deret, menggunakan pasangan name: label.

Untuk diagram yang di-pivot, nama deret adalah nama pivot.

series_labels:
  'Yes': iOS Users
  'No': Android Users

Untuk diagram dengan beberapa ukuran, nama deret adalah nama kolom ukuran.

series_labels:
  inventory_items.count: Inventory
  orders.count: Orders

Memformat parameter

Parameter berikut sesuai dengan opsi di bagian Pemformatan editor visualisasi untuk diagram tabel (lama).

enable_conditional_formatting

Menyetel enable_conditional_formatting ke true memungkinkan Anda menentukan aturan yang memberi kode warna pada visualisasi tabel, baik dalam skala maupun dengan menentukan nilai yang diinginkan.


enable_conditional_formatting: true | false

conditional_formatting_include_totals

Jika enable_conditional_formatting ditetapkan ke true, conditional_formatting_include_totals menentukan apakah total disertakan dalam skema kode warna.


conditional_formatting_include_totals: true | false

conditional_formatting_include_nulls

Jika enable_conditional_formatting ditetapkan ke true, conditional_formatting_include_nulls menentukan apakah nilai null harus direpresentasikan sebagai nol.


conditional_formatting_include_nulls: true | false

conditional_formatting

Dengan enable_conditional_formatting yang ditetapkan ke true, gunakan parameter conditional_formatting untuk menentukan aturan yang memberi kode warna pada visualisasi tabel Anda. Untuk setiap aturan format bersyarat, Anda dapat menentukan setelan dengan parameter berikut:

Berikut adalah contoh aturan format bersyarat:


conditional_formatting: [{type: less than, value: 20, background_color: "#9fdee0",
  font_color: "#b15928", bold: true, italic: false, strikethrough: false,
  fields: [order_items.count], color_application: {collection_id: my-custom-colors,
  palette_id: my-custom-colors-sequential-0}}]

type

Parameter type menentukan apakah akan memberi kode warna pada nilai di sepanjang skala atau berdasarkan kondisi logis.

Jika Anda memberi kode warna pada nilai dalam skala, Anda dapat menetapkan type ke along a scale....

Jika Anda memberi kode warna pada nilai berdasarkan kondisi logis, Anda dapat menentukan salah satu nilai berikut untuk type, beserta nilai untuk value:

  • equal to: Aturan ini berlaku untuk nilai yang sama dengan angka yang ditentukan untuk value.
  • not equal to: Aturan ini berlaku untuk nilai yang tidak sama dengan angka yang ditentukan untuk value.
  • greater than: Aturan ini berlaku untuk nilai yang lebih besar dari angka yang ditentukan untuk value.
  • less than: Aturan ini berlaku untuk nilai yang kurang dari angka yang ditentukan untuk value.
  • between: Aturan ini berlaku untuk nilai yang berada di antara dua angka yang ditentukan untuk value.
  • not between: Aturan ini berlaku untuk nilai yang tidak berada di antara dua angka yang ditentukan untuk value.
  • 'null': Aturan hanya berlaku untuk nilai null.
  • not null: Aturan hanya berlaku untuk nilai yang bukan null.

type: along a scale... | equal to | not equal to | less than | between | not between | 'null' | not null

value

Jika Anda memberi kode warna pada nilai berdasarkan kondisi logis selain 'null' atau not null, tentukan nilai yang akan diterapkan aturan. Parameter value menggunakan satu angka atau, jika type ditetapkan ke between atau not between, satu set yang berisi dua angka.


value: N | [N, N]

background_color

Jika kode warna Anda didasarkan pada kondisi logis (type ditetapkan ke nilai selain along a scale...), gunakan parameter background_color untuk menentukan warna latar belakang bagi nilai yang menerapkan aturan Anda.


background_color: "#49cec1"

font_color

Jika kode warna Anda didasarkan pada kondisi logis (type ditetapkan ke nilai selain along a scale...), gunakan parameter font_color untuk menentukan warna font bagi nilai yang menerapkan aturan Anda.


font_color: "#1f3e5a"

color_application

Parameter color_application, serta subparameternya collection_id, palette_id, dan options, dapat digunakan untuk menerapkan koleksi dan palet warna tertentu ke aturan format bersyarat.

Anda dapat menambahkan warna ke dasbor LookML berdasarkan ID koleksi dan ID palet, jika Anda memilikinya. Anda juga dapat menggunakan UI untuk menemukan warna yang diinginkan dan membuat LookML untuk menambahkannya ke dasbor. Buka konten yang ditentukan pengguna (seperti Look, dasbor, atau Explore), dan terapkan warna yang Anda inginkan ke visualisasi konten tersebut menggunakan UI. Setelah melakukannya, Anda dapat mengikuti langkah-langkah untuk mendapatkan LookML dasbor, menyalin LookML yang dihasilkan, dan menempelkannya di bagian color_application. Untuk ringkasan koleksi warna standar Looker, lihat halaman dokumentasi Koleksi warna.

Subparameter options dapat digunakan jika Anda telah menetapkan type ke along a scale.... Parameter ini memiliki parameter turunan berikut:

  • steps: Parameter ini membatasi jumlah warna yang digunakan ke nilai yang diberikan dan memisahkan data ke dalam jumlah grup tersebut. Jika parameter ini tidak digunakan, data akan diwarnai sesuai dengan gradien yang mencakup seluruh palet. Properti ini menerima nilai dari 2 hingga 100.
  • mirror: Jika ditetapkan ke true, parameter ini menerapkan pergeseran warna yang sama di kedua sisi palet warna untuk nilai yang sama di kedua sisi titik tengah yang ditentukan. Properti ini menerima true atau false.
  • constraints: Parameter ini menetapkan rentang data yang menerapkan pemformatan bersyarat dan menetapkan titik tengah yang akan digunakan untuk penerapan palet. Fungsi ini menerima sintaksis berikut: constraints: {min: {type: number, value: 3}, max: {type: percentile, value: 99}, mid: {type: average}}
  • reverse: Parameter ini menentukan apakah akan membalikkan palet warna selama penerapan warna. Properti ini menerima true atau false.

bold

Saat memberi kode warna berdasarkan kondisi logis, tetapkan apakah akan menebalkan nilai yang menerapkan aturan Anda.


bold: true | false

italic

Saat memberi kode warna berdasarkan kondisi logis, tetapkan apakah akan memiringkan nilai yang menerapkan aturan Anda.


italic: true | false

strikethrough

Saat memberi kode warna berdasarkan kondisi logis, tetapkan apakah akan menerapkan format coret ke nilai untuk aturan Anda.


strikethrough: true | false

fields

Tentukan kolom yang akan diterapkan aturan Anda. Secara default, aturan ini berlaku untuk semua kolom numerik.


fields: [ view_name.field_name ]