查询示例 query-examples
本节列出了在数据湖中查询历程步骤事件的几个常用示例。
确保在查询中使用的字段在相应架构中具有关联值。
- id:对于所有步骤事件条目均唯一。 两个不同的步骤事件不能具有相同的ID。
- instanceId:对于历程执行中与配置文件关联的所有步骤事件,instanceID是相同的。 如果用户档案重新进入历程,将使用其他instanceId。 对于重新输入的实例的所有步骤事件(从开始到结束),此新instanceId将相同。
- profileID:与历程命名空间对应的用户档案标识。
| note note |
|---|
| NOTE |
| 出于故障诊断目的,我们建议在查询历程时使用journeyVersionID,而不是journeyVersionName。 在本节中了解有关历程属性的更多信息。 |
基本用例/常见查询 common-queries
此查询提供在给定时间范围内进入给定历程的不同用户档案的数量。
数据湖查询
| code language-sql |
|---|
|
了解如何对journey_step_events中丢弃的事件类型进行故障排除。
当配置文件由于上限或资格规则而无法进入历程时,此查询返回被拒绝的规则集和规则信息。
示例
| code language-sql |
|---|
|
此查询按节点名称分组计算历程每个节点遇到错误的不同用户档案。 其中包括所有类型的操作执行错误和获取错误。
数据湖查询
| code language-sql |
|---|
|
此查询计算从历程放弃的事件总数。 它会筛选各种放弃事件代码,包括区段导出作业错误、调度程序放弃和状态机放弃。
数据湖查询
| code language-sql |
|---|
|
此查询按时间顺序返回给定用户档案和历程在指定时间的所有步骤事件和服务事件。
数据湖查询
| code language-sql |
|---|
|
例如,可以使用这些查询来估计等待活动所花费的时间。 这允许您确保等待活动配置正确。
数据湖查询
| code language-sql |
|---|
|
数据湖查询
| code language-sql |
|---|
|
历程步骤事件数据集包含所有stepEvents和serviceEvents。 stepEvents在报告中使用,因为它们与历程中用户档案的活动(事件、操作等)相关。 serviceEvents存储在同一数据集中,它们指示额外的调试信息,例如体验事件放弃的原因。
以下是检查serviceEvent详细信息的查询示例:
数据湖查询
| code language-sql |
|---|
|
消息/操作错误 message-action-errors
| accordion | ||||
|---|---|---|---|---|
| 历程中遇到的每个错误的列表 | ||||
|
此查询允许您列出执行消息/操作时在历程中遇到的每个错误。 数据湖查询
示例
此查询返回在历程中执行操作时发生的所有不同错误以及发生次数。 |
基于用户档案的查询 profile-based-queries
此查询检查特定用户档案是否通过计数与该用户档案和历程组合关联的事件进入历程。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
结果应大于0。 此查询返回用户档案进入历程的确切次数。
方法1:如果消息的名称在历程中不是唯一的(会在多个位置使用)。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
结果应大于0。 此查询仅告诉我们是否已在历程端成功执行消息操作。
方法2:如果消息的名称在历程中是唯一的。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
查询会返回所有消息的列表,以及为所选用户档案调用的消息计数。
此查询检索过去30天内特定用户档案成功执行的所有消息操作,按消息名称分组。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
查询会返回所有消息的列表,以及为所选用户档案调用的消息计数。
此查询返回特定用户档案在过去30天内输入的所有历程,以及每个历程的条目计数。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
查询会返回所有历程名称的列表,以及被查询的用户档案进入历程的次数。
此查询提供在指定时间段内进入历程的不同用户档案数量的每日细分。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
在定义的周期内,查询将返回每天进入历程的用户档案数。 如果通过多个身份输入用户档案,则将被计算两次。 如果启用了重新进入,并且是在不同日期重新进入历程,则用户档案计数可能会在不同日期重复。
了解如何对journey_step_events中丢弃的事件类型进行故障排除。
与读取受众相关的查询 read-segment-queries
此查询通过查找作业排队时间和完成时间之间的时间差来计算受众导出作业的持续时间。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
查询将返回受众导出作业排队时间和最终结束时间之间的时间差(以分钟为单位)。
此查询计算在读取受众活动期间由于实例重复错误而放弃的不同配置文件的数量。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
查询返回历程丢弃的所有用户档案ID,因为这些用户档案ID是重复的。
此查询返回由于命名空间无效或缺少所需命名空间的标识而被放弃的用户档案计数。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
该查询返回历程丢弃的所有用户档案ID,原因是它们具有无效的命名空间或没有该命名空间的身份。
此查询计算因缺少历程执行所需的身份映射而被放弃的用户档案。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
查询返回历程丢弃的所有用户档案ID,因为缺少身份映射。
此查询标识在历程以测试模式运行但配置文件的testProfile属性未设置为true时放弃的用户档案。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
查询返回历程丢弃的所有配置文件ID,因为导出作业在测试模式下运行,但配置文件的testProfile属性未设置为true。
此查询返回历程执行期间由于内部系统错误而被放弃的用户档案计数。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
查询返回由于某些内部错误而被历程丢弃的所有用户档案ID。
此查询提供读取受众活动的全面概述,包括受众导出流程所有阶段的区段导出作业详细信息、事件代码、状态和配置文件计数。
数据湖查询
| code language-sql |
|---|
|
它将返回与给定历程版本相关的所有服务事件。 我们可以遵循操作链:
- 主题创建
- 导出作业创建
- 导出作业终止(使用导出用户档案上的量度)
- 工作人员处理终止
我们还可以检测以下问题:
- 主题或导出作业创建出错(包括受众导出API调用超时)
- 导出作业可能卡住(对于给定的历程版本,我们没有任何有关导出作业终止的事件)
- 工作人员问题,如果我们收到了导出作业终止事件,但没有工作人员处理终止事件
重要信息:如果此查询未返回任何事件,则可能是由于以下原因之一造成的:
- 历程版本尚未达到计划
- 如果历程版本应该通过调用orchestrator触发导出作业,则上游流出现问题:历程部署问题、业务事件或调度程序问题。
此查询筛选与读取受众失败相关的特定错误事件代码,例如主题创建错误、API调用错误、超时和失败的导出作业。
数据湖查询
| code language-sql |
|---|
|
此查询检索受众导出作业的处理状态,显示它们连同配置文件导出量度是成功还是失败。
数据湖查询
| code language-sql |
|---|
|
如果未返回任何记录,则意味着:
- 创建主题或导出作业期间出错
- 导出作业仍在运行
此查询将放弃的配置文件计数与导出作业量度相结合,可完整地查看每个导出作业的受众导出性能。
数据湖查询
| code language-sql |
|---|
|
此查询汇总给定历程版本的所有导出作业中的总体量度,对于定期历程或具有主题重用的业务事件触发的历程非常有用。
数据湖查询
| code language-sql |
|---|
|
此查询与上一个查询不同。
它会返回给定历程版本的整体量度,而不考虑可以为其运行的作业(在重复历程的情况下,业务事件会触发利用主题重用的事件)。
与受众资格相关的查询 segment-qualification-queries
此查询标识因受众实现状态与历程的受众资格配置(例如,为“enters”而为“exited”配置的用户档案)不匹配而被放弃的用户档案。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
此查询返回由于受众实现错误而被历程版本丢弃的所有用户档案ID。
此查询可检索由于内部服务错误而为特定用户档案放弃的所有受众资格或外部事件。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
此查询返回由于用户档案的任何其他原因而被放弃的所有事件(外部事件/受众资格事件)。
基于事件的查询 event-based-queries
此查询计算历程在指定时间范围内按日期分组接收业务事件的次数。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
此查询标识特定用户档案的外部事件何时被丢弃,因为没有配置为接收该事件的活动或匹配历程。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
了解如何对journey_step_events中丢弃的事件类型进行故障排除。
此查询可检索由于内部服务错误而为特定用户档案丢弃的外部事件,以及事件ID和错误代码。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
了解如何对journey_step_events中丢弃的事件类型进行故障排除。
此查询汇总旅程状态机放弃的所有事件,按错误代码分组,以帮助识别放弃的最常见原因。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
了解如何对journey_step_events中丢弃的事件类型进行故障排除。
此查询标识所有因配置文件尝试在历程配置中不允许重新进入时重新进入历程而被放弃的事件。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
了解如何对journey_step_events中丢弃的事件类型进行故障排除。
常见的基于历程的查询 journey-based-queries
此查询返回具有活动的独特历程版本的每日计数,可帮助您了解一段时间内的历程执行模式。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
查询会返回在定义的期间内,每天触发的唯一历程计数。 每天将计算一次触发多天的单个历程。
历程实例查询 journey-instances-queries
此查询使用公用表表达式(CTE)通过查找经过节点但尚未进入后续节点的用户档案,来识别当前在历程中的特定节点等待的用户档案。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
此查询计算在指定时间段内退出的旅程实例,包括由于完成、错误、超时或上限错误而退出的旅程。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
此查询提供历程退出的详细细分,显示每个退出实例的节点名称和退出状态,以帮助识别用户档案离开历程的位置和原因。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
与自定义操作性能量度相关的查询 query-custom-action
此查询提供自定义HTTP操作的性能量度,包括调用总数、成功调用、按类型划分的错误计数(4xx、5xx、超时、上限)以及每个端点的每秒请求吞吐量。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
此查询提供与上一个查询相同的性能量度,但以时间序列进行组织,显示端点性能随时间的变化以及以分钟为粒度的变化情况。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
此查询计算自定义操作端点的响应时间百分比,帮助您了解延迟分布并识别不同百分比阈值下的性能异常值。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
此查询提供以时间序列组织的延迟百分位,允许您跟踪终结点响应时间在不同百分位级别随时间的变化。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
此查询分析已限制端点的队列等待时间,显示第50和第95百分位等待时间,以帮助您了解限制对自定义操作的影响。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
此查询将队列等待时间百分比作为时间序列提供,允许您监视限制如何影响每个端点的等待时间。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|
此查询提供特定端点的详细错误细目,按错误类型和错误代码分组,包括有关重试尝试的信息。
数据湖查询
| code language-sql |
|---|
|
示例
| code language-sql |
|---|
|