Setelan admin - Kueri

Halaman Queries di bagian Database pada menu Admin mencantumkan informasi tentang 50 kueri terakhir yang dikirimkan Looker ke database Anda. Untuk mengetahui informasi tentang kueri yang lebih lama dari 50 kueri terbaru, lihat bagian Penggunaan di Looker.

Jika Anda telah mengaktifkan fitur Labs Admin Kueri yang Ditingkatkan, halaman Kueri akan menampilkan tab berikut:

  • Terbaru: Menampilkan kueri yang dijalankan dalam satu jam terakhir. Dari tab ini, admin Looker dapat membatalkan kueri yang sedang berjalan.
  • Selesai: Menampilkan 500 kueri terbaru.

Jika Anda belum mengaktifkan fitur Labs Admin Kueri yang Ditingkatkan, halaman Kueri akan mencantumkan 50 kueri terakhir dalam satu halaman.

Informasi kueri dasar

Kolom Definisi
Waktu Waktu mulai kueri, ditampilkan dalam zona waktu aplikasi Anda.
Status Status kueri, yang dapat mencakup:
  • Cache: Looker menampilkan hasil dari cache-nya, bukan menjalankan kueri duplikat terhadap database.
  • Selesai: Kueri berhasil diselesaikan.
  • Error: Kueri tidak berhasil diselesaikan karena terjadi error, yang detailnya dapat ditemukan dengan mengklik tombol Detail.
  • Dibatalkan: Kueri dibatalkan oleh Looker atau pengguna.
  • Menunggu PDT: Kueri perlu menunggu tabel turunan persisten dibuat sebelum dapat dieksekusi.
  • Membangun PDT: Tabel turunan persisten sedang dalam proses pembangunan.
  • Dalam antrean: Kueri sedang menunggu untuk dieksekusi karena terlalu banyak kueri yang sedang berjalan (kueri dapat dibatasi oleh Looker dalam penyiapan koneksi atau database Anda).
  • Berjalan: Kueri sedang dalam proses dijalankan.
  • Tidak diketahui: Looker tidak dapat menentukan apa yang terjadi dengan kueri ini.
Koneksi Koneksi Looker yang digunakan untuk menjalankan kueri ini.
Pengguna Pengguna yang menjalankan kueri ini, jika dapat ditentukan. Beberapa kueri tidak dijalankan oleh pengguna tertentu, seperti saat Looker membuat tabel turunan persisten atau saat pengguna yang tidak dikenal mengakses Look publik.
Sumber Sumber kueri di Looker, seperti halaman Jelajah atau SQL Runner. Jika memungkinkan, link ke Look tersimpan, atau ID kueri beserta nama model dan Jelajah, juga ditampilkan. Beberapa kueri tidak memiliki informasi tambahan, seperti kueri yang dijalankan di SQL Runner. Kueri yang dikeluarkan dari Open SQL Interface memiliki nilai Sumber sebesar Sql_interface.
Runtime Waktu yang diperlukan untuk menjalankan kueri. Hal ini mencakup pembuatan kueri, waktu yang dihabiskan kueri dalam antrean, transit ke dan dari database, serta eksekusi kueri database.

Jika kueri sedang berjalan, runtime akan menunjukkan durasi kueri telah berjalan. Untuk kueri yang dijalankan sebelumnya, waktu proses juga akan menampilkan perkiraan waktu yang dibutuhkan kueri untuk menyelesaikan eksekusi. Estimasi didasarkan pada durasi kueri yang terakhir dijalankan dan akan menampilkan sesuatu seperti "sekitar 2 detik".
Tombol Detail Lihat subbagian Tombol Detail di halaman ini untuk mengetahui detail tambahan.

Tombol Detail

Mengklik tombol Detail di sebelah kanan kueri akan menampilkan informasi tambahan tentang kueri tersebut. Menu Detail Kueri mencakup hal berikut:

  • Bagian Info yang mencakup detail tentang kueri (lihat tabel berikut).
  • Bagian SQL yang menampilkan SQL mentah yang dieksekusi terhadap database. Komentar Konteks tidak akan muncul dalam informasi Detail Kueri. Untuk mencegah komentar memengaruhi caching kueri, Looker menambahkan komentar konteks ke perintah SQL keluar tepat sebelum SQL dikirim ke database.
  • Bagian SQL Interface query yang muncul saat kueri telah dikeluarkan melalui Open SQL Interface. Bagian ini menampilkan kueri SQL yang dikirim ke Looker dari alat BI eksternal dan dapat membantu memecahkan masalah dan mereproduksi masalah.
  • Link Open in SQL Runner yang akan membuka kueri di SQL Runner.

Bagian Info mencakup informasi berikut:

Bagian Definisi
ID Histori ID histori kueri, jika tersedia.
Status Status kueri, seperti yang dijelaskan dalam tabel informasi kueri dasar.
Pesan Jika kueri berisi PDT, komentar pembuatan PDT akan muncul di kolom ini. Jika kueri tidak berisi PDT, kolom tidak akan muncul.
Koneksi Koneksi Looker yang digunakan untuk menjalankan kueri ini.
Pengguna Pengguna yang menjalankan kueri ini, jika dapat ditentukan. Beberapa kueri tidak dijalankan oleh pengguna tertentu, seperti saat Looker membuat tabel turunan persisten atau saat pengguna yang tidak dikenal mengakses Look publik.
Sumber Sumber kueri di Looker, seperti halaman Jelajah atau SQL Runner. Jika memungkinkan, informasi tambahan akan ditampilkan, seperti link ke Look tersimpan, ID kueri, nama model, nama Jelajah, atau kolom yang dipilih.
Waktu Mulai Waktu mulai kueri, ditampilkan dalam zona waktu aplikasi Anda.
Waktu Berakhir Waktu selesai kueri, ditampilkan dalam zona waktu aplikasi Anda.
Runtime Durasi waktu yang diperlukan untuk menjalankan kueri.

Penghentian kueri

Saat Anda menutup tab browser tempat kueri berjalan, Looker akan otomatis menghentikan kueri. Admin Looker juga dapat menghentikan kueri yang sedang berjalan dari halaman Kueri. (Pengguna dengan izin see_queries dapat melihat halaman Kueri, tetapi hanya admin Looker yang dapat menghentikan kueri yang sedang berjalan.) Kueri yang masih berjalan akan menampilkan tombol Hentikan di sebelah kanan kueri. Klik Hentikan untuk menghentikan kueri.

Agar Looker dapat menghentikan kueri, dialek database Anda harus mendukung penghentian kueri. Daftar berikut menunjukkan dialek mana yang mendukung penghentian kueri di rilis Looker terbaru:

Dialek Didukung?
Actian Avalanche
Ya
Amazon Athena
Ya
Amazon Aurora MySQL
Ya
Amazon Redshift
Ya
Amazon Redshift 2.1+
Ya
Amazon Redshift Serverless 2.1+
Ya
Apache Druid
Tidak
Apache Druid 0.13+
Tidak
Apache Druid 0.18+
Tidak
Apache Hive 2.3+
Ya
Apache Hive 3.1.2+
Ya
Apache Spark 3+
Ya
ClickHouse
Ya
Cloudera Impala 3.1+
Ya
Cloudera Impala 3.1+ with Native Driver
Ya
Cloudera Impala with Native Driver
Ya
DataVirtuality
Ya
Databricks
Ya
Denodo 7
Ya
Denodo 8 & 9
Ya
Dremio
Ya
Dremio 11+
Ya
Exasol
Ya
Firebolt
Ya
Google BigQuery Legacy SQL
Ya
Google BigQuery Standard SQL
Ya
Google Cloud PostgreSQL
Ya
Google Cloud SQL
Ya
Google Spanner
Ya
Greenplum
Ya
HyperSQL
Tidak
IBM Netezza
Ya
MariaDB
Ya
Microsoft Azure PostgreSQL
Ya
Microsoft Azure SQL Database
Ya
Microsoft Azure Synapse Analytics
Ya
Microsoft SQL Server 2008+
Ya
Microsoft SQL Server 2012+
Ya
Microsoft SQL Server 2016
Ya
Microsoft SQL Server 2017+
Ya
MongoBI
Ya
MySQL
Ya
MySQL 8.0.12+
Ya
Oracle
Ya
Oracle ADWC
Ya
PostgreSQL 9.5+
Ya
PostgreSQL pre-9.5
Ya
PrestoDB
Ya
PrestoSQL
Ya
SAP HANA
Ya
SAP HANA 2+
Ya
SingleStore
Ya
SingleStore 7+
Ya
Snowflake
Ya
Teradata
Ya
Trino
Ya
Vector
Ya
Vertica
Ya

Waktu tunggu dan antrean kueri

Looker menghentikan kueri yang telah menunggu dalam antrean terlalu lama. Operasi ini disebut waktu tunggu. Beberapa waktu tunggu mungkin berlaku untuk kueri Anda:

  • Waktu tunggu pool koneksi dan kueri serentak maksimum: Untuk mencegah kelebihan beban pada database Anda dengan kueri serentak, Looker menahan kueri serentak yang berlebihan dalam antrean kueri Looker, dan akan menghentikan kueri yang tetap berada dalam antrean terlalu lama. Secara default, 75 kueri serentak maksimum diizinkan per koneksi. Kueri tambahan di luar batas koneksi akan dihentikan setelah 0 detik. Untuk mengubah setelan default ini, konfigurasikan setelan Koneksi maks, Kueri serentak maks untuk koneksi ini, dan Waktu tunggu habis pool koneksi di halaman Setelan Koneksi koneksi.

  • Batas dan waktu tunggu kueri per pengguna: Untuk mencegah satu pengguna memenuhi antrean kueri Looker, setiap pengguna memiliki jumlah maksimum kueri serentak yang diizinkan dan waktu tunggu antrean yang sesuai. Secara default, setiap pengguna dapat menjalankan maksimum 15 kueri serentak, dan waktu tunggu adalah 600 detik untuk kueri yang dimasukkan ke dalam antrean karena batas ini. Setelan ini berlaku untuk pengguna yang login ke Looker menggunakan proses autentikasi reguler, dan untuk pengguna yang login menggunakan kredensial pengguna API. Untuk mengubah nilai default ini, konfigurasi setelan Kueri serentak maksimum per pengguna untuk koneksi ini di halaman Setelan Koneksi koneksi. Jika instance Looker Anda dihosting pelanggan, Anda dapat mengubah default ini dengan mengonfigurasi opsi peluncuran --per-user-query-limit dan --per-user-query-timeout.

  • Batas dan waktu tunggu kueri penjadwal: Untuk mencegah kelebihan beban pada proses penjadwal Looker, instance Looker dapat menjalankan maksimum 10 kueri terjadwal serentak, dan waktu tunggu untuk kueri dalam antrean penjadwal adalah 1.200 detik. Jika instance Looker Anda dihosting pelanggan, Anda dapat mengubah default ini dengan mengonfigurasi opsi peluncuran --scheduler-query-limit dan --scheduler-query-timeout.

  • Batas dan waktu tunggu kueri perender: Untuk mencegah kelebihan beban pada proses perender Looker, instance Looker dapat merender maksimum 2 download berbasis gambar serentak, seperti format PDF dan PNG. Jika instance Looker Anda dihosting pelanggan, Anda dapat mengubah default ini dengan mengonfigurasi opsi peluncuran --concurrent-render-jobs.

  • Waktu tunggu webhook: Looker akan mencoba penayangan data ke webhook selama maksimal 30 menit. Jika Looker tidak dapat berkomunikasi dengan tujuan webhook dalam waktu 30 menit, kueri akan habis waktunya. Waktu tunggu ini tidak dapat dikonfigurasi.
    • Waktu tunggu proxy: Instance yang dihosting pelanggan sering menggunakan proxy dengan waktu tunggu default 60 detik. Sebaiknya waktu tunggu ini ditingkatkan menjadi 60 menit. Lihat postingan Komunitas Looker Menjalankan Looker di belakang server proxy atau load balancer untuk mengetahui informasi selengkapnya.

    • Waktu tunggu database: Sebagian besar database memiliki aturan untuk antrean dan waktu tunggu yang terlepas dari antrean dan waktu tunggu Looker. Misalnya, kueri mungkin telah keluar dari antrean Looker, tetapi masih dapat diantrekan di database Anda. Lihat dokumentasi untuk database Anda guna mengetahui informasi selengkapnya tentang cara menyesuaikan waktu tunggu kueri database.