As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Estrutura e elementos das expressões de filtro
Esta seção inclui informações sobre a estrutura de expressões de filtro e os respectivos elementos.
Estrutura das expressões de filtro
A estrutura geral de uma expressão de filtro é a seguinte:
EXCLUDE/INCLUDE ItemID/ActionID/UserID WHEREdataset type.fieldIN/NOT IN (value/parameter)
Você pode criar manualmente expressões de filtro ou obter ajuda com a sintaxe e a estrutura da expressão usando o construtor de expressões no console.
Filtrar elementos de expressão
Use os seguintes elementos para criar expressões de filtro:
- INCLUIR ou EXCLUIR
-
Use
INCLUDEpara limitar as recomendações somente aos itens que atendam aos critérios do filtro OU useEXCLUDEpara remover todos os itens que atendem aos critérios do filtro. - ItemID/ActionID/UserID
-
Use um desses elementos após o elemento
INCLUDEouEXCLUDE. O elemento usado está condicionado ao tipo de dados filtrados, ou seja, itens (para recomendações de itens), ações (para recomendações de ações) ou usuários (para segmentos de usuários). - WHERE
-
Use
WHEREpara conferir as condições de itens, ações ou usuários. É necessário usar o elementoWHEREapósItemID,ActionIDouUserID. - E/OU
-
Para encadear várias condições na mesma expressão de filtro, use
ANDouOR. Condições encadeadas comANDouORpodem afetar os campos do conjunto de dados usado na primeira condição. - Dataset.field
-
Forneça o conjunto de dados e o campo de metadados pelos quais você deseja filtrar as recomendações no formato
dataset.field. Por exemplo, para filtrar recomendações de itens com base no campo de gêneros no conjunto de dados de itens, você usará Items.genres na expressão de filtro. - Condição IF
-
Use uma condição
IFsomente para verificar as condições deCurrentUsere somente uma vez no final de uma expressão. No entanto, você pode estender uma condiçãoIFusandoAND. - CurrentUser.atributo
-
Para filtrar as recomendações de itens com base no usuário para o qual você está recebendo recomendações, somente em uma condição IF, use
CurrentUsere forneça o campo do usuário. Por exemplo, .CurrentUser.AGE - CurrentItem.atributo
-
Somente para fórmulas de itens relacionados e casos de uso, use
CurrentItem.attributepara filtrar itens com base em um atributo do item especificado na sua solicitação de recomendações de itens relacionados. Por exemplo,CurrentItem.GENREouCurrentItem.PRICE.Você pode aplicar um filtro com o CurrentItem elemento somente se seu caso de uso de domínio ou receita personalizada gerar recomendações de itens relacionados, como a receita de itens semelhantes ou o caso de uso do domínio More Like X. Na primeira vez que você cria um filtro com um elemento
CurrentItem, a criação do filtro pode levar alguns minutos. Se você usa AWS KMS para criptografia, a criação do filtro pode levar até 15 minutos. - IN/NOT IN
-
Use
INouNOT INcomo operadores de comparação para filtrar com base na correspondência (ou não correspondência) de um ou mais valores de string. O Amazon Personalize filtra somente em strings exatas. - Operadores de comparação
-
Use operadores =, <, <=, >, >= e != para testar dados numéricos, incluindo dados transmitidos em um parâmetro de espaço reservado, para verificar a igualdade.
- Caractere asterisco (*)
-
Use
*para incluir ou excluir interações de todos os tipos. Use*somente para expressões de filtro que usam o campoEVENT_TYPEde um conjunto de dados deInteractions. - Separador de pipes
-
Use o separador de pipes (
|) para encadear várias expressões. Para obter mais informações, consulte Como combinar várias expressões. - Parâmetros
-
Para expressões que usam operadores de comparação ou o operador
IN, use o cifrão ($) e um nome de parâmetro para adicionar um parâmetro de espaço reservado como um valor. Por exemplo, .$GENRESNeste exemplo, ao receber recomendações, você fornece o gênero ou gêneros pelos quais filtrar.nota
Você define um nome de parâmetro ao adicioná-lo a uma expressão. O nome do parâmetro não precisa corresponder ao nome do campo. Recomendamos que você use um nome de parâmetro semelhante ao nome do campo e que seja fácil de lembrar. Você usa o nome do parâmetro (com distinção entre maiúsculas e minúsculas) ao aplicar o filtro às solicitações de recomendações. Para ver um exemplo que mostra como aplicar um filtro com parâmetros de espaço reservado ao usar os AWS SDKS, consulte. Como aplicar um filtro (AWS SDKs)