설명서Experience PlatformSegmentation Service 안내서

Profile Query Language (PQL) 개요

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 사용자

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

이 안내서에서는 서식 지정 지침에 대해 설명하고 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