Profile Query Language Información general de (PQL)

Profile Query Language (PQL) es un Experience Data Model Lenguaje de consulta compatible con (XDM) diseñado para admitir la definición y ejecución de consultas de segmentación para Real-Time Customer Profile datos.

Esta guía proporciona información general sobre el PQL, e incluye directrices de formato y expresiones PQL de ejemplo.

Formato de consulta PQL

Las consultas PQL tienen la siguiente firma:

({INPUT_PARAMETER_1}, {INPUT_PARAMETER_2}, ...) => {RESULT_TYPE}

El parámetro de entrada puede ser un primitivo simple, como un booleano o una cadena, o un tipo más complejo, como un objeto, una matriz o un mapa.

Existen tres formas diferentes de hacer referencia a los parámetros de entrada dentro del cuerpo de una expresión PQL:

Referencia implícita al primer parámetro

En el ejemplo siguiente, como el primer parámetro siempre está en contexto, una referencia de propiedad (homeAddress) se puede hacer directamente a ella.

homeAddress.stateProvince = workAddress.stateProvince

Referencia explícita al primer parámetro

En el ejemplo siguiente, $1 hace referencia al primer parámetro. Como resultado, $2 haría referencia al segundo parámetro, etc.

$1.homeAddress.stateProvince = $1.homeAddress.stateProvince

Uso de variables con nombre, usando la notación lambda

En el ejemplo siguiente, Profile es un nombre de variable que puede elegir el autor de la consulta.

(Profile) => Profile.homeAddress.stateProvince = Profile.workAddress.stateProvince

Literales PQL

PQL proporciona compatibilidad con los siguientes tipos literales:

Literal	Definición	Ejemplo
Cadena	Un tipo de datos compuesto por caracteres entre comillas dobles.	`"pizza"`, `"jobs"`, `"antidisestablishmentarianism"`
Booleano	Un tipo de datos que puede ser verdadero o falso.	`true`, `false`
Número entero	Un tipo de datos que representa un número entero. Puede ser positivo, negativo o cero.	`-201`, `0`, `412`
Doble	Un tipo de datos que represente cualquier número real. Puede ser positivo, negativo o cero.	`-51.24`, `3.14`, `0.6942058`
Fecha	Un tipo de datos que se puede utilizar para crear fechas basadas en el año, el mes y el día como parámetros enteros. Tiene el formato `date(year, month, day)`	`date(2020, 3, 14)`
Matriz	Un tipo de datos que se comprende como un grupo de otros valores literales. Utiliza corchetes para agrupar y comas para delimitar entre distintos valores. Nota: No puede acceder directamente a las propiedades de los elementos de una matriz. Por lo tanto, si necesita acceder a una propiedad dentro de una matriz, el método admitido es `select X from array where X.item = ...`. PQL reserva la palabra `xEvent` para hacer referencia a una matriz de eventos de experiencia vinculados a un perfil.	`[1, 4, 7]`, `["US", "CA"]`
Referencias de tiempo relativo	Palabras reservadas que se pueden utilizar para formar referencias de intervalo de tiempo y marca de tiempo. ahora, hoy, ayer, mañana esto, lo último, lo siguiente antes, después y desde milisegundo(s), segundo(s), minuto(s), hora(s), día(s), semana(s), mes(es), año(s), década(s), siglo/siglos, milenio/milenio	`X.timestamp occurs before today`, `X.timestamp occurs last month`, `X.timestamp occurs <= 3 days before now`

Funciones PQL

La siguiente tabla describe las diferentes categorías de funciones PQL admitidas, incluidos los vínculos a documentación adicional para obtener más información.

Categoría	Definición
Booleano	Se utiliza para implementar álgebra booleana dentro de PQL. Encontrará más información sobre estas funciones en la documento de funciones booleanas.
Comparación	Se utiliza para comparar entre diferentes elementos PQL. Encontrará más información sobre estas funciones en la documento de funciones de comparación.
Matriz, lista y conjunto	Se utiliza para interactuar con matrices, listas y conjuntos. Encontrará más información sobre estas funciones en la documento de funciones de matriz, lista y conjunto.
Mapa	Se utiliza para interactuar con mapas. Encontrará más información sobre estas funciones en la documento de funciones de mapa.
Cadena	Se utiliza para interactuar con cadenas. Encontrará más información sobre estas funciones en la documento de funciones de cadena.
Objeto	Se utiliza para interactuar con objetos. Encontrará más información sobre estas funciones en la documento de funciones de objeto.
Aritmética	Se utiliza para realizar operaciones aritméticas básicas en elementos PQL. Encontrará más información sobre estas funciones en la documento de funciones aritméticas
Agregación	Se utiliza para combinar los resultados de una matriz en un resultado singular. Puede encontrar más información sobre las funciones de agregación en la documento de funciones de agregación.
Fecha y hora	Se utiliza junto con los objetos fecha, hora y fecha y hora. Encontrará más información sobre estas funciones en la documento de funciones de fecha y hora.
Filtro	Se utiliza para filtrar datos dentro de matrices. Encontrará más información sobre estas funciones en la documento de funciones de filtro.
Cuantificadores lógicos	Se utiliza para afirmar condiciones dentro de una matriz. Encontrará más información en la documento de cuantificadores lógicos.
Varios	Las funciones que no se ajustan a ninguna de las categorías anteriores se encuentran en la documento de funciones varias.

Pasos siguientes

Ahora que ha aprendido a utilizar Profile Query Language, puede utilizar PQL al crear y modificar segmentos. Para obtener más información sobre la segmentación, lea la resumen de segmentación.