쿼리 예제 query-examples
이 섹션에는 데이터 레이크에서 여정 단계 이벤트를 쿼리하는 데 일반적으로 사용되는 몇 가지 예가 나와 있습니다.
쿼리에 사용된 필드에 해당 스키마의 관련 값이 있는지 확인하십시오.
- id: 모든 단계 이벤트 항목에 대해 고유합니다. 서로 다른 두 단계 이벤트는 동일한 ID를 가질 수 없습니다.
- instanceId: instanceID는 여정 실행 내의 프로필에 연결된 모든 단계 이벤트에 대해 동일합니다. 프로필이 여정을 다시 입력하면 다른 instanceId가 사용됩니다. 이 새 instanceId는 다시 입력한 인스턴스의 모든 단계 이벤트(처음부터 끝까지)에 대해 동일합니다.
- profileID: 여정 네임스페이스에 해당하는 프로필의 ID입니다.
note note |
---|
NOTE |
문제를 해결하려면 여정을 쿼리할 때 journeyVersionName 대신 journeyVersionID를 사용하는 것이 좋습니다. 이 섹션에서 여정 속성 특성에 대해 자세히 알아보세요. |
기본 사용 사례/일반 쿼리 common-queries
accordion | ||
---|---|---|
특정 시간대에 여정에 입력한 프로필 수 | ||
이 쿼리는 주어진 시간대에 주어진 여정에 들어간 고유 프로필 수를 제공합니다. 데이터 레이크 쿼리
|
예
code language-sql |
---|
|
데이터 레이크 쿼리
code language-sql |
---|
|
데이터 레이크 쿼리
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 |
---|
|
이 쿼리는 선택한 프로필에 대해 호출된 카운트와 함께 모든 메시지 목록을 반환합니다.
데이터 레이크 쿼리
code language-sql |
---|
|
예
code language-sql |
---|
|
이 쿼리는 선택한 프로필에 대해 호출된 카운트와 함께 모든 메시지 목록을 반환합니다.
데이터 레이크 쿼리
code language-sql |
---|
|
예
code language-sql |
---|
|
쿼리는 모든 여정 이름 목록과 함께 쿼리된 프로필이 여정을 입력한 횟수를 반환합니다.
데이터 레이크 쿼리
code language-sql |
---|
|
예
code language-sql |
---|
|
쿼리는 정의된 기간 동안 매일 여정에 입력한 프로필 수를 반환합니다. 프로필이 여러 ID를 통해 입력된 경우 두 번 계산됩니다. 재입력이 활성화된 경우 다른 날에 여정을 다시 입력한 경우 다른 날에 프로필 수가 중복될 수 있습니다.
대상자 읽기 관련 쿼리 read-segment-queries
데이터 레이크 쿼리
code language-sql |
---|
|
예
code language-sql |
---|
|
쿼리는 대상 내보내기 작업이 큐에 추가된 시간과 최종적으로 종료되는 시간 사이의 시간 차이를 분 단위로 반환합니다.
데이터 레이크 쿼리
code language-sql |
---|
|
예
code language-sql |
---|
|
쿼리는 여정이 중복되었기 때문에 삭제한 모든 프로필 ID를 반환합니다.
데이터 레이크 쿼리
code language-sql |
---|
|
예
code language-sql |
---|
|
이 쿼리는 잘못된 네임스페이스가 있거나 해당 네임스페이스에 대한 ID가 없기 때문에 여정에서 삭제된 모든 프로필 ID를 반환합니다.
데이터 레이크 쿼리
code language-sql |
---|
|
예
code language-sql |
---|
|
이 쿼리는 ID 맵이 누락되었기 때문에 여정이 삭제한 모든 프로필 ID를 반환합니다.
데이터 레이크 쿼리
code language-sql |
---|
|
예
code language-sql |
---|
|
내보내기 작업이 테스트 모드에서 실행되었지만 프로필에 testProfile 특성이 true로 설정되지 않았으므로 여정에서 삭제된 모든 프로필 ID가 쿼리에서 반환됩니다.
데이터 레이크 쿼리
code language-sql |
---|
|
예
code language-sql |
---|
|
이 쿼리는 일부 내부 오류로 인해 여정에서 삭제된 모든 프로필 ID를 반환합니다.
데이터 레이크 쿼리
code language-sql |
---|
|
지정된 여정 버전과 관련된 모든 서비스 이벤트를 반환합니다. 다음과 같은 작업 체인을 따를 수 있습니다.
- 주제 만들기
- 내보내기 작업 생성
- 내보내기 작업 종료(내보낸 프로필에 대한 지표 사용)
- 작업자 처리 종료
또한 다음과 같은 문제도 감지할 수 있습니다.
- 주제 또는 내보내기 작업 생성 오류(대상 내보내기 API 호출에 대한 시간 초과 포함)
- 중단 가능한 내보내기 작업(주어진 여정 버전에 대해 내보내기 작업 종료와 관련된 이벤트가 없는 경우)
- 작업자 문제, 내보내기 작업 종료 이벤트를 수신했지만 작업자 처리 종료 이벤트가 없는 경우
중요: 이 쿼리에서 반환된 이벤트가 없는 경우 다음 이유 중 하나가 원인일 수 있습니다.
- 여정 버전이 일정에 도달하지 않았습니다.
- 여정 버전이 orchestrator를 호출하여 내보내기 작업을 트리거해야 하는 경우 업그레이드 플로우에서 문제가 발생했습니다. 여정 배포 문제, 비즈니스 이벤트 또는 스케줄러 문제.
데이터 레이크 쿼리
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 |
---|
|
데이터 레이크 쿼리
code language-sql |
---|
|
예
code language-sql |
---|
|
데이터 레이크 쿼리
code language-sql |
---|
|
예
code language-sql |
---|
|
데이터 레이크 쿼리
code language-sql |
---|
|
예
code language-sql |
---|
|
일반적인 여정 기반 쿼리 journey-based-queries
데이터 레이크 쿼리
code language-sql |
---|
|
예
code language-sql |
---|
|
쿼리는 정의된 기간 동안 매일 트리거된 고유한 여정 수를 반환합니다. 여러 날에 트리거되는 단일 여정은 하루에 한 번 계산됩니다.
여정 인스턴스의 쿼리 journey-instances-queries
데이터 레이크 쿼리
code language-sql |
---|
|
예
code language-sql |
---|
|
데이터 레이크 쿼리
code language-sql |
---|
|
예
code language-sql |
---|
|
데이터 레이크 쿼리
code language-sql |
---|
|
예
code language-sql |
---|
|