Profile Query Language (PQL) 개요

Profile Query Language (PQL)은 Experience Data Model 다음에 대한 세분화 쿼리의 정의 및 실행을 지원하도록 설계된 XDM(Compliant Query Language) Real-Time Customer Profile 데이터.

이 안내서에서는 서식 지정 지침에 대해 설명하고 예제 PQL 표현식을 제공하는 등 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 리터럴

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"]
상대 시간 참조

타임스탬프 및 시간 간격 참조를 구성하는 데 사용할 수 있는 예약어입니다.

  • 지금, 오늘, 어제, 내일
  • 이, 마지막, 다음
  • 전, 후, 후
  • 밀리초, 초, 분, 시간, 일, 주, 월, 년, 10년, 세기/세기, 천년/천년
X.timestamp occurs before today, X.timestamp occurs last month, X.timestamp occurs <= 3 days before now

PQL 함수

다음 표는 자세한 내용을 보기 위한 추가 설명서에 대한 링크를 포함하여 지원되는 PQL 함수의 다양한 범주를 간략하게 설명합니다.

카테고리
정의
부울
PQL 내에서 부울 대수를 구현하는 데 사용됩니다. 이러한 함수에 대한 자세한 내용은 부울 함수 문서.
비교
서로 다른 PQL 요소를 비교하는 데 사용됩니다. 이러한 함수에 대한 자세한 내용은 비교 함수 문서.
배열, 목록 및 집합
배열, 목록 및 집합과 상호 작용하는 데 사용됩니다. 이러한 함수에 대한 자세한 내용은 배열, 목록 및 집합 함수 문서.
지도와 상호 작용하는 데 사용됩니다. 이러한 함수에 대한 자세한 내용은 맵 함수 문서.
문자열
문자열과 상호 작용하는 데 사용됩니다. 이러한 함수에 대한 자세한 내용은 문자열 함수 문서.
오브젝트
개체와 상호 작용하는 데 사용됩니다. 이러한 함수에 대한 자세한 내용은 객체 함수 문서.
산술
PQL 요소에서 기본 산술을 수행하는 데 사용됩니다. 이러한 함수에 대한 자세한 내용은 산술 함수 문서
집계
배열의 결과를 단일 결과로 결합하는 데 사용됩니다. 집계 함수에 대한 자세한 내용은 집계 함수 문서.
날짜 및 시간
날짜, 시간 및 날짜/시간 오브젝트와 함께 사용됩니다. 이러한 함수에 대한 자세한 내용은 날짜/시간 함수 문서.
필터
배열 내의 데이터를 필터링하는 데 사용됩니다. 이러한 함수에 대한 자세한 내용은 필터 함수 문서.
논리적 수량자
배열 내에서 조건을 어설션하는 데 사용됩니다. 자세한 내용은 논리적 수량자 문서.
기타
위의 범주에 맞지 않는 함수는 기타 함수 문서.

다음 단계

이제 를 사용하는 방법을 배웠습니다 Profile Query Language, 세그먼트 정의를 만들고 수정할 때 PQL을 사용할 수 있습니다. 세그멘테이션에 대한 자세한 내용은 세그먼테이션 개요.

recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871