필터 표현식 구조 및 요소 - Personalize

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

필터 표현식 구조 및 요소

이 섹션에는 필터 표현식의 구조와 요소에 대한 정보가 포함되어 있습니다.

필터 표현식 구조

필터 표현식의 일반적인 구조는 다음과 같습니다.

EXCLUDE/INCLUDE ItemID/ActionID/UserID WHERE dataset type.field IN/NOT IN (value/parameter)

수동으로 필터 표현식을 만들거나 콘솔의 표현식 빌더를 사용하여 표현식 구문 및 구조에 대한 도움을 받을 수 있습니다.

필터 표현식 요소

필터 표현식을 만들려면 다음 요소를 사용합니다.

INCLUDE 또는 EXCLUDE

필터 기준을 충족하는 항목으로만 추천을 제한하려면 INCLUDE를 사용하고 또는 필터 기준을 충족하는 모든 항목을 제거하려면 EXCLUDE를 사용합니다.

ItemID/ActionID/UserID

INCLUDE 또는 EXCLUDE 요소 뒤에 다음 요소 중 하나를 사용합니다. 항목(항목 추천용), 작업(작업 추천용) 또는 사용자(사용자 세그먼트용)를 필터링하는지에 따라 사용하는 요소가 달라집니다.

WHERE

WHERE는 항목, 작업 또는 사용자의 조건을 확인하는 데 사용합니다. WHERE 요소는 ItemID, ActionID 또는 UserID 뒤에 사용해야 합니다.

AND/OR

동일한 필터 표현식 내에서 여러 조건을 함께 연결하려면 AND또는 OR를 사용합니다. AND 또는 OR를 사용하여 서로 연결된 조건은 첫 번째 조건에 사용된 데이터세트의 필드에만 영향을 줄 수 있습니다.

Dataset.field

추천 필터링 기준으로 사용할 데이터세트와 메타데이터 필드를 dataset.field의 형식으로 제공합니다. 예를 들어, 항목 데이터 세트의 장르 필드를 기반으로 항목 상호 작용을 필터링하려면 필터 표현식에 Items.genres를 사용합니다.

IF 조건

IF 조건은 CurrentUser의 조건을 확인할 때만 사용하고 표현식 끝에서 한 번만 사용합니다. 하지만 AND를 사용하여 IF조건을 확장할 수 있습니다.

CurrentUser.속성

추천을 받는 사용자를 기준으로 항목 추천을 필터링하려면 IF 조건에서만 CurrentUser를 사용하고 사용자 필드를 제공합니다. 예: CurrentUser.AGE.

CurrentItem.속성

관련 항목 레시피 및 사용 사례의 경우에만 관련 항목 추천 요청에서 지정한 항목의 속성을 기준으로 항목을 필터링하려면 CurrentItem.attribute를 사용합니다. 예: CurrentItem.GENRE또는 CurrentItem.PRICE.

도메인 사용 사례 또는 사용자 지정 레시피가 유사 항목 레시피 또는 유사 X 도메인 사용 사례와 같은 관련 항목 권장 사항을 생성하는 경우에만 CurrentItem 요소와 함께 필터를 적용할 수 있습니다. CurrentItem 요소를 사용하여 필터를 처음 만들 때는 필터 생성에 몇 분 정도 걸릴 수 있습니다. 를 암호화 AWS KMS 에 사용하는 경우 필터 생성에 최대 15분이 걸릴 수 있습니다.

IN/NOTIN

하나 이상의 문자열 값이 일치하거나 일치하지 않는 것을 기준으로 필터링하려면 IN또는 NOT IN를 비교 연산자로 사용합니다. Personalize는 정확한 문자열만 필터링합니다.

비교 연산자

=, <, <=, >, >= 및 != 연산자를 사용하여 자리 표시자 파라미터에 전달된 데이터를 포함한 숫자 데이터를 동등하게 테스트합니다.

별표(*) 문자

*는 모든 유형의 상호작용을 포함하거나 제외하는 데 사용합니다. *Interactions데이터세트의 EVENT_TYPE필드를 사용하는 필터 표현식에만 사용합니다.

파이프 구분자

파이프 구분자(|)를 사용하여 여러 표현식을 연결할 수 있습니다. 자세한 내용은 여러 표현식 결합단원을 참조하세요.

파라미터

비교 연산자 또는 IN연산자를 사용하는 표현식의 경우 자리 표시자 파라미터를 값으로 추가하려면 달러 기호($)와 파라미터 이름을 사용합니다. 예: $GENRES. 이 예제에서는 추천을 받을 때 필터링 기준으로 삼을 장르를 입력합니다.

참고

표현식에 파라미터를 추가할 때 파라미터 이름을 정의합니다. 파라미터 이름이 필드 이름과 일치하지 않아도 됩니다. 필드 이름과 비슷하고 기억하기 쉬운 파라미터 이름을 사용하는 것이 좋습니다. 추천 요청에 필터를 적용할 때 파라미터 이름(대소문자 구분)을 사용합니다. 를 사용할 때 자리 표시자 파라미터가 있는 필터를 적용하는 방법을 보여주는 예제는 섹션을 AWS SDKS참조하세요필터 적용(AWS SDKs).