콘텐츠로 건너뛰기
Telemetry
문서 찾아보기
개념 및 SQL 패턴업데이트된 2026년 7월 25일Telemetry 편집 및 제품 팀의 검토1 최소 읽기

계측이 증가함에 따라 이벤트 필드의 일관성 유지

Telemetry가 에이전트가 작성한 구조적 이벤트를 안정적이고 쿼리 가능한 테이블로 전환하는 방법을 알아보세요.

CamelCase와 snake_case

Telemetry 이벤트 필드에는 snake_case를 사용하세요. total_cost 같은 소문자 이름은 SQL에서 큰따옴표 없이 사용할 수 있습니다. totalCost처럼 대소문자가 섞인 이름은 대소문자를 유지하려면 따옴표가 필요합니다.

대소문자가 섞인 필드 쿼리

camelCase 필드는 다음과 같이 작성합니다.

SELECT "myFieldName" FROM my_table;

snake_case 필드는 다음과 같이 작성합니다.

SELECT my_field_name FROM my_table;

쿼리를 복사하거나 조인을 추가할 때 따옴표를 빠뜨리기 쉽습니다. 새 이벤트 스키마를 정의할 때 소문자 이름을 선택하고 모든 생성 코드에서 철자를 통일하세요.

기존 스키마

대소문자가 섞인 기존 필드는 유지해도 됩니다. 다른 시스템으로 내보내는 쿼리를 포함해 항상 따옴표를 붙이세요. 필드 이름을 바꾸면 생성 코드와 사용 코드를 함께 업데이트하세요. 철자를 바꾸면 다른 필드가 생기며, 이전 데이터의 이름은 바뀌지 않습니다.

대시보드나 알림에서 사용하는 필드를 변경하기 전에 스키마 변경을 확인하세요.

관련 기능

안정적인 이벤트 이름, 타입이 지정된 필드, 개인 정보 보호 검토 컨텍스트를 캡처합니다.

페이지 작성자 및 참고 자료

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

문서 검토 방법