跳至主要內容
Telemetry
資料庫可靠性 SQL查詢範例

透過 SQLSTATE 和版本分析資料庫錯誤

按可移植 SQLSTATE 類、應用程式操作和發布對資料庫故障進行分組。

入門database_error_events已審查 2026-07-28測試用 阿帕奇 DataFusion 45.2.0

審閱者 Telemetry產品團隊 . SQL 相容性、事件契約、合成輸出和操作注意事項. 審查標準和所有權

問題已回答

應用程式發布後哪些資料庫錯誤類別增加了?

原始錯誤訊息不穩定,可能包含敏感值。 SQLSTATE 加上受控操作名稱支援版本比較並路由到正確的所有者。

活動合約

查詢期望的欄位

欄位型別為什麼存在
timestamp_utcTimestamp資料庫故障時間。
database_systemUtf8資料庫系統。
operation_nameUtf8受控的應用程式操作。
sqlstateUtf8可移植的 SQLSTATE 程式碼(如果可用)。
releaseUtf8應用發布。
request_idUtf8安全父請求識別符號。
DataFusion SQL

複製查詢

sql
SELECT
  database_system,
  release,
  operation_name,
  sqlstate,
  COUNT(*) AS failures,
  COUNT(DISTINCT request_id) AS affected_requests
FROM database_error_events
WHERE timestamp_utc >= now() - INTERVAL '7 days'
GROUP BY database_system, release, operation_name, sqlstate
ORDER BY failures DESC, affected_requests DESC;

此只讀查詢是針對空型別資料表計劃和執行的 阿帕奇 DataFusion 45.2.0。確定性樣本輸出是綜合的並單獨審查;根據您自己的資料驗證欄位型別、閾值和業務定義。 閱讀測試方法。

查詢結果

SQLSTATE 導致的資料庫故障

結帳時的序列化失敗在該版本的資料庫錯誤中占主導地位。

database_systemreleaseoperation_namesqlstatefailuresaffected_requests
postgresqlapi-88checkout40001184176
postgresqlapi-88project-create235056262

綜合範例輸出。在將其用於操作決策之前,針對您自己的事件架構和閾值執行查詢。

Database failures by SQLSTATE:來自 Analyze Database Errors by SQLSTATE and Release 範例結果的合成 failures 值的靜態圖表
確定性範例輸出的可索引 SVG。下載它以獲取帶有歸屬的文章、操作手冊或設計評論。

重現範例

下載公共裝置

JSON 包包含型別化事件契約, illustrative 輸入行、確切的 SQL、預期輸出、審閱註釋和引擎版本。 CSV 包含顯示的結果。

SQL 是如何工作的

  1. 1SQLSTATE 比對原始錯誤字串進行分組更安全、更穩定。
  2. 2操作名稱保留應用程式所有權。
  3. 3不同的請求估計面向客戶的影響。

需要決定的邊緣情況

  • 並非每個驅動程式都一致地公開 SQLSTATE。
  • 相同的 SQLSTATE 可能有不同的原因。
  • 儲存經過清理的錯誤類別,而不是完整的語句值或伺服器訊息。

推薦儀表板

  • 條形:SQLSTATE 失敗
  • 趨勢:按版本劃分的失敗情況
  • 資料表:受影響的操作和請求計數

警示指導

發布後對新的高容量 SQLSTATE 或已知的關鍵類(例如連線失敗)發出警示。

讀取警示設定

讓查詢範例發揮作用

相關埋點和指南

繼續分析

在真實事件中執行它

建立資料表,調整欄位並儲存結果

免費開始,傳送結構化事件,並將查詢結果用作圖表、共享儀表板小工具或警示輸入。

獲取 API 金鑰