Estructura y elementos de las expresiones de filtro

Esta sección incluye información sobre de la estructura de las expresiones de filtro y sus elementos.

Estructura de las expresiones de filtro

La estructura general de una expresión de filtro es la siguiente:

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

Puede crear expresiones de filtro manualmente u obtener ayuda con la estructura y la sintaxis de expresiones mediante el Generador de expresiones de la consola.

Filtrar elementos de expresión

Utilice los siguientes elementos para crear expresiones de filtro:

INCLUDE o EXCLUDE

Utilice INCLUDE para limitar las recomendaciones a solo los elementos que cumplen los criterios de filtro O use EXCLUDE para eliminar todos los elementos que cumplen los criterios de filtro.

ItemID/ActionID/UserID

Use uno de estos elementos después del elemento INCLUDE o EXCLUDE. El elemento que utilice depende de si está filtrando elementos (para recomendaciones de elementos), acciones (para recomendaciones de acciones) o usuarios (para segmentos de usuarios).

WHERE

Utilice WHERE para comprobar las condiciones de los elementos, acciones o usuarios. Debe usar el elemento WHERE después de ItemID, ActionID o UserID.

AND/OR

Para encadenar varias condiciones dentro de la misma expresión de filtro, utilice AND o OR. Las condiciones encadenadas mediante AND o OR solo pueden afectar a los campos del conjunto de datos utilizados en la primera condición.

Dataset.field

Proporcione el conjunto de datos y el campo de metadatos por los que desea filtrar las recomendaciones con el formato dataset.field. Por ejemplo, para filtrar recomendaciones de elementos en función del campo de géneros del conjunto de datos de elementos, utilizaría Items.genres en su expresión de filtro.

Condición IF

Utilice una condición IF solo para comprobar las condiciones de una expresión CurrentUser y solo una vez al final de la misma. Sin embargo, puede extender una condición IF mediante AND.

CurrentUser.atributo

Para filtrar las recomendaciones de elementos en función del usuario para el que está recibiendo recomendaciones, en solo una condición IF, utilice CurrentUser y proporcione el campo de usuario. Por ejemplo, CurrentUser.AGE.

CurrentItem.atributo

Para casos de uso y recetas de elementos relacionados, utilice CurrentItem.attribute para filtrar elementos en función de un atributo del elemento que especifique en su solicitud de recomendaciones de elementos relacionados. Por ejemplo, CurrentItem.GENRE o CurrentItem.PRICE.

Puedes aplicar un filtro con el CurrentItem elemento solo si el caso de uso de tu dominio o la receta personalizada generan recomendaciones de artículos relacionados, como la receta de artículos similares o el caso de uso del dominio More Like X. La primera vez que cree un filtro con un elemento CurrentItem, la creación del filtro tardará unos minutos. Si lo utilizas AWS KMS para cifrar, la creación del filtro puede tardar hasta 15 minutos.

IN/NOT IN

Utilice IN o NOT IN como operadores de comparación para filtrar en función de la coincidencia (o no coincidencia) de uno o más valores de cadena. Amazon Personalize filtra solo las cadenas exactas.

Operadores de comparación

Utilice =, <, <=, >, >= y! = operadores para comprobar la igualdad de los datos numéricos, incluidos los datos introducidos en un parámetro marcador de posición.

Carácter de asterisco (*)

Use * para incluir o excluir interacciones de todo tipo. Use * solo para filtrar expresiones que empleen el campo EVENT_TYPE de un conjunto de datos de Interactions.

Separador vertical

Utilice el separador vertical (|) para encadenar varias expresiones. Para obtener más información, consulte Combinación de varias expresiones.

Parámetros

En el caso de las expresiones que utilizan operadores de comparación o el operador IN, utilice el signo de dólar ($) y un nombre de parámetro para añadir un parámetro de marcador de posición como valor. Por ejemplo, $GENRES. En este ejemplo, cuando reciba recomendaciones, especifica los géneros por los que desea filtrar.

nota

El nombre de un parámetro se define al añadirlo a una expresión. El nombre del parámetro no tiene que coincidir con el nombre del campo. Recomendamos que utilice un nombre de parámetro que sea similar al nombre del campo y sencillo de recordar. Utilice el nombre del parámetro (distingue entre mayúsculas y minúsculas) al aplicar el filtro a las solicitudes de recomendaciones. Para ver un ejemplo que muestra cómo aplicar un filtro con parámetros de marcador de posición cuando se utiliza el AWS SDK, consulte. Aplicar un filtro (AWS SDK)