필터 표현식 구조 및 요소

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

필터 표현식 구조

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

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.attribute

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

CurrentItem. 속성

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

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

IN/NOT IN

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

비교 연산자

=, <, <=, >, >=,! 를 사용하십시오. = 자리 표시자 매개 변수로 전달된 데이터를 비롯한 수치 데이터가 같은지 테스트하는 연산자입니다.

별표(*) 문자

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

파이프 구분자

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

파라미터

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

참고

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