管理員設定 - 查詢

「管理」選單的「資料庫」部分中的「查詢」頁面會列出 Looker 提交至資料庫的最近 50 個查詢。如要瞭解比最近 50 項查詢更舊的查詢,請參閱 Looker 的「使用情形」一節。

如果您已啟用 Enhanced Query Admin Labs 功能,查詢頁面會顯示下列分頁:

  • 近期:顯示過去 1 小時內執行的查詢。Looker 管理員可透過這個分頁取消執行中的查詢。
  • 完整:顯示最近的 500 筆查詢。

如果您尚未啟用「強化查詢管理員」實驗室功能,系統會在「查詢」頁面上列出最近 50 筆查詢。

基本查詢資訊

定義
時間 查詢的開始時間,以應用程式時區為準。
狀態 查詢的狀態,可能包括:
  • 快取:Looker 傳回快取的結果,而非對資料庫執行重複查詢。
  • Complete:查詢已順利完成。
  • 錯誤:發生錯誤,因此無法順利完成查詢,如要查看詳細資料,請按一下「詳細資料」按鈕。
  • 已取消:Looker 或使用者已取消查詢。
  • 等待 PDT:查詢需要等待持久衍生資料表建立完成才能執行。
  • 建構 PDT:系統正在建構永久衍生資料表
  • 佇列:查詢正在等待執行,因為目前有太多查詢正在進行中 (Looker 可在連線設定或資料庫中限制查詢)。
  • 執行中:查詢正在執行。
  • 不明:Looker 無法判斷此查詢發生的問題。
連線 執行這項查詢的 Looker 連線
使用者 執行這項查詢的使用者 (如果可以判斷)。有些查詢並非由特定使用者執行,例如 Looker 建立持續性衍生資料表,或不明使用者存取公開 Look 時。
來源 Looker 中查詢的來源,例如「探索」頁面或 SQL Runner。系統也會盡可能顯示已儲存外觀的連結,或是查詢 ID,以及模型和探索的名稱。部分查詢沒有額外資訊,例如在 SQL Runner 中執行的查詢。透過 Open SQL 介面發出的查詢,其 Source 值為 Sql_interface
執行階段 執行查詢所需的時間。包括查詢的建構時間、查詢在佇列中花費的時間、從資料庫傳輸至資料庫的時間,以及資料庫執行查詢的時間。

如果查詢正在執行,執行時間會顯示查詢已執行多久。對於先前執行的查詢,執行時間也會顯示預估查詢完成執行所需的時間。系統會根據上次執行查詢的時間長度進行估算,並顯示類似「約 2 秒」的訊息。
「詳細資料」按鈕 如需更多資訊,請參閱本頁的「詳細資料按鈕」子部分。

「詳細資料」按鈕

按一下任何查詢右側的「詳細資料」按鈕,即可查看該查詢的其他資訊。「查詢詳細資料」選單包含以下項目:

  • 「資訊」部分,包含查詢的詳細資料 (請參閱下表)。
  • SQL 部分:顯示針對資料庫執行的原始 SQL。內容註解不會顯示在「查詢詳細資料」資訊中。為避免註解影響查詢快取,Looker 會在 SQL 傳送至資料庫前,將情境註解新增至傳出 SQL 指令。
  • 透過 Open SQL 介面發出查詢時,會顯示 SQL 介面查詢部分。這個部分會顯示從外部 BI 工具傳送至 Looker 的 SQL 查詢,有助於排解問題和重現問題。
  • 「Open in SQL Runner」連結,可在 SQL Runner 中開啟查詢。

「資訊」部分包含下列資訊:

區段 定義
記錄 ID 查詢的記錄 ID (如有)。
狀態 查詢狀態,如基本查詢資訊表格所述。
訊息 如果查詢包含 PDT,這個欄位就會顯示 PDT 產生評論。如果查詢不含 PDT,系統就不會顯示該欄位。
連線 執行這項查詢的 Looker 連線
使用者 執行這項查詢的使用者 (如果可以判斷)。有些查詢並非由特定使用者執行,例如 Looker 建立持續性衍生資料表,或不明使用者存取公開 Look 時。
來源 Looker 中的查詢來源,例如「探索」頁面或 SQL Runner。系統會盡可能顯示其他資訊,例如已儲存的 Look 連結、查詢 ID、模型名稱、探索名稱或所選欄位。
開始時間 查詢的開始時間,以應用程式時區為準。
結束時間 查詢的結束時間,以應用程式時區為準。
執行階段 執行查詢所需的時間長度。

查詢終止

當您關閉正在執行查詢的瀏覽器分頁時,Looker 會自動停止查詢。Looker 管理員也可以透過「查詢」頁面停止執行中的查詢。(具備 see_queries 權限的使用者可以查看「查詢」頁面,但只有 Looker 管理員可以停止執行中的查詢。)任何仍在執行的查詢,都會在查詢右側顯示「停止」按鈕。按一下「停止」即可停止查詢。

資料庫方言必須支援查詢終止功能,Looker 才能終止查詢。以下清單列出哪些方言支援在最新版本的 Looker 中終止查詢:

方言 是否支援?
Actian Avalanche
Amazon Athena
Amazon Aurora MySQL
Amazon Redshift
Amazon Redshift 2.1+
Amazon Redshift Serverless 2.1+
Apache Druid
Apache Druid 0.13+
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
Dremio
Dremio 11+
Exasol
Firebolt
Google BigQuery Legacy SQL
Google BigQuery Standard SQL
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
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

查詢逾時和排隊

Looker 會終止在佇列中等待太久的查詢。這項作業稱為「逾時」。您的查詢可能會受到以下幾種逾時限制的影響:

  • 連線集區逾時和並行查詢數量上限:為避免並行查詢導致資料庫超載,Looker 會在 Looker 查詢佇列中保留過多的並行查詢,並終止佇列中停留太久的查詢。根據預設,每個連線最多可同時執行 75 個查詢。超過連線上限的其他查詢會在 0 秒後逾時。如要變更這些預設值,請在連線的「連線設定」頁面上,設定「連線數量上限」、「這個連線的並行查詢數量上限」和「連線集區逾時」設定。

  • 個別使用者的查詢限制和逾時時間:為避免任何單一使用者佔用 Looker 查詢佇列,每位使用者都有允許的並行查詢數量上限和相應的佇列逾時時間。根據預設,每位使用者最多只能執行 15 個並行查詢,且因達到此限制而排入佇列的查詢,會在 600 秒後逾時。這些設定適用於使用一般驗證程序登入 Looker 的使用者,也適用於使用 API 使用者憑證登入的使用者。如要變更這些預設值,請在連線的「連線設定頁面上設定「這個連線的個別使用者並行查詢數量上限」。如果 Looker 執行個體是客戶代管的,您可以設定 --per-user-query-limit--per-user-query-timeout 啟動選項,變更這些預設值。

  • 排程器查詢限制和逾時:為避免 Looker 排程器程序超載,Looker 執行個體最多可同時執行 10 個排程查詢,排程器佇列中的查詢逾時時間為 1,200 秒。如果 Looker 執行個體是由客戶代管,您可以設定 --scheduler-query-limit--scheduler-query-timeout 啟動選項,變更這些預設值。

  • 轉譯器查詢限制和逾時:為避免 Looker 轉譯器程序超載,Looker 執行個體最多只能轉譯 2 個並行的圖像下載作業,例如 PDF 和 PNG 格式。如果 Looker 執行個體是客戶代管的,您可以設定 --concurrent-render-jobs 啟動選項,變更預設值。

  • Webhook 逾時:Looker 會嘗試將資料提交至 webhook,最多 30 分鐘。如果 Looker 無法在 30 分鐘內與 webhook 目的地通訊,查詢就會逾時。這項逾時值無法設定。
    • Proxy 逾時:客戶代管的執行個體通常會使用預設逾時時間為 60 秒的 Proxy。建議您將這項逾時值延長至 60 分鐘。詳情請參閱 Looker 社群的「在 Proxy 伺服器或負載平衡器後方執行 Looker」一文。

    • 資料庫逾時:大多數資料庫都有佇列和逾時規則,這些規則與 Looker 的佇列和逾時規則無關。舉例來說,查詢可能已離開 Looker 佇列,但仍可能在資料庫中排入佇列。如要進一步瞭解如何自訂資料庫查詢逾時時間,請參閱資料庫的說明文件。