监测计划查询
- 主题:
- 查询
创建对象:
- 用户
- 开发人员
Adobe Experience Platform通过UI提高了所有查询作业状态的可见性。 在计划查询选项卡中,您现在可以找到有关查询运行的重要信息,包括状态、计划详细信息和失败时的错误消息/代码。 您还可以通过计划查询选项卡,通过UI为任何此类查询订阅基于其状态的查询警报。
计划的查询
计划查询选项卡提供了所有计划CTAS和ITAS查询的概述。 可以找到所有计划查询的运行详细信息,以及任何失败查询的错误代码和消息。
要导航到计划查询选项卡,请从左侧导航栏中选择 查询,然后选择 计划查询
下表描述了每个可用的列。

Run once
和Scheduled
。Success
、Failed
、In progress
和No runs
。计划查询的当前状态。 共有六个潜在值: 正在注册、活动、非活动、已删除、连字符和已隔离。
- Registering 状态表示系统仍在为查询创建新的计划。 请注意,您不能在注册时禁用或删除计划查询。
- 活动 状态表示计划的查询 尚未超过 其完成日期和时间。
- 非活动 状态表示计划的查询已 通过 其完成日期和时间,或者已被用户标记为非活动状态。
- Deleted 状态表示查询计划已删除。
- 连字符表示计划查询是单次、非循环查询。
- 隔离 状态表示查询连续十次运行失败,需要您的干预才能执行任何进一步的执行。
自定义计划查询的表设置
您可以根据需要调整计划查询选项卡上的列。 要打开自定义表设置对话框并编辑可用列,请选择设置图标(
切换相关的复选框以删除或添加表列。 接下来,选择 应用 以确认您的选择。
使用内联操作管理计划查询
计划查询视图提供了各种内联操作以从一个位置管理所有计划查询。 每行中都会显示内联操作,并带有省略号。 选择要管理的计划查询的省略号,以在弹出菜单中查看可用选项。 可用选项包括禁用计划或启用计划、删除计划、订阅以查询警报,以及启用或禁用隔离。
禁用或启用计划查询
要禁用计划查询,请为要管理的计划查询选择省略号,然后从弹出菜单的选项中选择 禁用计划。 将显示一个对话框以确认您的操作。 选择 禁用 以确认您的设置。
禁用计划查询后,可通过同一进程启用计划。 选择省略号,然后从可用选项中选择 启用计划。
删除计划查询
要删除计划查询,请为要管理的计划查询选择省略号,然后从弹出菜单的选项中选择 删除计划。 将显示一个对话框以确认您的操作。 选择 删除 以确认您的设置。
删除计划查询后,将 不 从计划查询列表中删除。 省略号提供的内联操作将被删除并替换为灰显的添加警报订阅图标。 您无法订阅已删除计划的警报。 该行保留在UI中,用于提供有关作为计划查询的一部分执行的运行的信息。
如果要为该查询模板计划运行,请从相应的行中选择模板名称以导航到查询编辑器,然后按照说明将计划添加到查询,如文档中所述。
订阅警报
要订阅计划查询运行的警报,请选择...
(省略号)或警报订阅图标(
警报对话框打开。 警报对话框允许您同时订阅UI通知和电子邮件警报。 有多个可用的警报订阅选项: start
、success
、failure
、quarantine
和delay
。 选中相应的框并选择 保存 进行订阅。
下表说明了支持的查询警报类型:
start
success
failed
quarantine
delay
有关详细信息,请参阅警报订阅API文档。
查看查询详细信息
选择信息图标(
隔离的查询
注册隔离功能后,任何连续运行失败10次的计划查询将自动置于隔离状态。 具有此状态的查询将变为非活动状态,并且不会按其计划的节奏执行。 然后,您需要进行干预,然后才能执行任何进一步的执行。 这样可以保护系统资源,因为您必须先查看和更正SQL问题,然后才能进一步执行。
要为隔离功能启用计划查询,请从出现的下拉菜单中选择省略号(...
),然后选择启用隔离。
在计划创建过程中,还可以在隔离功能中注册查询。 有关详细信息,请参阅查询计划文档。
查询运行延迟
通过设置查询延迟警报,保持对计算小时数的控制。 如果查询状态在特定时段后保持不变,则可以监视查询性能并接收通知。 使用“查询运行延迟”警报,以在特定时间段后查询未完成继续处理时收到通知。
当您订阅计划查询运行的警报时,可用的警报之一是查询运行延迟。 此警报要求您设置执行时间的阈值,此时您会收到处理延迟的通知。
要选择触发通知的阈值持续时间,请在文本输入字段中输入数字,或使用向上和向下箭头递增1分钟。 由于阈值以分钟为单位进行设置,因此观察查询运行延迟的最长持续时间为1440分钟(24小时)。 运行延迟的默认时间段为150分钟。
请参阅订阅警报部分,了解如何订阅查询运行延迟警报。
筛选查询
您可以根据运行频率筛选查询。 从计划查询选项卡中,选择过滤器图标(
要根据查询的运行频率筛选查询列表,请选中 已计划 或 运行一次 筛选复选框。
启用筛选条件后,选择 隐藏筛选器 以关闭筛选器面板。
查询运行计划详细信息
要打开计划详细信息页面,请从计划查询选项卡中选择查询名称。 此视图提供在该计划查询中执行的所有运行的列表。 提供的信息包括开始和结束时间、状态以及所使用的数据集。
此信息以五列表格形式提供。 每一行表示查询执行。
Success
、Failed
、In progress
或Quarantined
。可在属性面板中看到正在计划的查询的详细信息。 此面板包括初始查询ID、客户端类型、模板名称、查询SQL和计划的节奏。
选择查询运行ID以定位至运行详细信息页并查看查询信息。
查询运行概述
查询运行概述提供了有关此计划查询的单独运行的信息,以及运行状态的更详细细目。 此页面还包括客户机信息以及可能导致查询失败的任何错误的详细信息。
查询状态部分提供了查询失败时的错误代码和错误消息。
您可以从此视图将查询SQL复制到剪贴板。 要复制查询,请选择SQL代码片段右上角的复制图标。 此时会显示一条弹出消息,确认已复制代码。
使用匿名块运行查询的详细信息
使用匿名块组成其SQL语句的查询被分隔到其各自的子查询中。 通过分隔为子查询,可单独检查每个查询块的运行详细信息。
匿名块通过在查询前使用$$
前缀来表示。 若要了解有关查询服务中匿名块的更多信息,请参阅匿名块文档。
匿名块子查询的运行状态左侧有选项卡。 选择一个选项卡以显示运行详细信息。
如果匿名块查询失败,您可以通过此UI查找该特定块的错误代码。
选择 查询 以返回计划详细信息屏幕,或选择 计划查询 以返回计划查询选项卡。