Setelan admin - Kueri

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

Informasi kueri dasar

Kolom Definisi
Waktu Waktu mulai kueri, ditampilkan dalam zona waktu aplikasi Anda.
Status Status kueri, yang dapat mencakup:
  • Cache: Looker mengembalikan hasil dari cache-nya alih-alih menjalankan kueri duplikat terhadap basis data.
  • Selesai: Kueri berhasil diselesaikan.
  • Error: Kueri tidak berhasil diselesaikan karena terjadi error, yang detailnya dapat ditemukan dengan mengklik tombol Detail.
  • Dibatalkan: Permintaan 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 dibangun.
  • 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).
  • Running: 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 Jelajahi 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 Source 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, waktu eksekusi akan menunjukkan berapa lama kueri tersebut telah berjalan. Untuk kueri yang telah dijalankan sebelumnya, waktu eksekusi juga akan menunjukkan perkiraan berapa lama waktu yang dibutuhkan kueri untuk menyelesaikan eksekusinya. Perkiraan tersebut didasarkan pada durasi eksekusi kueri terakhir dan akan menunjukkan 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 berisi 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 penyiapan kueri, Looker menambahkan komentar konteks ke perintah SQL keluar tepat sebelum SQL dikirim ke database.
  • Bagian Permintaan Antarmuka SQL yang muncul ketika sebuah kueri telah dikeluarkan melalui Antarmuka SQL Terbuka. Bagian ini menampilkan kueri SQL yang dikirim ke Looker dari alat BI eksternal dan dapat membantu dalam pemecahan masalah dan mereproduksi masalah.
  • Tautan Buka di SQL Runner yang akan membuka kueri di SQL Runner.

Bagian Info mencakup informasi berikut:

Bagian Definisi
ID Histori ID riwayat dari 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 Explore atau SQL Runner. Jika memungkinkan, informasi tambahan akan ditampilkan, seperti tautan ke Tampilan yang tersimpan, ID kueri, nama model, nama Explore, atau bidang 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

Untuk dialek yang mendukung penghentian kueri, Looker dapat menghentikan kueri yang sedang berjalan dengan cara berikut:

  • Secara Otomatis: Looker secara otomatis menghentikan kueri jika pengguna menutup tab browser tempat kueri tersebut berjalan.
  • Satu per satu: Admin Looker dapat menghentikan kueri yang sedang berjalan satu per satu dari halaman Admin Queries dengan mengklik tombol Stop untuk kueri tersebut. (Pengguna dengan izin see_queries dapat melihat halaman Kueri, tetapi hanya admin Looker yang dapat menghentikan kueri yang sedang berjalan.)
  • Secara massal: Admin Looker dapat menghentikan beberapa kueri yang sedang berjalan secara bersamaan di seluruh instance atau untuk koneksi database tertentu menggunakan fitur pembersihan kueri darurat di halaman Kueri.

Menghentikan kueri secara massal

Jika instance Looker Anda menjadi tidak responsif atau performanya menurun karena penumpukan kueri (misalnya, kueri yang tertunda menghabiskan slot kueri yang tersedia, atau halaman Queries menjadi lambat atau tidak responsif), admin Looker dapat menghentikan kueri yang berjalan secara massal tanpa memulai ulang instance.

Untuk menghentikan kueri secara massal, ikuti langkah-langkah berikut:

  1. Di Looker, buka halaman Queries di menu Admin.
  2. Di kolom URL browser Anda, tambahkan ?cleanup=true ke akhir URL, lalu tekan Enter. Contoh:

    https://INSTANCE_NAME.cloud.looker.com/admin/queries?cleanup=true
    
  3. Bagian Pembersihan Kueri Darurat muncul di atas tabel kueri.

  4. Lakukan salah satu tindakan berikut:

    • Menghentikan semua kueri yang berjalan di seluruh instance: Klik Hentikan SEMUA Kueri yang Berjalan.
    • Menghentikan semua kueri yang sedang berjalan untuk koneksi tertentu: Pilih koneksi database dari daftar drop-down Koneksi, lalu klik Hentikan Kueri di Koneksi.
  5. Pada dialog konfirmasi, konfirmasi bahwa Anda ingin menghentikan kueri yang sedang berjalan.

Jika koneksi database yang tidak sehat atau tidak responsif menyebabkan penumpukan kueri berulang, admin juga dapat menonaktifkan koneksi untuk sementara menggunakan opsi Nonaktifkan Koneksi di halaman Setelan Koneksi.

Dialek yang didukung untuk menghentikan kueri

Agar Looker dapat menghentikan kueri—baik secara otomatis dengan menutup tab browser, satu per satu di halaman Kueri, atau secara massal dengan menggunakan pembersihan kueri darurat—dialek basis data Anda harus mendukung penghentian kueri. Tabel berikut menunjukkan dialek mana yang mendukung penghentian kueri dalam rilis Looker terbaru:

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

Waktu tunggu kueri dan antrean

Looker menghentikan kueri yang telah menunggu terlalu lama dalam antrian. 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 habis waktunya setelah 0 detik. Untuk mengubah nilai default ini, konfigurasikan setelan Koneksi maks, Kueri serentak maks untuk koneksi ini, dan Waktu tunggu 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 untuk kueri yang dimasukkan dalam antrean karena batas kueri serentak. Batas per pengguna berlaku untuk pengguna yang login ke Looker menggunakan proses autentikasi reguler, dan untuk pengguna yang login menggunakan kredensial pengguna API. Ada dua cara untuk menentukan jumlah maksimum kueri serentak per pengguna untuk koneksi di instance Looker Anda:

    • Opsi mulai per-user-query-limit. Ini adalah setelan di seluruh instance yang menetapkan default untuk koneksi di instance Anda. Opsi startup per-user-query-limit membatasi jumlah kueri bersamaan per pengguna, per koneksi, per node pada instance Looker. Maksimum default 15 kueri serentak per pengguna berlaku untuk setiap koneksi yang valid dan, jika instance Looker Anda dikelompokkan, untuk setiap node dalam cluster. Secara default, setiap pengguna dapat menjalankan maksimum 15 kueri serentak per koneksi, per node, dengan waktu tunggu 600 detik. Misalnya, jika Anda memiliki cluster 5 node dengan per-user-query-limit sebesar 15, setiap node akan mengizinkan 15 kueri serentak per pengguna untuk koneksi ini, dengan total 75 kueri di semua node (15 * 5 = 75).

    Anda dapat mengubah batas kueri per pengguna untuk koneksi dengan menggunakan setelan Kueri serentak maksimum per pengguna untuk koneksi ini di halaman Setelan Koneksi koneksi. Jika instance Looker Anda dihosting pelanggan, Anda dapat mengubah jumlah maksimum kueri serentak per pengguna default dengan mengonfigurasi opsi peluncuran --per-user-query-limit, dan Anda dapat mengonfigurasi waktu tunggu antrean menggunakan opsi peluncuran --per-user-query-timeout.

    • Opsi Kueri serentak maksimum per pengguna untuk koneksi ini di Setelan Koneksi untuk koneksi. Setelan Kueri serentak maksimum per pengguna untuk koneksi ini memiliki nilai default 25, dan berlaku per pengguna dan per koneksi, tetapi tidak per node. Misalnya, jika Anda memiliki cluster 5 node dan menetapkan nilai ini ke 15, setiap node akan mengizinkan 3 kueri serentak per pengguna untuk koneksi ini (15 / 5 = 3), dengan total 15 kueri di semua node. Untuk koneksi, jika nilai diberikan untuk setelan Kueri serentak maksimum per pengguna untuk koneksi ini, nilai Kueri serentak maksimum per pengguna untuk koneksi ini akan menggantikan opsi peluncuran per-user-query-limit untuk koneksi.
  • 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 secara bersamaan, seperti format PDF dan PNG. Jika instance Looker Anda dihosting pelanggan, Anda dapat mengubah default ini dengan mengonfigurasi --concurrent-render-jobs opsi startup.

  • 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 tidak bergantung pada 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.