Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Structure et éléments de l'expression du filtre
Cette section contient des informations sur la structure des expressions de filtre et de leurs éléments.
Structure d'expression du filtre
La structure générale d'une expression de filtre est la suivante :
EXCLUDE/INCLUDE ItemID/ActionID/UserID WHEREdataset type.fieldIN/NOT IN (value/parameter)
Vous pouvez créer manuellement des expressions de filtre ou obtenir de l'aide concernant la syntaxe et la structure des expressions à l'aide du générateur d'expressions de la console.
Filtrer les éléments d'expression
Utilisez les éléments suivants pour créer des expressions de filtre :
- INCLURE ou EXCLURE
-
INCLUDEÀ utiliser pour limiter les recommandations aux seuls éléments qui répondent aux critères du filtre OUEXCLUDEpour supprimer tous les éléments qui répondent aux critères du filtre. - ItemID/ActionID/UserID
-
Utilisez l'un de ces éléments après l'
EXCLUDEélémentINCLUDEou. L'élément que vous utilisez varie selon que vous filtrez les éléments (pour les recommandations d'éléments), les actions (pour les recommandations d'actions) ou les utilisateurs (pour les segments d'utilisateurs). - WHERE
-
WHEREÀ utiliser pour vérifier les conditions des éléments, des actions ou des utilisateurs. Vous devez utiliser l'WHEREélément après leItemIDActionID, ouUserID. - ET/OU
-
Pour enchaîner plusieurs conditions au sein d'une même expression de filtre, utilisez
ANDouOR. Les conditions sont enchaînées en utilisantANDou neORpeuvent affecter que les champs du jeu de données utilisé dans la première condition. - Dataset.field
-
Indiquez le jeu de données et le champ de métadonnées selon lesquels vous souhaitez filtrer les recommandations
dataset.fieldformat. Par exemple, pour filtrer les recommandations d'articles en fonction du champ genres de votre jeu de données Items, vous devez utiliser Items.Genres dans votre expression de filtre. - État IF
-
N'utilisez une
IFcondition que pour vérifier les conditions de laCurrentUseret une seule fois à la fin d'une expression. Cependant, vous pouvez étendre uneIFcondition en utilisantAND. - CurrentUser.attribut
-
Pour filtrer les recommandations d'articles en fonction de l'utilisateur pour lequel vous recevez des recommandations, dans une condition IF uniquement, utilisez
CurrentUseret fournissez le champ utilisateur. Par exemple,CurrentUser.AGE. - CurrentItem.attribut
-
Pour les articles connexes, les recettes et les cas d'utilisation uniquement, utilisez
CurrentItem.attributepour filtrer les articles en fonction d'un attribut de l'article que vous spécifiez dans votre demande de recommandations d'articles connexes. Par exemple,CurrentItem.GENREouCurrentItem.PRICE.Vous ne pouvez appliquer un filtre à l' CurrentItem élément que si votre cas d'utilisation de domaine ou votre recette personnalisée génère des recommandations d'articles connexes, telles que la recette Similar-Items ou le cas d'utilisation du domaine More Like X. La première fois que vous créez un filtre avec un
CurrentItemélément, la création du filtre peut prendre quelques minutes. Si vous l'utilisez AWS KMS pour le chiffrement, la création du filtre peut prendre jusqu'à 15 minutes. - DANS/PAS DEDANS
-
Utilisez
INouNOT INcomme opérateur de comparaison pour filtrer en fonction de la correspondance (ou de la non-correspondance) d'une ou de plusieurs valeurs de chaîne. Amazon Personalize filtre uniquement sur des chaînes exactes. - Opérateurs de comparaison
-
Utilisez =, <, <=, >, >= et ! = opérateurs pour tester l'égalité des données numériques, y compris les données transmises dans un paramètre d'espace réservé.
- Caractère astérisque (*)
-
*À utiliser pour inclure ou exclure des interactions de tous types. À utiliser*uniquement pour les expressions de filtre qui utilisent leEVENT_TYPEchamp d'unInteractionsensemble de données. - Séparateur de tuyaux
-
Utilisez le séparateur de tubes (
|) pour enchaîner plusieurs expressions. Pour de plus amples informations, veuillez consulter Combinaison de plusieurs expressions. - Paramètres
-
Pour les expressions qui utilisent des opérateurs de comparaison ou l'
INopérateur, utilisez le signe dollar ($) et un nom de paramètre pour ajouter un paramètre d'espace réservé en tant que valeur. Par exemple,$GENRES. Dans cet exemple, lorsque vous recevez des recommandations, vous indiquez le ou les genres à filtrer.Note
Vous définissez un nom de paramètre lorsque vous l'ajoutez à une expression. Le nom du paramètre ne doit pas nécessairement correspondre au nom du champ. Nous vous recommandons d'utiliser un nom de paramètre similaire au nom du champ et facile à mémoriser. Vous utilisez le nom du paramètre (en distinguant majuscules et minuscules) lorsque vous appliquez le filtre aux demandes de recommandations. Pour un exemple montrant comment appliquer un filtre avec des paramètres d'espace réservé lors de l'utilisation des AWS SDK, voir. Appliquer un filtre (AWS SDKs)