콘텐츠로 건너뛰기
Telemetry
문서 찾아보기
가이드업데이트된 2026년 7월 29일Telemetry 편집 및 제품 팀의 검토3 최소 읽기

코딩 에이전트와 함께 이 문서를 사용하세요.

Claude Code, Codex, Cursor 또는 다른 코딩 에이전트에 대한 집중 프롬프트 팩을 연 다음 여기에서 다루는 워크플로에 맞게 조정하세요.

이 페이지에서
  1. 제한된 프롬프트 작성
  2. 생성된 쿼리 검토
  3. 결과 검증
  4. 검토된 분석만 저장
  5. 약한 첫 번째 답변 개선

AI 지원 SQL: 쿼리 생성, 검토 및 검증

Telemetry는 일반 언어 질문과 테이블 메타데이터를 사용하여 첫 번째 DataFusion SQL 쿼리 또는 시각화 계획을 생성할 수 있습니다. SQL는 쿼리 작업공간에 계속 표시되고 편집 가능합니다. 이렇게 하면 공백 페이지 시간을 줄일 수 있지만 모호한 비즈니스 질문을 권위 있는 측정 기준으로 바꾸지는 않습니다.

가속을 위해 AI 지원을 사용하십시오. 기본 시스템을 검토할 수 있는 사람들과 함께 이벤트 계약, 계산 규칙, 개인 정보 보호 결정 및 프로덕션 임계값에 대한 소유권을 유지하세요.

제한된 프롬프트 작성

유용한 프롬프트는 테이블, 이벤트 그레인, 지표, 시간 범위, 필터, 그룹화 및 예상 출력을 식별합니다. 예를 들면:

Using api_request_completed, calculate hourly error rate for production
over the last seven complete days. A failed request has outcome = 'error'.
Return request_count, failed_count, and error_rate. Split by route_template,
exclude incomplete current-hour data, and order newest hour first.

이는 분모, 결과 정의, 시간 경계 및 그룹화가 명시적이므로 "API 상태 표시"보다 안전합니다.

비밀, 원시 고객 콘텐츠, 액세스 토큰, 개인 프롬프트 또는 검토되지 않은 개인 데이터를 지침에 붙여넣지 마십시오. 스키마 이름, 제한된 범주 및 합성 예제를 선호합니다.

생성된 쿼리 검토

생성된 SQL을 실행하거나 저장하기 전에 다음 가정을 검사하십시오.

검토 영역 질문
테이블과 곡물 한 행은 계산되는 단위를 나타냅니까?
필드 이름 및 유형 참조된 필드가 호환되는 유형으로 존재합니까?
시간 의도한 UTC 타임스탬프가 필터링되고 불완전한 버킷이 처리됩니까?
분모 성공률만이 아닌 모든 적격 결과로 비율이 나누어지나요?
누락된 값이 의도적으로 제외, 그룹화 또는 기본값으로 설정되었습니까?
조인 각 테이블은 조인하기 전에 안전한 그레인으로 사전 집계되었나요?
중복 재시도 또는 반복 전달이 동일한 비즈니스 결과를 두 번 계산할 수 있습니까?
치수 그룹화 필드가 유용한 결과를 반환할 만큼 충분히 제한되어 있습니까?
단위 기간, 바이트, 토큰, 통화 및 백분율이 일관되게 변환됩니까?

DataFusion SQL는 PostgreSQL, BigQuery, Snowflake 및 기타 엔진과 다릅니다. 구문적으로 친숙한 함수에는 지원되는 동등한 함수가 필요할 수 있습니다. 생성된 표현식이 계획되지 않은 경우 DataFusion SQL 참조를 사용하세요.

결과 검증

성공적인 실행은 쿼리가 실행되었음을 증명할 뿐입니다. 고정물이나 알려진 작은 창을 사용하여 의미를 검증합니다.

  1. 하나의 예상 그룹에 대한 원시 행을 검사합니다.
  2. 하나의 개수, 합계 또는 비율을 수동으로 계산합니다.
  3. 결과를 생성된 집계와 비교합니다.
  4. 빈 기간과 Null을 포함하는 기간을 테스트합니다.
  5. 부분 데이터가 있는지 최신 버킷을 확인하세요.
  6. 필터 하나를 바꿔보고 예상한 방향으로 결과가 바뀌는 것을 확인해보세요.

조인의 경우 조인 전후의 행 수를 비교합니다. 예상치 못한 곱셈은 종종 호환되지 않는 곡물을 나타냅니다.

검토된 분석만 저장

이를 생성한 프롬프트가 아닌 지원하는 결정에 대해 검토된 쿼리의 이름을 바꿉니다. 가능한 경우 이름에 단위와 중요한 범위를 포함합니다. 로직 변경 시 새로운 이력 항목을 저장하고 이를 사용하는 대시보드 옆에서 재료 정의 변경 사항을 설명합니다.

도메인 검토 및 대표 테스트 없이 생성된 SQL을 페이징 알림, 청구 작업 흐름, 액세스 제어 결정 또는 고객 대상 재무 보고서에 직접 연결하지 마십시오.

약한 첫 번째 답변 개선

첫 번째 쿼리가 잘못된 경우 수정 내용을 명시적으로 지정하세요.

  • 행 단위와 적격 모집단을 정의합니다.
  • 정확한 범주형 값을 제공합니다.
  • ID가 사용자, 계정, 세션 또는 이벤트별인지 여부를 지정합니다.
  • 예상 시간 필드와 버킷의 이름을 지정합니다.
  • null, 재시도 및 중복 전달을 처리하는 방법을 설명합니다.
  • 최종 백분율 외에 중간 개수를 요청합니다.
  • SQL을 사용하여 간단한 가정 목록을 요청하세요.

Telemetry 프롬프트 팩에는 재사용 가능한 기기와 SQL 검토 프롬프트가 포함되어 있습니다. SQL 옵저버빌리티 및 이벤트 분석을 계속 진행하거나 SaaS SQL 랩에서 결정적 데이터에 대해 연습해 보세요.

관련 제품 기능

구조화된 이벤트 테이블에 대해 읽기 전용 DataFusion SQL을 실행하고 결과를 재사용합니다.

소유권 및 기술 참조

이 설명은 Telemetry 편집팀의 소유입니다. 제품 팀은 동작, 예시, 경계를 검토합니다.

편집 기준 검토