匯出查詢結果
使用同步查詢 API 獲得緊湊的互動結果。當掃描或結果太大而無法開啟 HTTP 請求時，或者當下遊系統需要 JSON 或 Parquet 時，請使用非同步查詢。
首先塑造出口
僅匯出消費者需要的列和時間範圍。有界的顯式查詢更容易審查，並且不太可能暴露不相關的欄位：
SELECT
date_trunc('day', timestamp_utc) AS day,
feature,
SUM(estimated_cost_usd) AS cost_usd
FROM llm_requests
WHERE timestamp_utc >= now() - INTERVAL '30 days'
GROUP BY date_trunc('day', timestamp_utc), feature
ORDER BY day, feature;
當資料工具將掃描大型鍵入結果時，首選 Parquet。當指令碼或工作流程直接需要較小的結果時，首選 JSON。
啟動非同步查詢
curl -X POST https://api.telemetry.sh/query/async \
-H "Authorization: Bearer $TELEMETRY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "SELECT * FROM api_requests WHERE timestamp_utc >= now() - INTERVAL '\''24 hours'\''",
"format": "parquet"
}'
接受的回應包含作業 ID 和狀態 URL。使用相同的可讀 API 金鑰輪詢狀態 URL，直到作業完成或最終失敗。在民意調查之間退後一步，而不是進行緊密的迴圈。
完成後，在返回的 URL 過期之前下載結果。根據所選列的敏感度處理下載 URL 和匯出的檔案。
較小的 JSON 查詢結果直接包含在完成回應的 result（data 和 key_order）中。只有沒有直接回傳結果時才需要下載 URL。兩種回應格式請參閱查詢 API 參考。
使出口可複製
透過自動化儲存審閱的 SQL、匯出格式、計劃、所有者和目的地。對計劃的報告使用固定的關閉時間視窗，這樣重試就不會默默地匯出不同的時間段。
對於增量交付，定義水印和重疊策略。遲到事件可能需要較小的重新處理視窗和下游重複資料刪除。
保護下游系統
請勿匯出秘密或原始私人內容。為報告工作負載提供 read 金鑰並隔離其目標憑據。在替換生產報告之前驗證行計數、架構、時間邊界和空值率。