Ejemplos de consultas query-examples
En esta sección se enumeran varios ejemplos de uso común para consultar los eventos de pasos de Recorrido en Data Lake.
Asegúrese de que los campos utilizados en las consultas tengan valores asociados en el esquema correspondiente.
- id: único para todas las entradas de evento de paso. Dos eventos de paso diferentes no pueden tener el mismo ID.
- instanceId: instanceID es el mismo para todos los eventos de paso asociados a un perfil dentro de una ejecución de recorrido. Si un perfil vuelve a entrar en la recorrido, se utiliza un instanceId diferente. Este nuevo instanceId es el mismo para todos los eventos de paso de la instancia reintroducida (de inicio a fin).
- profileID: la identidad del perfil correspondiente al área de nombres de recorrido.
| note note |
|---|
| NOTE |
| Para solucionar problemas, recomendamos utilizar journeyVersionID en lugar de journeyVersionName al consultar recorridos. Obtenga más información acerca de los atributos de propiedades de recorrido en esta sección. |
Casos de uso básicos/consultas comunes common-queries
Esta consulta proporciona el número de perfiles distintos que ingresaron al recorrido determinado en el lapso de tiempo determinado.
Consulta de lago de datos
| code language-sql |
|---|
|
Aprenda a solucionar problemas de tipos de eventos descartados en recorrido_step_events.
Esta consulta devuelve el conjunto de reglas y la información de reglas rechazados cuando se impide que un perfil entre en un recorrido debido a reglas de límite o de idoneidad.
Ejemplo
| code language-sql |
|---|
|
Esta consulta cuenta los distintos perfiles que experimentaron errores en cada nodo de un recorrido, agrupados por nombre de nodo. Incluye todos los tipos de errores de ejecución de acciones y errores de recuperación.
Consulta de lago de datos
| code language-sql |
|---|
|
Esta consulta cuenta el número total de eventos que se descartaron de un recorrido. Filtra varios códigos de eventos de descarte, incluidos errores de trabajos de exportación de segmentos, descartes de Dispatcher y descartes de equipos de estado.
Consulta de lago de datos
| code language-sql |
|---|
|
Esta consulta devuelve todos los eventos de paso y los eventos de servicio del perfil y el recorrido dados durante el tiempo especificado en orden cronológico.
Consulta de lago de datos
| code language-sql |
|---|
|
Estas consultas se pueden utilizar, por ejemplo, para calcular el tiempo empleado en una actividad de espera. Esto le permite asegurarse de que la actividad de espera esté configurada correctamente.
Consulta de lago de datos
| code language-sql |
|---|
|
Consulta de lago de datos
| code language-sql |
|---|
|
El conjunto de datos Eventos de paso de Recorrido contiene todos los stepEvents y serviceEvents. stepEvents se utiliza en los informes, ya que se relacionan con actividades (eventos, acciones, etc.) de perfiles en un recorrido. serviceEvents se almacenan en el mismo conjunto de datos e indican información adicional para fines de depuración, por ejemplo el motivo de un descarte de evento de experiencia.
Este es un ejemplo de consulta para comprobar los detalles de un serviceEvent:
Consulta de lago de datos
| code language-sql |
|---|
|
Errores de mensaje/acción message-action-errors
| accordion | ||||
|---|---|---|---|---|
| Lista de cada error encontrado en los recorridos | ||||
|
Esta consulta le permite enumerar cada error encontrado en recorridos al ejecutar un mensaje o una acción. Consulta de lago de datos
Ejemplo
Esta consulta devuelve todos los diferentes errores que se han producido al ejecutar una acción en un recorrido, junto con el recuento de cuántas veces se han producido. |
Consultas basadas en perfiles profile-based-queries
Esta consulta comprueba si un perfil específico ha introducido un recorrido contando los eventos asociados con esa combinación de perfil y recorrido.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
El resultado debe ser mayor que 0. Esta consulta devuelve el número exacto de veces que un perfil ha introducido un recorrido.
Método 1: si el nombre del mensaje no es único en el recorrido (se utiliza en varios lugares).
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
El resultado debe ser mayor que 0. Esta consulta solo indica si la acción del mensaje se ejecutó correctamente en el lado del recorrido.
Método 2: si el nombre del mensaje es único en el recorrido.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
La consulta devuelve la lista de todos los mensajes junto con su recuento invocado para el perfil seleccionado.
Esta consulta recupera todas las acciones de mensaje ejecutadas correctamente para un perfil específico en los últimos 30 días, agrupadas por nombre de mensaje.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
La consulta devuelve la lista de todos los mensajes junto con su recuento invocado para el perfil seleccionado.
Esta consulta devuelve todos los recorridos introducidos por un perfil específico en los últimos 30 días, junto con el recuento de entradas de cada recorrido.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
La consulta devuelve la lista de todos los nombres de recorrido junto con el número de veces que el perfil consultado ha introducido el recorrido.
Esta consulta proporciona un desglose diario del número de perfiles distintos que han introducido un recorrido durante un periodo de tiempo especificado.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
La consulta devuelve, para el periodo definido, el número de perfiles que ingresaron al recorrido cada día. Si un perfil se introduce mediante varias identidades, se cuenta dos veces. Si la reentrada está activada, el recuento de perfiles puede duplicarse en días diferentes si se reingresa al recorrido en un día diferente.
Aprenda a solucionar problemas de tipos de eventos descartados en recorrido_step_events.
Consultas relacionadas con la audiencia de lectura read-segment-queries
Esta consulta calcula la duración de un trabajo de exportación de audiencia buscando la diferencia horaria entre el momento en que el trabajo se puso en cola y el momento en que finalizó.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
La consulta devuelve la diferencia de tiempo, en minutos, entre el momento en que el trabajo de exportación de audiencia se puso en cola y el momento en que finalmente finalizó.
Esta consulta cuenta el número de perfiles distintos que se descartaron debido a errores de duplicación de instancias durante la actividad Leer audiencia.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
La consulta devuelve todos los ID de perfil que el recorrido descartó porque eran duplicados.
Esta consulta devuelve el recuento de perfiles que se descartaron porque tenían un área de nombres no válida o faltaba identidad para el área de nombres requerida.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
La consulta devuelve todos los ID de perfil que descartó la recorrido porque tenían un área de nombres no válida o no tenían identidad para ese área de nombres.
Esta consulta cuenta los perfiles que se descartaron porque les faltaba un mapa de identidad necesario para la ejecución del recorrido.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
La consulta devuelve todos los ID de perfil que el recorrido descartó porque faltaba el mapa de identidad.
Esta consulta identifica los perfiles que se descartaron cuando el recorrido se estaba ejecutando en modo de prueba, pero el perfil no tenía el atributo testProfile establecido en true.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
La consulta devuelve todos los ID de perfil descartados por la recorrido porque el trabajo de exportación se ejecutó en modo de prueba pero el perfil no tenía el atributo testProfile establecido en true.
Esta consulta devuelve el recuento de perfiles que se descartaron debido a errores internos del sistema durante la ejecución del recorrido.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
La consulta devuelve todos los ID de perfil que el recorrido descartó debido a algún error interno.
Esta consulta proporciona información general completa sobre la actividad Leer audiencia, incluidos detalles del trabajo de exportación de segmentos, códigos de evento, estados y recuentos de perfiles para todas las etapas del proceso de exportación de audiencias.
Consulta de lago de datos
| code language-sql |
|---|
|
Devuelve todos los eventos de servicio relacionados con la versión de recorrido determinada. Podemos seguir la cadena de operaciones:
- creación de temas
- creación de trabajos de exportación
- finalización del trabajo de exportación (con métricas en perfiles exportados)
- finalización del procesamiento del trabajador
También podemos detectar problemas como:
- errores en la creación de trabajos de exportación de temas (incluidos los tiempos de espera en las llamadas de API de exportación de audiencia)
- trabajos de exportación que se pueden atascar (en caso de que, para una versión de recorrido determinada, no tengamos ningún evento relacionado con la finalización del trabajo de exportación)
- problemas con los trabajadores, si hemos recibido el evento de finalización del trabajo de exportación pero no el de finalización del procesamiento del trabajador
IMPORTANTE: si esta consulta no devuelve ningún evento, puede deberse a uno de los siguientes motivos:
- la versión del recorrido no ha alcanzado la programación
- si se supone que la versión de recorrido tiene que almacenar en déclencheur el trabajo de exportación llamando al orquestador, algo salió mal en el flujo ascendente: problema en la implementación de recorrido, evento empresarial o problema con el programador.
Esta consulta filtra códigos de evento de error específicos relacionados con errores de Leer audiencia, como errores de creación de temas, errores de llamadas de API, tiempos de espera y trabajos de exportación con errores.
Consulta de lago de datos
| code language-sql |
|---|
|
Esta consulta recupera el estado de procesamiento de los trabajos de exportación de audiencia, mostrando si se realizaron correctamente o no, junto con las métricas de exportación de perfiles.
Consulta de lago de datos
| code language-sql |
|---|
|
Si no se devuelve ningún registro, significa que:
- se ha producido un error durante la creación del tema o del trabajo de exportación
- el trabajo de exportación aún se está ejecutando
Esta consulta combina recuentos de perfiles descartados con métricas de trabajos de exportación para proporcionar una vista completa del rendimiento de exportación de la audiencia para cada trabajo de exportación individual.
Consulta de lago de datos
| code language-sql |
|---|
|
Esta consulta agrega métricas generales en todos los trabajos de exportación para una versión de recorrido determinada, lo cual resulta útil para recorridos recurrentes o recorridos activados por eventos empresariales con reutilización de temas.
Consulta de lago de datos
| code language-sql |
|---|
|
Esta consulta es diferente a la anterior.
Devuelve las métricas generales de una versión de recorrido determinada, independientemente de los trabajos que se puedan haber ejecutado para ella (en caso de recorridos recurrentes, los eventos empresariales activados aprovechan la reutilización del tema).
Consultas relacionadas con la calificación de audiencias segment-qualification-queries
Esta consulta identifica los perfiles que se descartaron porque su estado de realización de audiencia no coincide con la configuración de Calificación de audiencias del recorrido (por ejemplo, configurado para "entra" pero el perfil "sale").
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
Esta consulta devuelve todos los ID de perfil que la versión de recorrido descartó debido a una comprensión incorrecta de la audiencia.
Esta consulta recupera todas las clasificaciones de audiencias o eventos externos que se descartaron para un perfil específico debido a errores de servicio interno.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
Esta consulta devuelve todos los eventos (eventos externos / eventos de calificación de audiencia) que se descartaron debido a cualquier otro motivo para un perfil.
Consultas basadas en eventos event-based-queries
Esta consulta cuenta el número de veces que un recorrido recibió un evento empresarial, agrupado por fecha, en un lapso de tiempo especificado.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
Esta consulta identifica cuándo se descartó un evento externo para un perfil específico porque no había ningún recorrido activo o coincidente configurado para recibir ese evento.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
Aprenda a solucionar problemas de tipos de eventos descartados en recorrido_step_events.
Esta consulta recupera eventos externos que se descartaron para un perfil específico debido a errores de servicio interno, junto con el ID de evento y el código de error.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
Aprenda a solucionar problemas de tipos de eventos descartados en recorrido_step_events.
Esta consulta agrega todos los eventos descartados por el equipo de estado de recorrido, agrupados por código de error para ayudar a identificar los motivos más comunes de descartes.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
Aprenda a solucionar problemas de tipos de eventos descartados en recorrido_step_events.
Esta consulta identifica todos los eventos que se descartaron porque un perfil intentó volver a introducir un recorrido cuando no se permitía la reentrada en la configuración del recorrido.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
Aprenda a solucionar problemas de tipos de eventos descartados en recorrido_step_events.
Consultas comunes basadas en recorridos journey-based-queries
Esta consulta devuelve un recuento diario de versiones de recorrido únicas que tuvieron actividad, lo que le ayuda a comprender los patrones de ejecución de recorrido a lo largo del tiempo.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
La consulta devuelve, para el periodo definido, el recuento de recorridos únicos que se activaron cada día. Un solo recorrido que se active en varios días se contará una vez al día.
Consultas en instancias de recorrido journey-instances-queries
Esta consulta utiliza expresiones de tabla comunes (CTE) para identificar perfiles que están esperando actualmente en un nodo específico de un recorrido mediante la búsqueda de perfiles que han pasado a través del nodo, pero que aún no han procedido a los nodos siguientes.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
Esta consulta cuenta las instancias de recorrido que salieron durante un período de tiempo especificado, incluidas las salidas debido a errores de finalización, errores, tiempos de espera o errores de límite.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
Esta consulta proporciona un desglose detallado de las salidas de recorrido, mostrando el nombre del nodo y el estado de salida de cada instancia de salida para ayudar a identificar dónde y por qué los perfiles abandonaron la recorrido.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
Consultas relacionadas con las métricas de rendimiento de Acción personalizada query-custom-action
Esta consulta proporciona métricas de rendimiento para acciones HTTP personalizadas, incluido el total de llamadas, las llamadas correctas, los recuentos de errores por tipo (4xx, 5xx, tiempos de espera, límite) y el rendimiento en solicitudes por segundo para cada extremo.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
Esta consulta proporciona las mismas métricas de rendimiento que la consulta anterior, pero está organizada como una serie temporal, y muestra cómo el rendimiento de los extremos varía con el tiempo con la granularidad minuto a minuto.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
Esta consulta calcula los percentiles de tiempo de respuesta para los extremos de acción personalizados, lo que le ayuda a comprender la distribución de latencia e identificar periféricos de rendimiento con umbrales de percentil diferentes.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
Esta consulta proporciona percentiles de latencia organizados como una serie temporal, lo que le permite realizar un seguimiento de cómo cambian los tiempos de respuesta de los extremos con el paso del tiempo en diferentes niveles de percentil.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
Esta consulta analiza los tiempos de espera de cola para puntos de conexión restringidos, mostrando los tiempos de espera de los percentiles 50 y 95 para ayudarle a comprender el impacto de la restricción en sus acciones personalizadas.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
Esta consulta proporciona percentiles de tiempo de espera de cola como una serie temporal, lo que le permite supervisar cómo afecta la restricción a los tiempos de espera con el paso del tiempo para cada extremo.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|
Esta consulta proporciona un desglose detallado de los errores de un extremo específico, agrupados por tipo de error y código de error, incluida la información sobre los intentos de reintento.
Consulta de lago de datos
| code language-sql |
|---|
|
Ejemplo
| code language-sql |
|---|
|