在 Looker (Google Cloud Core) 執行互動式查詢時,查詢可能會在「探索」UI 或資訊主頁中無限期執行。不過,後端資料庫記錄顯示,查詢在 20 到 30 秒後明確取消。
本頁面說明發生這種行為的原因,以及如何調整中介網路基礎架構的逾時設定來解決問題。本指南適用於管理網路轉送,以及排解 Looker (Google Cloud Core) 查詢問題的管理員。
問題
在探索或資訊主頁中執行互動式查詢時,可能會遇到下列情況:
- Looker 使用者介面:Looker 探索 UI 或資訊主頁圖塊無限期維持在「執行中」(旋轉) 狀態,且不會傳回結果或顯示錯誤。
- 後端資料庫執行時間:在後端資料庫 (例如 BigQuery、Snowflake 或 PostgreSQL) 中,查詢會在短時間內取消,通常是 20 到 30 秒。
- 後端資料庫查詢記錄:後端資料庫的查詢記錄或稽核記錄顯示,使用者明確取消了工作,即使您並未取消查詢或關閉瀏覽器分頁。
原因
發生這個問題的原因,是 Looker 的工作階段活動訊號機制,與中繼網路裝置上設定的逾時設定不符。中繼網路裝置會在瀏覽器和 Looker (Google Cloud Core) 執行個體之間轉送流量。
工作階段活動訊號和查詢放棄機制
為有效管理資料庫資源用量,Looker (Google Cloud Core) 會在執行查詢期間,透過下列機制監控用戶端連線:
- 持續心跳訊號:在 Looker UI 中執行互動式查詢時,網路瀏覽器會維持有效連線,並持續傳送心跳訊號至 Looker (Google Cloud Core) 執行個體,讓查詢工作階段保持有效狀態。
- 中介連線逾時:如果中介網路裝置 (例如應用程式負載平衡器、企業反向 Proxy、網頁應用程式防火牆 (WAF) 或 VPN 閘道) 的閒置或回應逾時設定較短 (例如Google Cloud 應用程式負載平衡器的預設後端服務逾時時間為 30 秒),當查詢執行階段超過該門檻時,裝置會提前關閉或中斷連線。
- 查詢放棄偵測:中繼連線關閉後,Looker (Google Cloud Core) 會停止接收瀏覽器的心跳訊號。如果約 30 秒內未收到心跳訊號,Looker (Google Cloud Core) 會偵測到用戶端工作階段已無法連線,並將查詢視為已放棄。
- 資料庫清理:為避免在沒有使用者等待的查詢上消耗不必要的資料庫運算資源,Looker (Google Cloud Core) 會自動向後端資料庫傳送取消要求。由於 Looker 是代表執行查詢的使用者發出取消要求,因此資料庫記錄會顯示工作是由使用者取消。
- UI 顯示無限期執行狀態:中繼 Proxy 或閘道關閉瀏覽器與 Looker (Google Cloud Core) 之間的連線,因此瀏覽器不會收到取消狀態或錯誤回應。因此,Looker 探索 UI 或資訊主頁圖塊會一直卡在「Running」(執行中) 狀態。
找出問題所在
如要判斷查詢取消是否由中繼網路逾時造成,請按照下列步驟操作:
- 檢查資料庫查詢記錄:在後端資料庫中,查看已取消查詢的執行記錄:
- 在 BigQuery 中,前往Google Cloud 控制台的「Query history」(查詢記錄) 頁面,或在 Google Cloud 控制台中查看專案的工作記錄,並找出失敗的工作。查看工作詳細資料,確認查詢在大約 20 到 30 秒後取消,且狀態為「已取消」。
- 在 Snowflake 中,檢查
QUERY_HISTORY檢視畫面或 Snowsight 中的「History」(記錄) 分頁。檢查查詢狀態是否顯示FAILED_WITH_ERROR,或指出查詢在大約 30 秒後由使用者取消。 - 在 PostgreSQL 中,查看伺服器記錄,找出與查詢時間戳記相符的訊息,例如
canceling statement due to user request。
- 確認查詢時間長度:在資料庫記錄中,記下查詢取消前的確切時間長度。如果查詢持續在 30 秒左右取消 (或在 Proxy 或負載平衡器設定的逾時限制附近),則可能是中繼網路逾時觸發取消。
- 檢查中介網路基礎架構:找出使用者瀏覽器和 Looker (Google Cloud Core) 執行個體之間,網路路徑中的任何反向 Proxy、負載平衡器或 VPN。
解析度
如要解決這個問題,請在所有網路裝置上,提高閒置和回應逾時設定,這些裝置會在使用者瀏覽器和 Looker (Google Cloud Core) 執行個體之間轉送流量。將逾時限制設為高於預期最長的互動式查詢執行時間。
提高應用程式負載平衡器後端服務逾時時間
如果 Looker (Google Cloud Core) 執行個體前端有外部或內部應用程式負載平衡器,請按照下列步驟操作:
前往 Google Cloud 控制台的「Load balancing」(負載平衡) 頁面:
按一下「Backends」(後端),然後點選與 Looker (Google Cloud Core) 執行個體相關聯的後端服務名稱。
按一下 [編輯]。
在「Timeout」(逾時) 欄位中,提高逾時值。舉例來說,您可以根據預期的查詢執行時間,將預設值從 30 秒變更為 300 秒 (5 分鐘) 或更長。
按一下「儲存」。
增加 Proxy、WAF 或 VPN 逾時值
如果使用者透過企業正向 Proxy、反向 Proxy (例如 NGINX 或 Apache)、WAF 或 VPN 閘道存取 Looker (Google Cloud Core),請按照下列步驟操作:
- 在 Proxy 或閘道設定中,找出連線、回應或閒置逾時設定,例如:
- 在 NGINX 中,增加
proxy_read_timeout和proxy_send_timeout指令。 - 在 Apache 中,增加
TimeOut或ProxyTimeout指令。 - 在企業 VPN 或防火牆閘道中,提高傳送至 Looker (Google Cloud Core) 網域的 HTTPS 流量 TCP 工作階段閒置逾時時間。
- 在 NGINX 中,增加
- 允許透過 Proxy 建立長期 HTTP 和 WebSocket 連線,讓瀏覽器心跳訊號不中斷地傳送至 Looker (Google Cloud Core)。
- 套用設定變更,然後重新啟動或重新載入 Proxy 服務。
確認問題是否已解決
提高負載平衡器或中繼 Proxy 的逾時設定後,請按照下列步驟操作,確認查詢是否成功完成:
- 在 Looker (Google Cloud Core) 中,前往先前取消查詢的「探索」或資訊主頁。
- 執行先前失敗的查詢。
- 確認查詢執行時間超過先前的逾時門檻 (例如 30 秒),且未取消,並在 UI 中顯示結果。
- 您可以視需要查看後端資料庫查詢記錄,確認工作已成功完成,且沒有使用者取消狀態。
相關資源
- 排解 Looker (Google Cloud Core) 網路問題:504 逾時錯誤
- 查看 Looker (Google Cloud Core) 的執行個體記錄
- 取得 Looker (Google Cloud Core) 支援