쿼리 결과 내보내기
간결한 대화형 결과를 얻으려면 동기식 쿼리 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 키를 제공하고 대상 자격 증명을 격리합니다. 프로덕션 보고서를 교체하기 전에 행 수, 스키마, 시간 경계 및 Null 비율을 검증하십시오.