Parameter kolom

Halaman ini menautkan ke semua parameter LookML yang menentukan kolom.

Ada beberapa jenis kolom:

  • Dimensi merepresentasikan kolom dalam tabel, atau nilai terkomputasi berdasarkan beberapa jenis manipulasi atau kombinasi kolom
  • Grup Dimensi hanya digunakan dengan data berbasis waktu, dan memungkinkan Anda membuat banyak dimensi berbasis waktu sekaligus
  • Ukuran mirip dengan fungsi agregat di SQL (misalnya, COUNT, SUM, AVG) dan merepresentasikan informasi tentang beberapa baris
  • Filter membuat kolom hanya filter yang dapat digunakan pengguna untuk memberikan input ke filter ber-template atau gabungan bersyarat
  • Parameter membuat kolom hanya filter yang dapat digunakan pengguna untuk memberikan input ke tag Liquid {% parameter %}

Contoh penggunaan

Arahkan kursor ke nama parameter untuk melihat deskripsi singkat. Klik nama parameter untuk membuka halaman referensinya.

Jika parameter dapat disetel ke salah satu dari beberapa opsi tertentu, nilai default akan dicantumkan terlebih dahulu.

## STRUCTURAL PARAMETERS
view: view_name {
  (dimension |dimension_group |measure |filter | parameter):field_name{
    intervals: [interval, interval, …]
    timeframes: [timeframe, timeframe, …]

    # ACTION AND LINKING PARAMETERS
    action: {
      label: "Label to Appear in Action Menu"
      url: "url"
      icon_url: "url"
      form_url: "url"
      param: {
        name:  "name string"
        value:  "value string"
      }
      # Possibly more param definitions
      form_param: {
        name:  "title"
        type: select | string | textarea
        label:  "desired label name"
        required:  yes | no
        default:  "value string"
        option: {
          name:  "name string"
          value:  "value string"
        }
        # Possibly more option definitions
      }
      # Possibly more form_param definitions
    }
    drill_fields: [field_or_set, field_or_set, ...]
    tags: ["string1", "string2", ...]
    link: {
      label: "desired label name;"
      url: "desired_url"
      icon_url: "url_of_an_image_file"
    }
    # Possibly more link definitions
    # DISPLAY PARAMETERS
    alias: [old_field_name, old_field_name, ...]
    alpha_sort: yes | no
    description: "description string"
    group_label:  "desired group label name"
    group_item_label:  "label to use under the group label in the field picker"
    hidden: yes | no
    label: "desired label name"
    label_from_parameter: parameter_name
    order_by_field: dimension_name | dimension_group_name | measure_name 
    style: classic | interval | integer | relational
    view_label: "desired label name"

    # FILTER PARAMETERS
    can_filter: yes | no
    case_sensitive: yes | no
    filters: [dimension: "filter expression", dimension: "filter expression", ...]
    skip_drill_filter: yes | no

    # FILTER SUGGESTION PARAMETERS
    allowed_value: {
      label: "desired label name"
      value: "looker filter expression"
    }
    # Possibly more allowed_value definitions
    bypass_suggest_restrictions: yes | no
    full_suggestions: yes | no
    suggest_dimension: dimension_name
    suggest_explore: explore_name
    suggest_persist_for: "N (seconds | minutes | hours)"
    suggestable: yes | no
    suggestions: ["suggestion string", "suggestion string", "…"]<

    # QUERY PARAMETERS
    allow_approximate_optimization: yes | no
    approximate: yes | no
    approximate_threshold: N
    convert_tz: yes | no
    datatype: epoch | timestamp | datetime | date | yyyymmdd
    fanout_on: repeated_record_name
    precision: N
    primary_key: yes | no
    required_access_grants: [access_grant_name, access_grant_name, ...]
    required_fields: [field_name, field_name, ...]
    sql_distinct_key: SQL expression to define repeated entities ;;

    # VALUE AND FORMATTING PARAMETERS
    case: {
      when: {
        sql: SQL condition ;;
        label: "value"
      }
      # Possibly more when statements
    }
    default_value: "desired default value"
    direction: "row | column"
    end_location_field: dimension_name
    html: HTML expression using Liquid template elements ;;
    list_field: dimension_name

    percentile: Nth percentile
    sql: SQL expression to generate the field value ;;
    sql_end: SQL expression indicating the end time of a duration ;;
    sql_latitude: SQL expression to generate a latitude ;;
    sql_longitude: SQL expression to generate a longitude ;;
    sql_start: SQL expression indicating the start time of a duration ;;
    start_location_field: dimension_name
    synonyms: [synonym1, synonym2, ...]
    tiers: [N, N, ...]
    type: dimension_field_type # For a dimension field
    type: dimension_group_type
# For a dimension_group field
    type: measure_field_type   # For a measure field
    type: filter_field_type    # For a filter field
    type: parameter_field_type # For a parameter field
    string_datatype: unicode # For a dimension field
    units: feet | kilometers | meters | miles | nautical_miles | yards
    value_format: "excel-style formatting string"
    value_format_name: format_name

    # VISUALIZATION PARAMETERS
    allow_fill: yes | no
    map_layer_name: name_of_map_layer
  }
}

Definisi parameter

  • D = Dimensi
  • DG = Grup Dimensi
  • M = Ukuran
  • F = Filter
  • P = Parameter
Nama Parameter Jenis Kolom yang Valid Deskripsi
Parameter Struktural
dimension D Membuat kolom dimensi
dimension_group DG Membuat beberapa dimensi berbasis waktu secara bersamaan
filter F Membuat kolom hanya filter untuk digunakan dalam filter ber-template atau gabungan bersyarat
measure M Membuat kolom ukuran
parameter P Membuat kolom hanya filter yang dapat digunakan pengguna untuk memberikan input ke tag Liquid {% parameter %}
intervals DG Menentukan kumpulan dimensi durasi yang Anda inginkan dalam dimension_group dari type: duration
timeframes DG Menentukan kumpulan dimensi jangka waktu yang Anda inginkan dalam dimension_group type: time
Parameter Tindakan dan Penautan
action D M Membuat tindakan data pada kolom yang memungkinkan pengguna melakukan tugas di alat lain, langsung dari Looker
drill_fields D DG M Mendeklarasikan daftar kolom yang akan ditampilkan saat ukuran atau dimensi diuraikan
link D M Membuat link ke konten Looker dan eksternal lainnya
tags D DG M F P Menambahkan teks yang dapat diteruskan ke aplikasi lain untuk memberikan data tentang kolom
Parameter Tampilan
alias D DG M F P Memungkinkan URL tersimpan dengan nama kolom lama tetap berfungsi setelah kolom diganti namanya
alpha_sort D Membuat parameter case mengurutkan kondisinya menurut abjad
description D DG M F P Menambahkan deskripsi ke kolom yang dapat dilihat pengguna saat mengarahkan kursor ke kolom.
group_label D DG M F Mengelompokkan kolom bersama dalam tampilan di pemilih kolom
group_item_label D DG M F Menentukan label yang akan digunakan untuk kolom di bawah label grupnya di pemilih kolom
hidden D DG M F P Menyembunyikan kolom dari UI Jelajahi
label D DG M F P Mengubah cara nama kolom muncul di pemilih kolom
label_from_parameter D M Mengubah cara nama kolom muncul dalam visualisasi berdasarkan input ke parameter
order_by_field D DG M

Mengurutkan kolom menurut nilai kolom lain

Didukung untuk dimensi, grup dimensi

Didukung untuk ukuran

style D Mengubah cara tingkat ditampilkan di UI Looker untuk dimensi type: tier
view_label D DG M F P Mengubah kolom yang muncul dalam tampilan di pemilih kolom
Parameter Filter
can_filter D DG M Menentukan apakah dimensi atau ukuran dapat digunakan sebagai filter
case_sensitive D F Menentukan apakah filter peka huruf besar/kecil untuk suatu dimensi
filter F Membuat kolom khusus filter untuk digunakan dalam filter ber-template
filters M Membatasi penghitungan ukuran berdasarkan batasan dimensi
skip_drill_filter D Mencegah dimensi ditambahkan ke filter saat ukuran diuraikan
Parameter Saran Filter
allowed_value P Menentukan pilihan untuk parameter
bypass_suggest_restrictions D DG F P Menampilkan saran kepada pengguna saat sql_always_where sedang digunakan, tetapi tidak menerapkan batas tersebut pada saran
full_suggestions D DG F P Mengontrol cara Looker mengkueri database Anda untuk memberikan saran nilai kolom dalam filter Eksplorasi. Looker dapat menggunakan kueri SELECT DISTINCT dasar, atau Looker dapat menggunakan logika lengkap Eksplorasi, termasuk gabungan dan parameter sql_always_where serta access_filter.
suggest_dimension D DG M F P Mendasarkan saran untuk kolom pada nilai dimensi yang berbeda
suggest_explore D DG M F P Mendasarkan saran untuk kolom pada nilai Explore yang berbeda
suggest_persist_for D F P Mengubah setelan cache untuk saran filter Looker
suggestable D DG M F P Mengaktifkan atau menonaktifkan saran untuk kolom
suggestions D F P Mendeklarasikan daftar nilai yang akan digunakan untuk saran kolom
Parameter Kueri
allow_approximate_optimization M Memungkinkan perkiraan jumlah unik untuk pengukuran type: count atau type: count_distinct, sehingga pengukuran dapat digunakan untuk awareness gabungan
approximate M Melakukan penghitungan perkiraan untuk ukuran type: count_distinct. Lihat halaman dokumentasi approximate untuk mengetahui daftar dialek yang mendukung parameter ini.
approximate_threshold M Menetapkan jumlah saat BigQuery beralih dari jumlah berbeda yang tepat ke jumlah berbeda yang diperkirakan
convert_tz D DG M F P Menonaktifkan konversi zona waktu otomatis untuk kolom
datatype D DG F M Menentukan jenis data waktu yang Anda berikan ke kolom
fanout_on D DG M Mengaktifkan akses ke kolom berulang Google BigQuery
precision M Menentukan jumlah tempat desimal yang akan digunakan saat melakukan perhitungan untuk agregat simetris Looker
primary_key D Mendeklarasikan dimensi sebagai kunci utama tampilan
required_access_grants D DG F M P Membatasi akses ke kolom hanya untuk pengguna yang nilai atribut penggunanya cocok dengan pemberian akses
required_fields D M Memerlukan penambahan kolom lain ke kueri saat kolom dipilih
sql_distinct_key M Menentukan entitas unik yang akan dihitung pengukurannya untuk type: sum_distinct atau type: average_distinct
Parameter Nilai dan Pemformatan
case D Membuat serangkaian nilai diskret yang dapat dimiliki dimensi yang ditentukan oleh kondisi SQL
default_value F P Menentukan nilai default untuk kolom filter
direction M Menentukan arah penghitungan ukuran type: percent_of_total atau type: running_total saat pivot digunakan
end_location_field D Menentukan kolom yang berisi lokasi akhir untuk kolom type: distance
html D DG M Mengubah output HTML kolom menggunakan template Liquid
list_field M Mendeklarasikan dimensi yang akan digunakan untuk menghitung ukuran type: list
percentile M Menentukan nilai pecahan (persentil ke-N) untuk ukuran type: percentile atau type: percentile_distinct
sql D DG M F Menentukan cara penghitungan kolom
sql_end D DG Menentukan waktu berakhir durasi untuk grup dimensi jenis durasi atau dimensi jenis durasi
sql_latitude D Menentukan lintang dimensi type: location
sql_longitude D Menentukan bujur dimensi type: location
sql_start D DG Menentukan waktu mulai durasi untuk grup dimensi jenis durasi atau dimensi jenis durasi
start_location_field D Menentukan kolom yang berisi lokasi awal untuk kolom type: distance
synonyms D DG F M P Menentukan daftar sinonim string (kata atau frasa) yang dapat digunakan untuk membantu model bahasa besar dan developer aplikasi memahami cara lain yang mungkin digunakan pengguna untuk merujuk ke suatu kolom
tiers D Menentukan tingkat untuk dimensi type: tier
type (untuk dimensi, filter, atau parameter) D F P Menentukan jenis dimensi, filter, atau parameter
type (untuk grup dimensi) DG Menentukan jenis grup dimensi
type (untuk pengukuran) M Menentukan jenis pengukuran
string_datatype D Menentukan jenis data unicode untuk kolom type: string untuk SQL Server atau MySQL
units D Menentukan unit yang akan digunakan untuk kolom type: distance
value_format D M Memformat output kolom menggunakan opsi gaya Excel
value_format_name D M Memformat output kolom menggunakan format bawaan atau kustom
Parameter Visualisasi
allow_fill D DG Menentukan apakah pengisian dimensi diizinkan untuk suatu dimensi
map_layer_name D Menentukan pemetaan dari nilai data ke wilayah geografis yang telah Anda tentukan pada peta bawaan atau kustom
Parameter yang Harus Dihindari
decimals D M Dihapus 5.4 Digantikan oleh value_format
format D M Dihapus 3.16 Digantikan dengan value_format