Profile Query Language (PQL)은 Experience Data Model 다음에 대한 세분화 쿼리의 정의 및 실행을 지원하도록 설계된 XDM(Compliant Query Language) Real-Time Customer Profile 데이터.
이 안내서에서는 서식 지정 지침에 대해 설명하고 예제 PQL 표현식을 제공하는 등 PQL에 대한 일반적인 개요를 제공합니다.
PQL 쿼리에는 다음 서명이 있습니다.
({INPUT_PARAMETER_1}, {INPUT_PARAMETER_2}, ...) => {RESULT_TYPE}
입력 매개 변수는 부울 또는 문자열과 같은 단순 기본 형식이거나 객체, 배열 또는 맵과 같은 보다 복잡한 유형일 수 있습니다.
PQL 표현식의 본문 내에서 입력 매개 변수를 참조하는 방법에는 세 가지가 있습니다.
아래 예에서 첫 번째 매개 변수는 항상 컨텍스트에 있으므로 속성 참조(homeAddress
)을 로 바로 만들 수 있습니다.
homeAddress.stateProvince = workAddress.stateProvince
아래 예에서는 $1
는 첫 번째 매개 변수를 참조합니다. 그 결과, $2
는 두 번째 매개 변수 등을 참조합니다.
$1.homeAddress.stateProvince = $1.homeAddress.stateProvince
아래 예에서는 Profile
는 쿼리 작성자가 선택할 수 있는 변수 이름입니다.
(Profile) => Profile.homeAddress.stateProvince = Profile.workAddress.stateProvince
PQL은 다음과 같은 리터럴 유형을 지원합니다.
리터럴 | 정의 | 예 |
---|---|---|
문자열 | 큰따옴표로 묶인 문자로 구성된 데이터 유형입니다. | "pizza" , "jobs" , "antidisestablishmentarianism" |
부울 | true 또는 false인 데이터 유형입니다. | true , false |
정수 | 정수를 나타내는 데이터 형식입니다. 양수, 음수 또는 0일 수 있습니다. | -201 , 0 , 412 |
이중 | 실수를 나타내는 데이터 유형입니다. 양수, 음수 또는 0일 수 있습니다. | -51.24 , 3.14 , 0.6942058 |
날짜 | 연도, 월 및 일을 기준으로 날짜를 정수 매개 변수로 만드는 데 사용할 수 있는 데이터 형식입니다. 형식은 다음과 같습니다. date(year, month, day) |
date(2020, 3, 14) |
배열 | 다른 리터럴 값의 그룹으로 구성된 데이터 유형입니다. 대괄호를 사용하여 그룹화하고 쉼표를 사용하여 서로 다른 값 사이를 구분합니다. 참고: 배열 내의 항목 속성에 직접 액세스할 수 없습니다. 따라서 배열 내의 속성에 액세스해야 하는 경우 지원되는 메서드는 다음과 같습니다 select X from array where X.item = ... . PQL은 xEvent 프로필에 연결된 경험 이벤트 배열을 참조하십시오. |
[1, 4, 7] , ["US", "CA"] |
상대 시간 참조 | 타임스탬프 및 시간 간격 참조를 구성하는 데 사용할 수 있는 예약어입니다.
|
X.timestamp occurs before today , X.timestamp occurs last month , X.timestamp occurs <= 3 days before now |
다음 표는 자세한 내용을 보기 위한 추가 설명서에 대한 링크를 포함하여 지원되는 PQL 함수의 다양한 범주를 간략하게 설명합니다.
카테고리 | 정의 |
---|---|
부울 | PQL 내에서 부울 대수를 구현하는 데 사용됩니다. 이러한 함수에 대한 자세한 내용은 부울 함수 문서. |
비교 | 서로 다른 PQL 요소를 비교하는 데 사용됩니다. 이러한 함수에 대한 자세한 내용은 비교 함수 문서. |
배열, 목록 및 집합 | 배열, 목록 및 집합과 상호 작용하는 데 사용됩니다. 이러한 함수에 대한 자세한 내용은 배열, 목록 및 집합 함수 문서. |
맵 | 지도와 상호 작용하는 데 사용됩니다. 이러한 함수에 대한 자세한 내용은 맵 함수 문서. |
문자열 | 문자열과 상호 작용하는 데 사용됩니다. 이러한 함수에 대한 자세한 내용은 문자열 함수 문서. |
오브젝트 | 개체와 상호 작용하는 데 사용됩니다. 이러한 함수에 대한 자세한 내용은 객체 함수 문서. |
산술 | PQL 요소에서 기본 산술을 수행하는 데 사용됩니다. 이러한 함수에 대한 자세한 내용은 산술 함수 문서 |
집계 | 배열의 결과를 단일 결과로 결합하는 데 사용됩니다. 집계 함수에 대한 자세한 내용은 집계 함수 문서. |
날짜 및 시간 | 날짜, 시간 및 날짜/시간 오브젝트와 함께 사용됩니다. 이러한 함수에 대한 자세한 내용은 날짜/시간 함수 문서. |
필터 | 배열 내의 데이터를 필터링하는 데 사용됩니다. 이러한 함수에 대한 자세한 내용은 필터 함수 문서. |
논리적 수량자 | 배열 내에서 조건을 어설션하는 데 사용됩니다. 자세한 내용은 논리적 수량자 문서. |
기타 | 위의 범주에 맞지 않는 함수는 기타 함수 문서. |
이제 를 사용하는 방법을 배웠습니다 Profile Query Language, 세그먼트 정의를 만들고 수정할 때 PQL을 사용할 수 있습니다. 세그멘테이션에 대한 자세한 내용은 세그먼테이션 개요.