kueri

Halaman ini merujuk pada parameter query yang merupakan bagian dari Explore.

query juga dapat digunakan sebagai bagian dari tabel gabungan, seperti yang dijelaskan di halaman dokumentasi parameter aggregate_table.

Penggunaan

explore: explore_name {
  query: query_name {
    dimensions: [dimension1, dimension2, ... ]
    measures: [measure1, measure2, ... ]
    label: "Display Name in Field Picker"
    description: "Information about this query"
    pivots: [dimension1, dimension2, ... ]
    sorts: [field1: asc, field2: desc, ... ]
    filters: [field1: "value1", field2: "value2", ... ]
    limit: 100
  }
  ...
}

Hierarki File Model explore query

Nilai Default Tidak ada Menerima Nama kueri dan subparameter untuk menentukan kueri

Definisi

Anda dapat menggunakan parameter query untuk membuat analisis yang dimodelkan untuk Eksplorasi. Analisis yang dimodelkan tercantum di bagian Mulai Cepat pada Eksplorasi kosong, atau di pop-up Mulai Cepat setelah Eksplorasi dijalankan. Lihat bagian Contoh di halaman ini untuk mengetahui cara kerjanya.

Analisis yang dimodelkan berguna bagi pengguna Looker pemula, karena Anda dapat menentukan elemen seperti dimensi, ukuran, filter, dan pivot yang mungkin paling relevan dan memberikan insight.

Menentukan kueri di LookML

Daripada membuat LookML kueri dari awal, Anda dapat menggunakan Eksplorasi untuk membuat LookML dasar kueri. Untuk mengetahui detailnya, lihat bagian berikutnya, Mendapatkan LookML kueri dari Eksplorasi.

Parameter query memiliki subparameter berikut:

Nama Parameter	Deskripsi	Contoh
label	Secara opsional, menambahkan label untuk query. Label adalah apa yang ditampilkan di pemilih kolom Eksplorasi untuk kueri.	label: "Weekly Sales Totals"
description	Secara opsional, menambahkan deskripsi tentang kueri ini untuk memberi tahu pengguna Anda. Di Jelajahi, kueri apa pun dengan deskripsi akan memiliki ikon informasi. Teks deskripsi ditampilkan saat pengguna mengarahkan kursor ke ikon informasi.	description: "Total value of all sales per day"
dimensions	Daftar dimensi yang dipisahkan koma dari Explore yang akan disertakan dalam kueri Anda. Kolom dimensions menggunakan sintaksis ini: dimensions: [dimension1, dimension2, ...]	dimensions:   [orders.created_month, orders.country]
measures	Daftar ukuran yang dipisahkan koma dari Eksplorasi yang akan disertakan dalam kueri Anda. Kolom measures menggunakan sintaksis ini: measures: [measure1, measure2, ...]	measures:   [orders.count]
filters	Secara opsional, menambahkan filter ke query. Filter ditambahkan ke klausa WHERE dari SQL yang menghasilkan kueri. Kolom filters menggunakan sintaksis ini: filters: [field_name_1: "value1", field_name_2: "value2", ...]	filters: [orders.country: "United States", orders.state: "California"]
limit	Secara opsional, menentukan batas baris kueri.	limit: 10
sorts	Secara opsional, menentukan kolom pengurutan dan arah pengurutan (menaik atau menurun) untuk query. Kolom sorts menggunakan sintaksis ini: sorts: [field1: asc|desc, field2: asc|desc, ...]	sorts: [order_items.total_sales: asc]
pivots	Secara opsional, memutar hasil pada dimensi kueri yang ditentukan. Kolom pivots menggunakan sintaksis ini: pivots: [dimension1, dimension2, ...] NOTE: Kolom yang ditentukan dalam parameter pivots juga harus ditentukan dalam parameter dimensions kueri.	pivots: [created_quarter]
timezone	Tidak didukung Parameter timezone tidak didukung untuk parameter query yang merupakan subparameter dari explore. query di explore menggunakan zona waktu yang sama dengan yang digunakan oleh explore.

Mendapatkan LookML kueri dari Eksplorasi

Sebagai pintasan, developer Looker dapat meminjam fungsi yang digunakan untuk membuat LookML aggregate_table dari Jelajah, lalu menyalin LookML kueri tabel gabungan dan menggunakannya sebagai titik awal untuk LookML analisis yang dimodelkan.

Saat menyalin LookML untuk tabel gabungan, Anda juga akan menyalin beberapa parameter yang tidak Anda inginkan untuk LookML kueri yang dimodelkan. Secara khusus, setelah menyalin LookML tabel gabungan, Anda perlu menghapus parameter aggregate_table dan materialization, karena hanya berlaku untuk tabel gabungan. (Lihat halaman dokumentasi parameter aggregate_table untuk mengetahui informasi selengkapnya tentang parameter tersebut.)

Selain itu, parameter tabel gabungan query hanya mendukung sebagian parameter yang didukung oleh kueri Jelajahi yang dimodelkan. Artinya, setelah menyalin LookML query tabel gabungan, Anda dapat menggunakan parameter tambahan untuk kueri yang dimodelkan. Lihat bagian Menentukan kueri di LookML di halaman ini untuk mengetahui daftar lengkap parameter yang didukung untuk kueri yang dimodelkan.

Untuk menggunakan Eksplorasi guna mendapatkan dasar untuk LookML kueri yang dimodelkan:

1. Di Eksplorasi, pilih semua kolom dan filter yang akan disertakan dalam kueri yang dimodelkan.
2. Pilih Run untuk mendapatkan hasilnya.

3. Pilih Get LookML dari menu roda gigi Tindakan Jelajah. Opsi ini hanya tersedia untuk developer Looker.

4. Pilih tab Aggregate Table.

5. Looker menyediakan LookML untuk penyempurnaan Eksplorasi untuk tabel gabungan. Kita dapat menggunakan query LookML tabel gabungan dan mengubahnya untuk kueri Eksplorasi yang dimodelkan. Salin LookML dan tempelkan ke file model terkait, yang ditunjukkan dalam komentar sebelum penyempurnaan Eksplorasi. Jika Eksplorasi ditentukan dalam file Eksplorasi terpisah, dan bukan dalam file model, Anda dapat menambahkan penyempurnaan ke file Eksplorasi, bukan file model.

   Dari sini, Anda dapat mengubah LookML tabel gabungan yang akan digunakan untuk kueri yang dimodelkan:

6. Hanya simpan parameter query dan subparameternya. Hapus parameter aggregate_table dan materialization, karena hanya berlaku untuk tabel gabungan.

7. Tambahkan nama untuk kueri. Seperti yang ditunjukkan di bagian Contoh di halaman ini, sintaksisnya adalah:

   query: query_name

8. Jika perlu, isi parameter tambahan untuk kueri yang dimodelkan. Lihat bagian Menentukan kueri di LookML di halaman ini untuk mengetahui daftar lengkap parameter yang didukung untuk kueri yang dimodelkan.

Contoh

Contoh ini membuat kueri yang dimodelkan order_count_by_month untuk Eksplorasi order_items:

explore: +order_items {
  query: order_count_by_month {
     description: "Number of orders placed by month in 2019"
     dimensions: [orders.created_month]
      measures: [orders.count]
     filters: [orders.created_date: "2019"]
    }
  }

Pengguna dapat menjalankan analisis Mulai Cepat dari bagian Mulai Cepat di Eksplorasi Pesan Item.