Parameter diagram tabel untuk dasbor LookML

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

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

Contoh penggunaan


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

## QUERY PARAMETERS
model: model_name
explore: explore_name
fields: [view_name.field_name, view_name.field_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, …]
fill_fields: [view_name.field_name, view_name.field_name, …]
subtotals: [view_name.field_name, view_name.field_name, …]
total: true | false
row_total: right | left | false
limit: N
column_limit: N
filters:
  view_name.field_name: 'Looker filter expression' | 'filter value'
filter_expression:  'Looker custom filter expression'
listen:
  dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone
analysis_config: # can only be used when the Forecasting Labs feature is enabled
  forecasting:
  - confidence_interval: N
    field_name: view_name.field_name
    forecast_n: N
    forecast_interval: day | month | a time frame with dimension fill
    seasonality: N
merged_queries:
- 'primary query definition'
- 'next source query definition'
  join_fields:
  - field_name: view_name.field_name
    source_field_name: view_name.field_name

## COLUMN PARAMETERS
auto_size_all_columns: true | false
column_order: [view_name.field_name, view_name.field_name, …]
pinned_columns:
    view_name.field_name: left

## PLOT PARAMETERS
table_theme: editable | white | gray | transparent | unstyled
show_row_numbers: true | false
hide_totals: true | false
hide_row_totals: true | false
transpose: 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_text: true | false
show_view_names: true | false
size_to_fit: true | false
dynamic_fields:
- table_calculation: {'table calculation definition'}
- measure: {'custom measure or custom filtered measure definition'}
- dimension: {'custom dimension definition'}
series_labels:
    view_name.field_name: 'Series Label'
series_column_widths:
    view_name.field_name: N
series_cell_visualizations:
    view_name.field_name:
        is_active: true | false
        palette:
            palette_id: 'palette ID'
            collection_id: 'collection ID'
            custom_colors:
            - 'color value'
        value_display: true | false
series_text_format:
    view_name.field_name:
        fg_color: 'color value'
        bg_color: 'color value'
        bold: true | false
        italic: true | false
        align: left | center | right
series_collapsed:
    view_name.field_name: true | false
series_value_format:
    view_name.field_name:
        format_string: 'value formatting string'

## FORMATTING PARAMETERS
color_application:
    collection_id: 'collection ID'
    palette_id: 'palette ID'
header_font_color: 'color value'
header_background_color: 'color value'
header_text_alignment: left | center | right
header_font_size: N
rows_font_size: N
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 elemen kiri-ke-kanan dalam satuan tile_size untuk dasbor layout: static
row Menentukan posisi elemen dari atas ke bawah dalam satuan baris untuk dasbor layout: newspaper
col Menentukan posisi elemen dari kiri ke kanan dalam satuan kolom untuk dasbor layout: newspaper
refresh (untuk elemen) Menetapkan interval saat elemen akan diperbarui secara otomatis
note_state Menentukan apakah catatan akan diciutkan atau diluaskan jika terlalu besar untuk dimuat dalam satu baris dalam lebar elemen
note_display Menentukan tempat catatan ditampilkan pada elemen
note_text Menentukan teks yang ditampilkan dalam catatan
Parameter Kueri
model Menentukan model yang akan digunakan untuk kueri elemen
explore (untuk elemen) Menentukan Eksplorasi yang akan digunakan untuk kueri elemen
fields Menentukan kolom yang akan digunakan untuk kueri elemen. Ini dapat digunakan sebagai pengganti dimensions dan measures.
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
fill_fields Menentukan dimensi yang menggunakan opsi pengisian dimensi
subtotals Menentukan kolom yang disubtotal
total Menentukan apakah total kolom ditampilkan untuk visualisasi tabel
row_total Menentukan apakah total baris ditampilkan untuk visualisasi tabel
limit Menentukan batas baris yang akan digunakan untuk kueri elemen
column_limit Menentukan batas kolom yang akan digunakan untuk kueri elemen
filters (untuk elemen) Menentukan filter yang tidak dapat diubah untuk kueri elemen
filter_expression Menentukan filter kustom 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
analysis_config Ditambahkan 21.14 Menentukan analisis perkiraan yang harus dilakukan saat kueri dijalankan. Memerlukan fitur Lab Perkiraan diaktifkan.
merged_queries Menentukan kueri hasil gabungan
Parameter Kolom
auto_size_all_columns Secara otomatis mengubah ukuran setiap kolom tabel sesuai dengan lebar judul kolom atau nilai data terpanjang, mana pun yang lebih lebar
column_order Mengatur urutan kolom dalam diagram tabel
pinned_columns Menentukan kolom yang akan disematkan, atau dibekukan, di sisi kiri diagram tabel
Parameter Plot
table_theme Menerapkan salah satu dari lima opsi pewarnaan tabel ke 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 atau tidak
hide_row_totals Menetapkan apakah visualisasi tabel menampilkan total baris atau tidak
transpose Menetapkan apakah akan mentransposisikan baris tabel menjadi kolom
hidden_fields Menentukan kolom yang akan digunakan dalam kueri, tetapi disembunyikan dari diagram
limit_displayed_rows Menampilkan atau menyembunyikan baris dalam visualisasi berdasarkan posisinya dalam hasil
Parameter Seri
truncate_text Memendekkan header kolom dan teks di dalam sel data dengan elipsis (…)
show_view_names Menampilkan nama tampilan beserta nama kolom untuk setiap header kolom
size_to_fit Secara otomatis menyesuaikan lebar semua kolom sehingga tabel sesuai dengan lebar elemen tempat tabel ditampilkan
dynamic_fields Menyertakan kalkulasi tabel atau kolom kustom dalam diagram tabel
series_labels Menentukan label kustom untuk setiap kolom dalam visualisasi
series_column_widths Menentukan lebar tertentu untuk kolom dalam visualisasi
series_cell_visualizations Menentukan apakah kolom menggunakan opsi visualisasi Visualisasi Sel. Parameter ini memiliki subparameter is_active, palette, dan value_display.
series_text_format Menentukan tata letak teks sel untuk setiap kolom. Parameter ini memiliki subparameter fg_color, bg_color, bold, italic, dan align.
series_collapsed Menentukan apakah kolom yang memiliki subtotal akan muncul dalam keadaan diciutkan
series_value_format Menentukan format nilai untuk kolom menggunakan pemformatan kustom
Parameter Pemformatan
color_application Menerapkan warna ke visualisasi sel dan format bersyarat
header_font_color Menerapkan warna font ke header kolom
header_background_color Menerapkan warna ke latar belakang header kolom
header_text_alignment Menerapkan perataan kiri, kanan, atau tengah ke header kolom
header_font_size Menerapkan ukuran font ke header kolom
rows_font_size Menerapkan ukuran font ke teks di dalam sel data
enable_conditional_formatting Tetapkan ke true untuk menentukan aturan kode warna untuk visualisasi tabel
conditional_formatting_include_totals Menentukan apakah total disertakan dalam skema pengkodean 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 untuk setidaknya 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 menetapkan nama untuknya. Nama elemen harus unik. Nama terkadang direferensikan dalam parameter elements saat Anda menggunakan dasbor layout: grid.

- 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, bukan elemen yang muncul sebagai Ringkasan Penjualan, elemen tersebut akan muncul sebagai 1) Ringkasan Penjualan.

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 gabungan, yang dijelaskan di halaman dokumentasi parameter type (untuk gabungan).

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 pengukuran, yang dijelaskan di halaman dokumentasi Jenis pengukuran.

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

Lihat halaman dokumentasi type (untuk dasbor LookML) untuk 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 koran 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 tinggi elemen menjadi 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 secara default memiliki lebar 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, 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 elemen dari kiri ke kanan, 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.

Dasbor dimulai dengan baris 0 di bagian atas dasbor. Dasbor dengan tata letak koran 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 untuk ditempatkan di baris kedua elemen 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.

Dasbor dibagi menjadi 24 kolom. Dasbor dimulai dengan kolom 0 di sebelah kiri dasbor. Dasbor dengan tata letak koran 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 berdasarkan periode tertentu, sehingga mengambil data baru. Hal ini sering kali berguna dalam setelan saat dasbor terus ditampilkan, 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 "memanaskan" cache dasbor.

Frekuensi pengambilan data dapat berupa angka (tanpa desimal) dalam detik, menit, jam, atau hari. Contoh:

- name: orders_by_date
  refresh: 2 hours

Harap berhati-hati saat menyetel interval pemuatan ulang singkat. Jika kueri di balik elemen tersebut menggunakan banyak resource, elemen tertentu dapat membebani database Anda lebih dari yang diinginkan.

note_state

Parameter note_state menentukan apakah catatan akan diciutkan atau diperluas jika terlalu besar untuk dimuat dalam satu baris dalam lebar elemen. Jika Anda memilih collapsed dan catatan terlalu panjang, catatan akan diakhiri dengan elipsis yang dapat diklik (...) yang dapat digunakan untuk membaca catatan lengkap. Jika Anda memilih expanded dan catatan panjang, catatan akan berlanjut ke baris tambahan.

note_display

Parameter note_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 mouse ke ikon ? untuk melihat catatan.

note_text

Parameter note_text menentukan teks yang ditampilkan dalam catatan elemen.

Parameter kueri

Saat menentukan elemen dasbor LookML, Anda harus menentukan nilai untuk setidaknya parameter kueri model dan explore, dan setidaknya satu kolom harus ditentukan menggunakan parameter dimensions, parameter measures, atau parameter fields. 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, nilai defaultnya adalah model tempat dasbor berada.

- name: orders_by_date
  model: ecommerce

Parameter model menerima konstanta LookML. Anda dapat menentukan konstanta dalam file manifes untuk project, 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, 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.

fields

Parameter fields menentukan kolom yang akan digunakan untuk kueri elemen. Gunakan sintaksis view_name.dimension_name untuk menentukan kolom.

## single field example
- name: orders_by_date
  fields: order.order_date

## multiple fields example
- name: orders_by_date
  fields: [order.order_date, order.order_count]

Jika menggunakan parameter fields, Anda tidak perlu menggunakan parameter dimensions dan measures.

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 atau 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 pengurutan yang akan digunakan untuk kueri elemen. Pengurutan utama dicantumkan terlebih dahulu, lalu pengurutan sekunder, dan seterusnya. Gunakan sintaksis view_name.field_name untuk menentukan dimensi atau ukuran. Jangan sertakan sorts jika Anda ingin menggunakan urutan pengurutan default Looker. Pengurutan menurun memiliki akhiran desc; pengurutan menaik tidak memerlukan akhiran.

## single sort example
- name: orders_by_date
  sorts: order.order_date desc

## multiple sort example
- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

pivots

Parameter pivots menentukan dimensi yang harus diputar 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]

fill_fields

Parameter fill_fields menentukan dimensi yang menggunakan opsi pengisian dimensi. Gunakan sintaksis view_name.dimension_name untuk menentukan dimensi.

- name: orders_by_date
  fill_fields: [orders.created_date, orders.shipped_date]

subtotals

Parameter subtotals menentukan dimensi yang menggunakan opsi subtotals. Gunakan sintaksis view_name.dimension_name untuk menentukan dimensi.

subtotals: [products.department, distribution_centers.name]

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 titik pusat. Lihat Menampilkan Total untuk mengetahui informasi selengkapnya.

row_total: right | left | false

## default value: false

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

column_limit

Parameter column_limit menentukan batas kolom yang harus digunakan untuk kueri elemen. Batas berlaku untuk jumlah kolom setelah pivot diterapkan.

- name: orders_by_date
  column_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 pengukuran, yang dijelaskan di halaman dokumentasi parameter filters.

Parameter filters menentukan filter yang tidak dapat diubah yang harus digunakan untuk kueri elemen. Jika Anda menginginkan 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.

filter_expression

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

- name: element_name
  filter_expression:
  - diff_days(${users.created_date},${user_order_facts.first_order_date}) > 60

Halaman dokumentasi Ekspresi filter Looker mencantumkan ekspresi filter Looker.

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 yang diikuti dengan titik dua dan referensi ke kolom tempat filter harus diterapkan, menggunakan sintaksis view_name.field_name. Misalnya, Anda dapat membuat filter bernama Tanggal yang mengharuskan pengguna memasukkan tanggal ke dalam 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
    ...

Untuk contoh tambahan penggunaan parameter filters dan parameter listen untuk menerapkan filter dasbor ke setiap elemen dasbor, lihat Membangun 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 nilai sebagai user_timezone.

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

analysis_config

Parameter analysis_config dan subparameternya menjelaskan analisis kueri yang akan digunakan dengan visualisasi, mulai di Looker 21.14. Fitur Labs Perkiraan harus diaktifkan untuk melakukan analisis pada visualisasi.

Subparameter berikut dapat digunakan untuk menentukan analisis:

Anda dapat membuat perkiraan menggunakan sintaksis seperti ini:


  analysis_config:
    - forecasting:
      confidence_interval: 0.95
      field_name: orders.count
      forecast_n: 14
      forecast_interval: day
      seasonality: 7

forecasting

forecasting adalah jenis analisis yang menerapkan perkiraan ke visualisasi. Peramalan memungkinkan analis menambahkan proyeksi data dengan cepat ke kueri Jelajah baru atau yang sudah ada untuk membantu pengguna memprediksi dan memantau titik data tertentu.

Untuk mengetahui informasi selengkapnya, lihat halaman dokumentasi Perkiraan dalam visualisasi.

Untuk menambahkan perkiraan ke visualisasi, fitur Labs Perkiraan harus diaktifkan.

confidence_interval

confidence_interval menetapkan batas nilai data yang diperkirakan, yang dimasukkan sebagai ekspresi desimal persentase. confidence_interval bersifat opsional dan kosong secara default.


confidence_interval: 0.99 | 0.98 | 0.95 | 0.90 | 0.80

Lihat bagian Interval prediksi di halaman dokumentasi Peramalan dalam visualisasi.

Untuk menambahkan perkiraan ke visualisasi, fitur Labs Perkiraan harus diaktifkan.

field_name

field_name menentukan nama ukuran — hingga lima — yang akan disertakan dalam perkiraan.


field_name: view_name.field_name

forecast_n

forecast_n menentukan durasi perkiraan.


forecast_n: N # An integer that represents the length of the forecast

Lihat bagian Panjang di halaman dokumentasi Perkiraan dalam visualisasi.

Untuk menambahkan perkiraan ke visualisasi, fitur Labs Perkiraan harus diaktifkan.

forecast_interval

forecast_interval menetapkan interval durasi untuk memperkirakan nilai data. forecast_interval diisi secara otomatis berdasarkan dimensi jangka waktu dalam kueri Jelajah.


forecast_interval: day | month # a timeframe with dimension fill

Lihat halaman dokumentasi Panjang.

Untuk menambahkan perkiraan ke visualisasi, fitur Labs Perkiraan harus diaktifkan.

seasonality

seasonality memungkinkan analis memperhitungkan siklus yang diketahui atau tren data berulang dalam perkiraan. seasonality bersifat opsional dan kosong secara default.


seasonality: N # An integer that represents the number of rows over which a cycle or pattern repeats

Setelan musiman Otomatis ditampilkan sebagai nilai seasonality kosong.

Lihat bagian Musiman di halaman dokumentasi Peramalan dalam visualisasi.

Untuk menambahkan perkiraan ke visualisasi, fitur Labs Perkiraan harus diaktifkan.

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 penggabungan hasil.

Kode LookML contoh berikut membuat elemen hasil gabungan dari type: looker_grid. 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 hasil menurut kolom users.count. Kueri sumber kedua mencakup kolom users.state dan users.city serta mengurutkan hasil menurut 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 kartu dasbor dengan memilih negara bagian tertentu.

Contoh: Menggabungkan data perusahaan

Misalkan Anda ingin membuat kueri gabungan yang menggabungkan informasi tentang perusahaan dari dua Jelajah yang berbeda: company_info dan companies. Anda ingin menggabungkan kueri pada kolom ipo.stock_symbol, companies.name, dan companies.contact_email dari setiap Eksplorasi untuk membuat kueri yang menampilkan hasil untuk nama perusahaan, email kontak perusahaan, tahun IPO, simbol saham, jumlah karyawan, dan jumlah lowongan kerja. 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 yang dikodekan secara permanen 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 ke perusahaan yang memiliki email kontak dan penilaian yang valid. Filter tingkat kueri ini memfilter data terlebih dahulu 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 dengan 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 kueri gabungan sebagai berikut:

listen:
  Industry: companies.industry

Misalnya, contoh kode 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 dengan tepat.

Parameter kolom

Parameter berikut sesuai dengan kemampuan untuk memindahkan dan menyematkan kolom dalam diagram tabel.

auto_size_all_columns

Parameter auto_size_all_columns secara otomatis menyesuaikan ukuran setiap kolom tabel dengan lebar judul kolom atau nilai data terpanjang, mana pun yang lebih lebar. Parameter ini menggantikan parameter series_column_widths dan size_to_fit, jika ditentukan.

- name: orders_by_date
  auto_size_all_columns: true

column_order

Parameter column_order menentukan urutan kolom dalam diagram tabel.

- name: orders_by_date
  column_order: [customer.city, customer.state, customer.count]

pinned_columns

Parameter pinned_columns menentukan kolom yang disematkan di sebelah kiri diagram tabel.

- name: orders_by_date
  pinned_columns:
    orders.created_date: left
    distribution_centers.name: left

Parameter plot

Parameter berikut sesuai dengan opsi di menu Plot pada editor visualisasi untuk diagram tabel.

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, serta teks berwarna abu-abu tua.
  • transparent: Header tabel benar-benar transparan, baris data bergantian antara benar-benar transparan dan abu-abu transparan, dan warna teks menyesuaikan diri dari hitam ke putih sesuai kebutuhan menurut warna latar belakang yang terlihat. Menetapkan table_theme ke transparent dapat berguna saat Anda menggunakan dasbor sematan yang disesuaikan sehingga warna latar belakang kartu terlihat melalui visualisasi.
  • unstyled: Header tabel dan baris data berwarna putih, dan teks berwarna hitam.

table_theme: editable | white | gray | transparent | unstyled

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 menentukan apakah visualisasi menampilkan total.


hide_totals: true | false

hide_row_totals

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


hide_row_totals: true | false

transpose

Parameter transpose memungkinkan Anda mentransposisikan baris tabel menjadi kolom. Properti ini menerima true atau false.

- name: orders_by_date
  transpose: true

hidden_fields

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

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. Dengan menyetelnya ke true, Anda dapat menentukan nilai dan posisi dalam visualisasi yang berlaku 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. Menyetel first_last ke first akan menampilkan atau menyembunyikan baris pertama, sedangkan menyetel 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 menu Deret pada editor visualisasi untuk diagram tabel.

truncate_text

Parameter truncate_text menetapkan apakah header kolom dan teks di dalam sel data harus dipersingkat dengan elipsis (…).


truncate_text: 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

size_to_fit

Parameter size_to_fit menetapkan apakah akan menyesuaikan lebar semua kolom sehingga tabel sesuai dengan lebar elemen tempat tabel ditampilkan. Jika parameter auto_size_all_columns disetel ke true, parameter tersebut akan menggantikan size_to_fit.


size_to_fit: true | false

dynamic_fields

Parameter dynamic_fields dan subparameternya menjelaskan kalkulasi tabel atau kolom kustom yang akan digunakan dengan visualisasi. Anda harus memiliki izin untuk membuat kolom kustom guna menambahkan description hingga 255 karakter atau menggunakan calculation_type untuk grup kustom atau kelompok kustom. Anda harus memiliki izin untuk membuat penghitungan tabel guna menambahkan description hingga 255 karakter ke penghitungan tabel atau menggunakan calculation_type untuk penghitungan pintas.

Subparameter berikut dapat digunakan untuk menentukan kolom dinamis:

Anda dapat membuat kalkulasi tabel menggunakan sintaksis seperti ini:

dynamic_fields:
  - table_calculation: running_total
    label: Running Total of Items
    expression: running_total(${inventory_items.count})
    value_format_name: decimal_0
    description: your description of up to 255 characters here
    _kind_hint: measure
    _type_hint: number
    is_disabled: false

Anda dapat membuat penghitungan pintasan untuk beberapa jenis penghitungan menggunakan sintaksis seperti ini:

dynamic_fields:
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent of Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_of_column_sum
  table_calculation: percent_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent of previous - Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_of_previous
  table_calculation: percent_of_previous_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent change from previous - Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_difference_from_previous
  table_calculation: percent_change_from_previous_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Rank of Orders Count
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: rank_of_column
  table_calculation: rank_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Running total of Orders Count
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: running_total
  table_calculation: running_total_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number

Anda dapat membuat ukuran kustom untuk digunakan dalam visualisasi menggunakan sintaks seperti ini:

dynamic_fields:
  - measure: avg_sale_price
    label: Average Sale Price
    based_on: products.sale_price
    type: average
    value_format_name: usd
    description: your description of up to 255 characters here
    _kind_hint: measure
    _type_hint: number

Anda dapat membuat ukuran kustom yang difilter untuk digunakan dalam visualisasi menggunakan sintaksis seperti ini:

dynamic_fields:
  - measure: order_count_for_25_47_year_olds
    based_on: order_items.order_count
    type: count_distinct
    label: Order Count for 25- to 47-Year-Olds
    description: your description of up to 255 characters here
    value_format: 00#
    _kind_hint: measure
    _type_hint: number
    filter_expression: "${users.age} >= 25 AND ${users.age} <= 47"

Anda dapat membuat dimensi kustom untuk digunakan dalam visualisasi menggunakan sintaksis seperti ini:

dynamic_fields:
  - dimension: user_city_state
    label: User City and State
    expression: concat(${users.city}, ", ", ${users.state})
    description: your description of up to 255 characters here
    _kind_hint: dimension
    _type_hint: string

Anda dapat membuat grup kustom untuk dimensi yang akan digunakan dalam visualisasi menggunakan sintaksis seperti ini:

  - category: dimension
  description: 'States by region'
  label: State Groups
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: group_by
  dimension: state_groups
  args:
  - users.state
  - - label: Pacific Northwest
      filter: Oregon,Idaho,Washington
  - Other
  _kind_hint: dimension
  _type_hint: string

Anda dapat membuat kelompok kustom untuk dimensi yang akan digunakan dalam visualisasi menggunakan sintaksis seperti ini:

- category: dimension
  description: Order item sale prices, in tiers of 10
  label: Sale Price Bins
  value_format:
  value_format_name:
  calculation_type: bin
  dimension: sale_price_bins
  args:
  - order_items.sale_price
  - '10'
  - '0'
  - '100'
  -
  - classic
  _kind_hint: dimension
  _type_hint: string

Anda dapat menambahkan beberapa kolom dinamis ke elemen. Anda tidak perlu menambahkan penghitungan tabel ke parameter fields agar muncul dalam visualisasi, tetapi Anda perlu menambahkan jenis kolom dinamis lainnya ke fields agar muncul.

table_calculation

Jika Anda menentukan kalkulasi tabel, subparameter table_calculation akan memberi nama kalkulasi tabel. Ini adalah nama yang akan digunakan saat Anda mereferensikan penghitungan tabel di LookML.

measure

Subparameter measure menentukan nama untuk ukuran kustom atau ukuran kustom yang difilter. Ini adalah nama yang Anda gunakan untuk mereferensikan ukuran dalam LookML.

dimension

Subparameter dimension menentukan nama untuk dimensi kustom. Ini adalah nama yang akan digunakan untuk mereferensikan dimensi di LookML.

label

Subparameter label menentukan judul kolom dinamis seperti yang Anda inginkan agar muncul dalam visualisasi. Nama ini bisa sama atau berbeda dengan nama yang diberikan di subparameter table_calculation, measure, atau dimension.

based_on

Jika Anda menggunakan ukuran kustom atau ukuran kustom yang difilter, subparameter based_on mengidentifikasi ukuran yang menjadi dasarnya, menggunakan sintaksis view_name.field_name.

type

Jika Anda menggunakan ukuran kustom, subparameter type mengidentifikasi jenis agregasi. Menerima count_distinct, sum, average, min, max, atau median.

description

Anda dapat menambahkan deskripsi hingga 255 karakter ke kolom kustom atau penghitungan tabel dengan subparameter description. Looker menampilkan deskripsi saat pengguna mengklik ikon informasi di sebelah kanan nama kolom di pemilih kolom, dan saat pengguna mengarahkan kursor ke nama kolom dalam visualisasi tabel atau diagram tabel di Eksplorasi, dasbor, atau Look.

expression

Jika Anda menggunakan penghitungan tabel, subparameter expression menentukan ekspresi Looker yang digunakan untuk membuat penghitungan tabel.

filter_expression

Jika Anda menggunakan ukuran yang difilter kustom, subparameter filter_expression menentukan ekspresi Looker yang digunakan untuk memfilter ukuran.

value_format

Subparameter value_format opsional menentukan format nilai untuk kolom dinamis saat Anda menggunakan pemformatan kustom. Jika Anda ingin menggunakan format Looker default, gunakan value_format_name.

value_format_name

Subparameter value_format_name opsional menerapkan format default ke kolom dinamis. Jika Anda ingin menggunakan format kustom, gunakan value_format.

calculation_type

Subparameter calculation_type menentukan jenis fungsi Kalkulasi Pintas atau Grup untuk membuat kalkulasi tabel, atau untuk membuat grup kustom untuk dimensi:

Opsi Kolom kustom calculation_type:

  • group_by — Mengelompokkan nilai dimensi dalam label tetap kustom, berdasarkan kondisi kustom yang ditentukan. Mirip dengan CASE WHEN di SQL, atau parameter kolom case LookML.
  • bin — Mengelompokkan nilai dalam bin kustom, atau tingkat, untuk dimensi jenis numerik dan dimensi kustom. Mirip dengan jenis dimensi LookML tier.

Opsi calculation_type penghitungan tabel:

  • percent_of_column_sum — Nilai baris dibagi dengan jumlah nilai dalam kolom. Penghitungan ini hanya menyertakan nilai yang ada dalam tabel data saat batas baris kueri telah tercapai.
  • percent_of_previous — Nilai baris saat ini dibagi dengan nilai baris berikutnya.
  • percent_difference_from_previous — Selisih antara nilai baris saat ini dan nilai baris berikutnya, dibagi dengan nilai baris berikutnya.
  • rank_of_column — Peringkat nilai baris di antara semua nilai dalam kolom. Penghitungan ini hanya menyertakan nilai yang ada dalam tabel data saat batas baris kueri telah tercapai.
  • running_total — Jumlah kumulatif nilai baris saat ini dan semua nilai baris sebelumnya dalam kolom.
  • percent_of_previous_column — Untuk kolom yang di-pivot, nilai kolom saat ini dibagi dengan nilai kolom di sebelah kirinya.
  • percent_change_from_previous_column — Untuk kolom yang di-pivot, selisih antara nilai kolom saat ini dan nilai kolom di sebelah kiri, dibagi dengan nilai kolom di sebelah kiri.
  • percent_of_row — Untuk kolom yang di-pivot, persentase nilai kolom saat ini dibagi dengan jumlah baris kolom tersebut.
  • running_row_total — Untuk kolom yang di-pivot, jumlah kumulatif kolom saat ini dan semua kolom sebelumnya dalam baris ini.

args untuk grup kustom

Jika Anda menggunakan grup kustom untuk dimensi, args menentukan argumen untuk menerapkan label tetap ke nilai dimensi. args menggunakan format berikut:

args:
- view_name.field_name
  - label: specified custom label
    filter: condition for values
  - label: another specified custom label
    filter: a different condition for values
- Other ## An optional customizable group label for values that do not meet specified conditions.

Anda dapat menambahkan kondisi label dan filter sebanyak yang diperlukan, bergantung pada jumlah grup yang diinginkan.

Lihat contoh sebelumnya untuk referensi.

args untuk kelompok kustom

Jika Anda menggunakan kelompok kustom untuk dimensi numerik, args menentukan argumen untuk menerapkan tingkat tetap ke nilai dimensi. args menggunakan format berikut:

  args:
  - view_name.field_name
  - bin_size ## The numeric interval on which to base each bin, in single quotes
  - min ## The numeric value of the minimum bin size, in single quotes
  - max ## The numeric value of the maximum bin size, in single quotes
  - override ## A value will only appear when a custom bin uses a Custom-sized bin type.
  - style ## The bin display style. Currently, only classic is supported.

Lihat contoh sebelumnya untuk referensi.

args untuk penghitungan pintasan

Subparameter args adalah tempat Anda menentukan nama kolom numerik yang Anda gunakan untuk Penghitungan Pintas. Argumen menggunakan format berikut:

- args:
  - view_name.field_name   ## the field on which the calculation is based

Lihat contoh sebelumnya untuk referensi.

_kind_hint

Subparameter _kind_hint opsional mengidentifikasi apakah kolom dinamis menampilkan dimensi atau ukuran. Properti ini menerima nilai dimension dan measure.

_type_hint

Subparameter _type_hint opsional mengidentifikasi jenis data yang harus dihasilkan oleh ekspresi kolom dinamis.

is_disabled

Subparameter is_disabled opsional menentukan apakah penghitungan tabel muncul dalam visualisasi dan Explore pokoknya. Properti ini menerima nilai true dan false.

series_labels

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

Untuk diagram yang diputar, nama deret adalah nama perputaran.

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

series_column_widths

Tetapkan lebar satu atau beberapa kolom berdasarkan nama deret. Jika parameter auto_size_all_columns disetel ke true, parameter tersebut akan menggantikan series_column_widths.

series_column_widths:
  order_times.shipping_time: 50
  orders.count: 60

series_cell_visualizations

Tentukan apakah satu atau beberapa kolom menggunakan opsi Visualisasi Sel dengan menunjukkan nama deret menggunakan format view_name.field_name. series_cell_visualizations memiliki subparameter is_active, palette, dan value_display.

series_cell_visualizations:
  order_items.count:
    is_active: true
    palette:
      palette_id: my-custom-colors-sequential-0
      collection_id: my-custom-colors
    value_display: true

is_active

Subparameter is_active opsional menerima true atau false untuk menunjukkan apakah visualisasi batang diaktifkan untuk deret tersebut. Jika is_active tidak ditentukan, nilai defaultnya adalah true.

palette

Subparameter palette bersifat opsional. Jika tidak digunakan, palet akan ditetapkan secara default ke palet yang berbeda dalam koleksi warna default instance.

Jika palette digunakan, parameter turunan palette_id dan collection_id menerapkan warna dari palet tertentu ke visualisasi batang. Untuk palette_id, Anda harus menggunakan ID palet berurutan atau berbeda. Untuk mengetahui informasi selengkapnya tentang ID palet dan ID koleksi warna, lihat bagian color_application.

palette memiliki parameter turunan alternatif, custom_colors, yang menetapkan dua hingga lima warna kustom untuk digunakan pada batang:

series_cell_visualizations:
  order_items.count:
    palette:
      custom_colors:
      - orange
      - "#0000ff"
      - red

value_display

Subparameter value_display opsional menerima true atau false untuk menunjukkan apakah nilai untuk setiap sel data ditampilkan bersama dengan visualisasi sel. Jika value_display tidak ditentukan, nilai defaultnya adalah true.

series_text_format

Parameter series_text_format dan subparameternya menentukan tata letak teks sel untuk setiap kolom. Deret yang akan diformat ditunjukkan menggunakan sintaksis view_name.field_name, dan subparameter menjelaskan pemformatan.

Semua subparameter bersifat opsional; hanya gunakan yang Anda butuhkan.

  series_text_format:
    order_items.shipping_time:
      align: right
    order_items.shipped_date:
      align: center
      fg_color: "#EA8A2F"
      bg_color: "#64518A"
      bold: true
      italic: true

fg_color

Subparameter fg_color menunjukkan warna font untuk teks sel. Nilai warna dapat berupa string hex, seperti #2ca6cd, atau string warna bernama CSS, seperti mediumblue.

bg_color

Subparameter bg_color menunjukkan warna latar belakang sel. Nilai warna dapat berupa string hex, seperti #2ca6cd, atau string warna bernama CSS, seperti mediumblue.

bold

Subparameter bold menunjukkan apakah teks sel dicetak tebal dan menerima true atau false.

italic

Subparameter italic menunjukkan apakah teks sel miring dan menerima true atau false.

align

Subparameter align menunjukkan perataan teks sel dan menerima left, center, atau right.

series_collapsed

Parameter series_collapsed menentukan apakah akan ciutkan atau luaskan subtotal untuk deret tertentu. Identifikasi deret menggunakan sintaksis view_name.field_name dan true atau false.

series_collapsed:
  users.city: false
  users.state: true

Jika kolom diciutkan, setiap elemen yang membentuk subtotal akan ditampilkan dengan mengklik panah di sisi kiri sel data.

series_value_format

Parameter series_value_format menentukan pemformatan yang akan diterapkan ke deret, terlepas dari pemformatan yang diterapkan ke dimensi atau ukuran pokok. Jika series_value_format tidak ditentukan, nilai akan ditampilkan dalam format dimensi atau ukuran pokok.

Identifikasi deret yang akan diformat menggunakan sintaksis view_name.field_name.

Subparameter format_string memungkinkan Anda menentukan format untuk deret, menggunakan pemformatan gaya Excel.

series_value_format:
  products.retail_price:
    format_string: "$#,##0.00"

Anda juga dapat menentukan pemformatan seperti ini:


series_value_format:
  order_items.count: "00#"

Format yang digunakan dalam subparameter format_string sama dengan format yang digunakan dengan value_format parameter LookML. Anda dapat membaca cara menentukan format ini di halaman dokumentasi Menambahkan pemformatan kustom ke kolom numerik.

Memformat parameter

Parameter berikut sesuai dengan opsi di menu Pemformatan editor visualisasi untuk diagram tabel.

color_application

Parameter color_application, dan subparameternya collection_id dan palette_id, dapat digunakan untuk menerapkan koleksi dan palet warna tertentu ke elemen dasbor. Untuk ringkasan koleksi warna bawaan Looker, lihat halaman dokumentasi Koleksi warna.

Jika memiliki ID koleksi dan ID palet untuk palet yang ingin digunakan, Anda dapat memasukkan ID tersebut ke dalam subparameter collection_id dan palette_id. ID koleksi atau ID palet dapat berupa kode alfanumerik atau didasarkan pada nama koleksi warna. Kode alfanumerik digunakan untuk koleksi native Looker. ID ini khusus untuk instance dan terlihat seperti ini:


color_application:
  collection_id: 1297dk12-86a7-4xe0-8dfc-82de20b3806a
  palette_id: 93c8aeb7-3f8a-4ca7-6fee-88c3617516a1

Koleksi warna kustom menggunakan ID koleksi dan palet berdasarkan nama koleksi warna, yang dapat digunakan di berbagai instance dan terlihat seperti ini:


color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0

Anda juga dapat menggunakan UI untuk menemukan warna, koleksi, atau palet yang diinginkan dan membuat LookML untuk menambahkannya ke dasbor. Buka konten yang ditentukan pengguna (seperti Look, dasbor, atau Eksplorasi), lalu terapkan warna, kumpulan, atau palet 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.

header_font_color

Parameter header_font_color menerapkan warna font ke header kolom.

Nilai warna dapat berupa string hex, seperti #2ca6cd, atau string warna bernama CSS, seperti mediumblue.


header_font_color: purple

Warna default bergantung pada tema tabel yang ditentukan menggunakan parameter table_theme.

header_background_color

Parameter header_background_color menerapkan warna pada header kolom latar belakang.

Nilai warna dapat berupa string hex, seperti #2ca6cd, atau string warna bernama CSS, seperti mediumblue.


header_background_color: #add8e6

Warna default bergantung pada tema tabel yang ditentukan menggunakan parameter table_theme.

header_text_alignment

Parameter header_text_alignment menerapkan perataan left, right, atau center ke header kolom.


header_text_alignment: center

Penyejajaran defaultnya adalah left.

header_font_size

Parameter header_font_size menerapkan ukuran font dari 1 hingga 99 ke header kolom.


header_font_size: 16

Ukuran default untuk font header dan baris adalah 12.

rows_font_size

Parameter rows_font_size menerapkan ukuran font dari 1 hingga 99 ke teks di dalam sel data, tetapi tidak ke header kolom.


rows_font_size: 8

Ukuran default untuk font header dan baris adalah 12.

enable_conditional_formatting

Dengan menyetel enable_conditional_formatting ke true, Anda dapat menentukan aturan yang mengodekan warna visualisasi tabel, baik pada skala maupun dengan menentukan nilai yang diinginkan.


enable_conditional_formatting: true | false

conditional_formatting_include_totals

Jika enable_conditional_formatting disetel 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 ditampilkan sebagai nol.


conditional_formatting_include_nulls: true | false

conditional_formatting

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

Berikut adalah contoh aturan pemformatan 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 nilai akan diberi kode warna sepanjang skala atau berdasarkan kondisi logis.

Jika Anda memberi kode warna pada nilai dalam skala, Anda dapat menyetel 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 berlaku untuk nilai yang sama dengan angka yang ditentukan untuk value.
  • not equal to: Aturan berlaku untuk nilai yang tidak sama dengan angka yang ditentukan untuk value.
  • greater than: Aturan 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 tidak 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, sekumpulan dua angka.


value: N | [N, N]

background_color

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


background_color: "#49cec1"

font_color

Jika pengkodean warna Anda didasarkan pada kondisi logis (type disetel ke selain along a scale...), gunakan parameter font_color untuk menentukan warna font untuk nilai yang berlaku untuk aturan Anda.


font_color: "#1f3e5a"

color_application

Parameter color_application, dan subparameternya collection_id, palette_id, dan options, dapat digunakan untuk menerapkan koleksi dan palet warna tertentu ke aturan pemformatan 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 Eksplorasi), 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 mengetahui ringkasan koleksi warna bawaan 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 sesuai 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 disetel 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 diterapkan format 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 nilai yang berlaku untuk aturan Anda harus dicetak tebal.


bold: true | false

italic

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


italic: true | false

strikethrough

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


strikethrough: true | false

fields

Tentukan kolom tempat aturan Anda harus diterapkan. Secara default, aturan ini berlaku untuk semua kolom numerik.


fields: [ view_name.field_name ]