Setelan admin - Kueri

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

Jika Anda telah mengaktifkan fitur Labs Enhanced Query Admin, 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.
  • Lengkap: Menampilkan 500 kueri terbaru.

Jika Anda belum mengaktifkan fitur Labs Enhanced Query Admin, halaman Kueri akan mencantumkan 50 kueri terakhir di satu halaman.

Informasi kueri dasar

Kolom Definisi
Waktu Waktu mulai kueri, yang 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 harus menunggu tabel turunan persisten dibuat sebelum dapat dieksekusi.
  • Mem-build PDT: Tabel turunan persisten sedang dalam proses pembuatan.
  • Dalam antrean: Kueri menunggu untuk dieksekusi karena terlalu banyak kueri yang sedang berlangsung (kueri dapat dibatasi oleh Looker di 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 tempat kueri ini dijalankan.
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 Tampilan publik.
Sumber Sumber kueri di Looker, seperti halaman Jelajah atau SQL Runner. Jika memungkinkan, link ke Tampilan tersimpan, atau ID kueri beserta nama model dan Jelajah, juga akan ditampilkan. Beberapa kueri tidak memiliki informasi tambahan, seperti yang dijalankan di SQL Runner. Kueri yang dikeluarkan dari Antarmuka SQL Terbuka memiliki nilai Sumber Sql_interface.
Runtime Waktu yang diperlukan untuk menjalankan kueri. Hal ini mencakup pembuatan kueri, setiap kali kueri dihabiskan dalam antrean, transit ke dan dari database, serta eksekusi database kueri.

Jika kueri sedang berjalan, runtime akan menampilkan berapa lama kueri telah berjalan. Untuk kueri yang dijalankan sebelumnya, runtime juga akan menampilkan estimasi waktu yang diperlukan kueri untuk selesai berjalan. Estimasi ini didasarkan pada durasi pengoperasian terakhir kueri 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. Pop-up Detail Kueri mencakup hal berikut:

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

Bagian Info menyertakan 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 tempat kueri ini dijalankan.
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 Tampilan publik.
Sumber Sumber kueri di Looker, seperti halaman Jelajahi atau SQL Runner. Jika memungkinkan, informasi tambahan akan ditampilkan, seperti link ke Tampilan tersimpan, ID kueri, nama model, nama Jelajah, atau kolom yang dipilih.
Waktu Mulai Waktu mulai kueri, yang ditampilkan dalam zona waktu aplikasi Anda.
Waktu Berakhir Waktu selesai kueri, yang 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.) Setiap kueri yang masih berjalan akan menampilkan tombol Stop di sebelah kanan kueri. Klik Stop untuk menghentikan kueri.

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

Dialek Didukung?
Actian Avalanche
Ya
Amazon Athena
Ya
Amazon Aurora MySQL
Ya
Amazon Redshift
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+ dengan Driver Native
Ya
Cloudera Impala dengan Driver Native
Ya
DataVirtuality
Ya
Databricks
Ya
Denodo 7
Ya
Denodo 8
Ya
Dremio
Ya
Dremio 11+
Ya
Exasol
Ya
Firebolt
Ya
Legacy SQL Google BigQuery
Ya
SQL Standar Google BigQuery
Tidak
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 versi pra-9.5
Ya
PrestoDB
Ya
PrestoSQL
Ya
SAP HANA 2+
Ya
SingleStore
Ya
SingleStore 7+
Ya
Snowflake
Ya
Teradata
Ya
Trino
Ya
Vektor
Ya
Vertica
Ya

Waktu tunggu kueri dan antrean

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

  • Waktu tunggu kumpulan koneksi habis: Untuk mencegah database Anda kelebihan beban dengan kueri serentak, Looker menyimpan kueri serentak yang berlebih di 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 habis waktunya setelah 0 detik. Untuk mengubah setelan default ini, konfigurasikan setelan koneksi maksimum dan waktu tunggu kumpulan koneksi di halaman Setelan Koneksi koneksi.

  • Batas dan waktu tunggu kueri per pengguna: Untuk mencegah satu pengguna mengisi 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 tunggunya 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. Jika instance Looker Anda dihosting pelanggan, Anda dapat mengubah default ini dengan mengonfigurasi opsi startup --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 startup --scheduler-query-limit dan --scheduler-query-timeout.

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

  • Waktu tunggu webhook: Looker akan mencoba mengirim data ke webhook selama maksimum 30 menit. Jika Looker tidak dapat berkomunikasi dengan tujuan webhook dalam 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 balik server proxy atau load balancer untuk mengetahui informasi selengkapnya.

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