跳至主要內容
Telemetry
資料品質 SQL查詢範例

測量必填欄位空率

查詢所需帳戶、狀態或相關欄位正在消失的事件合約。

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

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

問題已回答

哪些事件名稱的帳戶識別符號丟失率不可接受?

模式相容性並不能保證分析完整性。當部署停止填充分段或聯接所需的欄位時,可空列可以保持有效。

活動合約

查詢期望的欄位

欄位型別為什麼存在
timestamp_utcTimestamp事件發生時間。
event_nameUtf8穩定事件合約名稱。
account_idUtf8這些事件需要帳戶識別符號。
producer_versionUtf8發出事件的應用程式版本。
DataFusion SQL

複製查詢

sql
SELECT
  event_name,
  producer_version,
  COUNT(*) AS events,
  SUM(CASE
    WHEN account_id IS NULL OR trim(account_id) = '' THEN 1
    ELSE 0
  END) AS missing_account_id,
  100.0 * SUM(CASE
    WHEN account_id IS NULL OR trim(account_id) = '' THEN 1
    ELSE 0
  END) / NULLIF(COUNT(*), 0) AS missing_rate_pct
FROM product_events
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
GROUP BY event_name, producer_version
HAVING COUNT(*) >= 20
ORDER BY missing_rate_pct DESC, events DESC;

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

查詢結果

按活動和製作人劃分的帳戶 ID 缺失率

儀表板事件具有特定於版本的完整性迴歸。

event_nameproducer_versioneventsmissing_account_idmissing_rate_pct
dashboard_viewedweb-18426,4201,18718.49
query_completedapi-9183,81070.18

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

Missing account ID rate by event and producer:來自 Measure Required-Field Null Rate 範例結果的合成 missing_rate_pct 值的靜態圖表
確定性範例輸出的可索引 SVG。下載它以獲取帶有歸屬的文章、操作手冊或設計評論。

重現範例

下載公共裝置

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

SQL 是如何工作的

  1. 1CASE 表示式將 NULL 和空字串視為缺失。
  2. 2按 producer_version 分組使部署迴歸更容易隔離。
  3. 3最小數量規則可以防止少數開發事件在報告中佔據主導地位。

需要決定的邊緣情況

  • 僅評估活動合約中真正需要的欄位。
  • 匿名產品事件可能合法地缺少 account_id,並且應使用單獨的完整性規則。
  • 諸如“未知”之類的佔位符不為 NULL,但仍可以隱藏缺失的身分;單獨測量哨兵值。

推薦儀表板

  • 條形:missing_rate_pct by event_name 和 producer_version
  • 趨勢:關鍵合約的完成率
  • 資料表:最近的行缺少必填欄位

警示指導

當關鍵事件合約超出其記錄的有意義的缺場預算時發出警示。

讀取警示設定

讓查詢範例發揮作用

相關埋點和指南

繼續分析

在真實事件中執行它

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

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

獲取 API 金鑰