쿼리 예제 query-examples
이 섹션에는 데이터 레이크에서 여정 단계 이벤트를 쿼리하는 데 일반적으로 사용되는 몇 가지 예가 나와 있습니다.
쿼리에 사용된 필드에 해당 스키마의 관련 값이 있는지 확인하십시오.
- id: 모든 단계 이벤트 항목에 대해 고유합니다. 서로 다른 두 단계 이벤트는 동일한 ID를 가질 수 없습니다.
- instanceId: instanceID는 여정 실행 내의 프로필에 연결된 모든 단계 이벤트에 대해 동일합니다. 프로필이 여정을 다시 입력하면 다른 instanceId가 사용됩니다. 이 새 instanceId는 다시 입력한 인스턴스의 모든 단계 이벤트(처음부터 끝까지)에 대해 동일합니다.
- profileID: 여정 네임스페이스에 해당하는 프로필의 ID입니다.
| note note |
|---|
| NOTE |
| 문제를 해결하려면 여정을 쿼리할 때 journeyVersionName 대신 journeyVersionID를 사용하는 것이 좋습니다. 이 섹션에서 여정 속성 특성 에 대해 자세히 알아보세요. |
기본 사용 사례/일반 쿼리 common-queries
이 쿼리는 주어진 시간대에 주어진 여정에 들어간 고유 프로필 수를 제공합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
여정_step_events에서 삭제된 이벤트 유형 문제를 해결하는 방법을 알아봅니다.
이 쿼리는 최대 한도나 자격 규칙으로 인해 프로필에 여정을 입력할 수 없는 경우 거부된 규칙 집합 및 규칙 정보를 반환합니다.
예
| code language-sql |
|---|
|
이 쿼리는 노드 이름별로 그룹화된 여정의 각 노드에서 오류가 발생한 개별 프로필을 계산합니다. 여기에는 모든 유형의 작업 실행 오류와 가져오기 오류가 포함됩니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
이 쿼리는 여정에서 삭제된 총 이벤트 수를 계산합니다. 세그먼트 내보내기 작업 오류, Dispatcher 삭제, 상태 시스템 삭제 등 다양한 삭제 이벤트 코드를 필터링합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
이 쿼리는 지정된 시간 동안 지정된 프로필과 여정에 대한 모든 단계 이벤트와 서비스 이벤트를 시간 순서대로 반환합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예를 들어 이러한 쿼리는 대기 활동에 소요된 시간을 예상하는 데 사용할 수 있습니다. 대기 활동이 올바르게 구성되었는지 확인할 수 있습니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
데이터 레이크 쿼리
| code language-sql |
|---|
|
여정 단계 이벤트 데이터 세트에는 모든 stepEvents 및 serviceEvents가 포함되어 있습니다. stepEvents는 여정 프로필의 활동(이벤트, 작업 등)과 관련하여 보고에 사용됩니다. serviceEvents는 동일한 데이터 세트에 저장되며 디버깅 목적을 위한 추가 정보(예: 경험 이벤트가 삭제되는 이유)를 나타냅니다.
다음은 serviceEvent의 세부 사항을 확인하는 쿼리의 예입니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
메시지/작업 오류 message-action-errors
| accordion | ||||
|---|---|---|---|---|
| 여정에서 발생한 각 오류 목록 | ||||
|
이 쿼리를 사용하면 메시지/작업을 실행하는 동안 여정에서 발생하는 각 오류를 나열할 수 있습니다. 데이터 레이크 쿼리
예
이 쿼리는 여정에서 작업을 실행하는 동안 발생한 다른 모든 오류와 발생한 횟수를 반환합니다. |
프로필 기반 쿼리 profile-based-queries
이 쿼리는 특정 프로필이 여정 및 여정 조합과 연관된 이벤트를 계산하여 해당 프로필이 이벤트에 입력되었는지 확인합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
결과는 0보다 커야 합니다. 이 쿼리는 프로필이 여정을 입력한 정확한 횟수를 반환합니다.
방법 1: 메시지 이름이 여정에서 고유하지 않은 경우(여러 위치에서 사용됨).
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
결과는 0보다 커야 합니다. 이 쿼리는 메시지 작업이 여정 측에서 성공적으로 실행되었는지 여부만 알려줍니다.
방법 2: 메시지 이름이 여정에서 고유한 경우.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
이 쿼리는 선택한 프로필에 대해 호출된 카운트와 함께 모든 메시지 목록을 반환합니다.
이 쿼리는 지난 30일 이내에 특정 프로필에 대해 성공적으로 실행된 모든 메시지 작업을 메시지 이름별로 그룹화하여 검색합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
이 쿼리는 선택한 프로필에 대해 호출된 카운트와 함께 모든 메시지 목록을 반환합니다.
이 쿼리는 각 여정에 대한 항목 수와 함께 특정 프로필이 지난 30일 이내에 입력한 모든 여정을 반환합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
쿼리는 모든 여정 이름 목록과 함께 쿼리된 프로필이 여정을 입력한 횟수를 반환합니다.
이 쿼리는 지정된 기간 동안 여정에 입력된 고유 프로필 수에 대한 일일 분류를 제공합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
쿼리는 정의된 기간 동안 매일 여정에 입력한 프로필 수를 반환합니다. 프로필이 여러 ID를 통해 입력된 경우 두 번 계산됩니다. 재입력이 활성화된 경우 다른 날에 여정을 다시 입력한 경우 다른 날에 프로필 수가 중복될 수 있습니다.
여정_step_events에서 삭제된 이벤트 유형 문제를 해결하는 방법을 알아봅니다.
대상자 읽기 관련 쿼리 read-segment-queries
이 쿼리는 작업이 큐에 있는 시간과 작업이 완료된 시간 사이의 시간 차이를 찾아 대상 내보내기 작업의 기간을 계산합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
쿼리는 대상 내보내기 작업이 큐에 추가된 시간과 최종적으로 종료되는 시간 사이의 시간 차이를 분 단위로 반환합니다.
이 쿼리는 대상자 읽기 작업 동안 인스턴스 복제 오류로 인해 삭제된 개별 프로필 수를 계산합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
쿼리는 여정이 중복되었기 때문에 삭제한 모든 프로필 ID를 반환합니다.
이 쿼리는 잘못된 네임스페이스가 있거나 필요한 네임스페이스에 대한 ID가 누락되었기 때문에 삭제된 프로필 수를 반환합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
이 쿼리는 잘못된 네임스페이스가 있거나 해당 네임스페이스에 대한 ID가 없기 때문에 여정에서 삭제된 모든 프로필 ID를 반환합니다.
이 쿼리는 여정 실행에 필요한 ID 맵이 누락되었기 때문에 삭제된 프로필을 계산합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
이 쿼리는 ID 맵이 누락되었기 때문에 여정이 삭제한 모든 프로필 ID를 반환합니다.
이 쿼리는 여정이 테스트 모드에서 실행 중이지만 프로필에 testProfile 특성이 true로 설정되지 않은 프로필을 식별합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
내보내기 작업이 테스트 모드에서 실행되었지만 프로필에 testProfile 특성이 true로 설정되지 않았으므로 여정에서 삭제된 모든 프로필 ID가 쿼리에서 반환됩니다.
이 쿼리는 여정 실행 중 내부 시스템 오류로 인해 삭제된 프로필 수를 반환합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
이 쿼리는 일부 내부 오류로 인해 여정에서 삭제된 모든 프로필 ID를 반환합니다.
이 쿼리는 대상 내보내기 프로세스의 모든 단계에 대한 세그먼트 내보내기 작업 세부 사항, 이벤트 코드, 상태 및 프로필 카운트를 포함하여 대상 읽기 활동에 대한 포괄적인 개요를 제공합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
지정된 여정 버전과 관련된 모든 서비스 이벤트를 반환합니다. 다음과 같은 작업 체인을 따를 수 있습니다.
- 주제 만들기
- 내보내기 작업 생성
- 내보내기 작업 종료(내보낸 프로필에 대한 지표 사용)
- 작업자 처리 종료
또한 다음과 같은 문제도 감지할 수 있습니다.
- 주제 또는 내보내기 작업 생성 오류(대상 내보내기 API 호출에 대한 시간 초과 포함)
- 중단 가능한 내보내기 작업(주어진 여정 버전에 대해 내보내기 작업 종료와 관련된 이벤트가 없는 경우)
- 작업자 문제, 내보내기 작업 종료 이벤트를 수신했지만 작업자 처리 종료 이벤트가 없는 경우
중요: 이 쿼리에서 반환된 이벤트가 없는 경우 다음 이유 중 하나가 원인일 수 있습니다.
- 여정 버전이 일정에 도달하지 않았습니다.
- 여정 버전에서 orchestrator를 호출하여 내보내기 작업을 트리거해야 하는 경우 업스트림 플로우에서 문제가 발생했습니다. 여정 배포 문제, 비즈니스 이벤트 또는 스케줄러 문제.
이 쿼리는 주제 생성 오류, API 호출 오류, 시간 초과 및 실패한 내보내기 작업과 같은 대상 읽기 실패와 관련된 특정 오류 이벤트 코드를 필터링합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
이 쿼리는 대상자 내보내기 작업의 처리 상태를 검색하여 프로필 내보내기 지표와 함께 성공 또는 실패 여부를 보여 줍니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
레코드가 반환되지 않으면 다음 중 하나를 의미합니다.
- 주제 또는 내보내기 작업을 만드는 동안 오류가 발생했습니다.
- 내보내기 작업이 아직 실행 중입니다.
이 쿼리는 삭제된 프로필 카운트와 내보내기 작업 지표를 결합하여 각 개별 내보내기 작업에 대한 대상 내보내기 성능의 전체 보기를 제공합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
이 쿼리는 주어진 여정 버전에 대한 모든 내보내기 작업의 전체 지표를 집계하며, 반복 여정 또는 항목 재사용이 있는 비즈니스 이벤트가 트리거된 여정에 유용합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
이 쿼리는 이전 쿼리와 다릅니다.
지정된 여정 버전에 대한 전체 지표를 반환합니다(반복 여정의 경우 비즈니스 이벤트가 항목 재사용을 활용하여 트리거됨).
대상 자격 관련 쿼리 segment-qualification-queries
이 쿼리는 대상 실현 상태가 여정의 대상 자격 구성과 일치하지 않아 삭제된 프로필을 식별합니다(예: "입력"에 대해 구성되었지만 프로필이 "종료됨").
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
이 쿼리는 잘못된 대상 인식으로 인해 여정 버전에서 삭제된 모든 프로필 ID를 반환합니다.
이 쿼리는 내부 서비스 오류로 인해 특정 프로필에 대해 삭제된 모든 대상 자격 또는 외부 이벤트를 검색합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
이 쿼리는 프로필에 대한 다른 이유로 인해 삭제된 모든 이벤트(외부 이벤트/대상 자격 이벤트)를 반환합니다.
이벤트 기반 쿼리 event-based-queries
이 쿼리는 지정된 기간 내에 날짜별로 그룹화된 여정이 비즈니스 이벤트를 받은 횟수를 계산합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
이 쿼리는 특정 여정에 대한 외부 이벤트가 해당 이벤트를 수신하도록 구성된 활성 이벤트나 일치하는 프로필이 없기 때문에 삭제된 시점을 식별합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
여정_step_events에서 삭제된 이벤트 유형 문제를 해결하는 방법을 알아봅니다.
이 쿼리는 이벤트 ID 및 오류 코드와 함께 내부 서비스 오류로 인해 특정 프로필에 대해 삭제된 외부 이벤트를 검색합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
여정_step_events에서 삭제된 이벤트 유형 문제를 해결하는 방법을 알아봅니다.
이 쿼리는 여정 상태 시스템에서 무시된 모든 이벤트를 집계하며, 가장 일반적인 삭제 이유를 식별하는 데 도움이 되도록 오류 코드별로 그룹화됩니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
여정_step_events에서 삭제된 이벤트 유형 문제를 해결하는 방법을 알아봅니다.
이 쿼리는 여정 구성에서 재입력이 허용되지 않은 경우 프로필이 여정 재입력을 시도하여 삭제된 모든 이벤트를 식별합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
여정_step_events에서 삭제된 이벤트 유형 문제를 해결하는 방법을 알아봅니다.
일반적인 여정 기반 쿼리 journey-based-queries
이 쿼리는 활동이 있는 고유한 여정 버전의 일별 수를 반환하므로 시간에 따른 여정 실행 패턴을 이해하는 데 도움이 됩니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
쿼리는 정의된 기간 동안 매일 트리거된 고유한 여정 수를 반환합니다. 여러 날에 트리거되는 단일 여정은 하루에 한 번 계산됩니다.
여정 인스턴스의 쿼리 journey-instances-queries
이 쿼리는 CTE(공통 테이블 표현식)를 사용하여 노드를 통과했지만 아직 다음 노드로 진행되지 않은 프로필을 찾아 여정의 특정 노드에서 현재 대기 중인 프로필을 식별합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
이 쿼리는 완료, 오류, 시간 초과 또는 최대 가용량 오류로 인한 종료를 포함하여 지정된 기간 동안 종료된 여정 인스턴스를 계산합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
이 쿼리는 여정 종료에 대한 자세한 분류를 제공하며, 종료된 각 인스턴스에 대한 노드 이름 및 종료 상태를 표시하여 프로필이 여정을 떠난 위치와 이유를 식별하는 데 도움이 됩니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
사용자 지정 작업 성능 지표와 관련된 쿼리 query-custom-action
이 쿼리는 총 호출 수, 성공적인 호출 수, 유형별 오류 카운트(4xx, 5xx, 시간 초과, 제한됨) 및 각 끝점에 대한 초당 요청 처리량을 포함하여 사용자 지정 HTTP 작업에 대한 성능 지표를 제공합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
이 쿼리는 이전 쿼리와 동일한 성능 지표를 제공하지만 시계열로 구성되어 분 단위 세부 기간에 따라 엔드포인트 성능이 시간에 따라 어떻게 변하는지를 보여 줍니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
이 쿼리는 사용자 지정 작업 끝점에 대한 응답 시간 백분위수를 계산하므로 지연 시간 분포를 이해하고 서로 다른 백분위수 임계값에서 성능 이상치를 식별하는 데 도움이 됩니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
이 쿼리는 시계열로 구성된 지연 백분위수를 제공하므로 다양한 백분위수 수준에서 시간에 따라 끝점 응답 시간이 어떻게 변경되는지 추적할 수 있습니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
이 쿼리는 제한이 적용된 끝점에 대한 큐 대기 시간을 분석하여 50번째 및 95번째 백분위수 대기 시간을 표시하므로 제한이 사용자 지정 작업에 미치는 영향을 이해하는 데 도움이 됩니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
이 쿼리는 큐 대기 시간 백분위수를 시계열로 제공하므로 제한이 각 끝점에 대한 시간 경과에 따른 대기 시간에 미치는 영향을 모니터링할 수 있습니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|
이 쿼리는 다시 시도 횟수에 대한 정보를 포함하여 오류 유형 및 오류 코드별로 그룹화된 특정 엔드포인트에 대한 오류에 대한 자세한 분류를 제공합니다.
데이터 레이크 쿼리
| code language-sql |
|---|
|
예
| code language-sql |
|---|
|