监测计划查询

Adobe Experience Platform通过UI提高了所有查询作业状态的可见性。 从 计划的查询 选项卡,您现在可以找到有关查询运行的重要信息,包括状态、计划详细信息和失败时的错误消息/代码。 您还可以通过UI订阅基于查询状态的警报,以进行任何此类查询: 计划的查询 选项卡。

计划的查询

此 计划的查询 选项卡提供了所有计划CTAS和ITAS查询的概述。 可以找到所有计划查询的运行详细信息,以及任何失败查询的错误代码和消息。

要导航至 计划的查询 选项卡,选择 查询 从左侧导航栏中,后面是 计划的查询

查询工作区中的计划查询选项卡突出显示计划的查询和查询。

下表描述了每个可用的列。

NOTE
警报订阅图标( 警报订阅图标。 )包含在无标题列的每一行中。 请参阅 警报订阅 部分以了解更多信息。
描述
名称
名称字段是模板名称或SQL查询的前几个字符。 使用查询编辑器通过UI创建的任何查询都会在开始时命名。 如果查询是通过API创建的,则其名称将成为用于创建查询的初始SQL的片段。 要查看与查询关联的所有运行的列表,请从中选择一项 名称 列。 欲了解更多信息,请参见 查询运行计划详细信息 部分。
模板
查询的模板名称。 选择模板名称以导航到查询编辑器。 为方便起见,查询模板会显示在查询编辑器中。 如果没有模板名称,该行将标有连字符,并且无法重定向到查询编辑器以查看查询。
SQL
SQL查询的片段。
运行频率
查询设置为运行的节奏。 可用的值包括 Run onceScheduled.
创建者
创建查询的用户的名称。
已创建
创建查询时的时间戳(UTC格式)。
上次运行时间戳
运行查询时的最新时间戳。 此列突出显示查询是否已根据其当前计划执行。
上次运行状态
最近查询执行的状态。 状态值为: SuccessFailedIn progress、和 No runs.
计划状态

计划查询的当前状态。 有六个潜在值, 正在注册, 活动, 不活动, 已删除、连字符和 已隔离.

  • 正在注册 状态表示系统仍在为查询创建新的计划。 请注意,您不能在注册时禁用或删除计划查询。
  • 活动 状态表示计划查询具有 尚未通过 完成日期和时间。
  • 不活动 状态表示计划查询具有 已通过 完成日期和时间,或已被用户标记为处于不活动状态。
  • 已删除 状态表示查询计划已删除。
  • 连字符表示计划查询是单次、非循环查询。
  • 已隔离 状态表示查询连续十次运行失败,需要您的干预才能执行任何进一步的执行。
TIP
如果导航到查询编辑器,则可以选择 查询 以返回 模板 选项卡。

自定义计划查询的表设置 customize-table

您可以调整 计划的查询 轻松满足您的需求。 打开 自定义表 设置对话框并编辑可用列,选择设置图标( 设置图标。 )。

NOTE
此 已创建 默认情况下,引用计划创建日期的列处于隐藏状态。

突出显示“自定义表格设置”图标的“计划查询”选项卡。

切换相关的复选框以删除或添加表列。 接下来,选择 应用 确认您的选择。

NOTE
在创建过程中,通过UI创建的任何查询都将变为命名模板。 模板名称将显示在模板列中。 如果查询是通过API创建的,则模板列为空。

自定义表设置对话框。

使用内联操作管理计划查询 inline-actions

此 计划的查询 查看提供了各种内联操作,以便从一个位置管理所有计划的查询。 每行中都会显示内联操作,并带有省略号。 选择要管理的计划查询的省略号,以在弹出菜单中查看可用选项。 可用的选项包括 禁用计划 或 启用计划, 删除计划订阅 查询警报,以及 启用或 禁用隔离.

内联操作省略号和弹出菜单突出显示的“计划查询”选项卡。

禁用或启用计划查询 disable

要禁用计划查询,请为要管理的计划查询选择省略号,然后选择 禁用计划 从弹出菜单中的选项中进行选择。 将显示一个对话框以确认您的操作。 选择 禁用 以确认设置。

禁用计划查询后,可通过同一进程启用计划。 选择省略号,然后选择 启用计划 从可用选项删除。

NOTE
如果查询已被隔离,则应在启用其计划之前查看模板的SQL。 如果模板查询仍有问题,这可以防止计算小时数的浪费。

删除计划查询 delete

要删除计划查询,请为要管理的计划查询选择省略号,然后选择 删除计划 从弹出菜单中的选项中进行选择。 将显示一个对话框以确认您的操作。 选择 删除 以确认设置。

删除计划查询后,它会 已从计划查询列表中删除。 省略号提供的内联操作将被删除并替换为灰显的添加警报订阅图标。 您无法订阅已删除计划的警报。 该行保留在UI中,用于提供有关作为计划查询的一部分执行的运行的信息。

“计划查询”选项卡,其中有一个已删除的计划查询,并且突出显示的警报订阅图标显示为灰色。

如果要为该查询模板计划运行,请从相应的行中选择模板名称以导航到查询编辑器,然后按照以下步骤操作 向查询添加计划的说明 如文档中所述。

订阅警报 alert-subscription

要订阅计划查询运行的警报,请选择 ... (省略号)或警报订阅图标( 警报订阅图标。 )以管理计划查询。 出现内联操作下拉菜单。 接下来,选择 订阅 从可用选项删除。

计划查询工作区具有省略号、警报订阅图标,并且内联操作下拉菜单突出显示。

此 警报 对话框打开。 此 警报 该对话框允许您同时订阅UI通知和电子邮件警报。 提供了多个警报订阅选项: startsuccessfailurequarantine、和 delay. 选中相应的一个或多个框并选择 保存 订购。

警报订阅对话框。

下表说明了支持的查询警报类型:

警报类型
描述
start
此警报会在启动或开始处理计划的查询运行时通知您。
success
此警报会在计划的查询运行成功完成时通知您,指示查询在没有任何错误的情况下执行。
failed
当计划的查询运行遇到错误或无法成功执行时,将触发此警报。 它有助于您及时识别和处理问题。
quarantine
当计划的查询运行处于隔离状态时,将激活此警报。 在中注册查询时 隔离功能,任何连续十次运行失败的计划查询将自动放入 已隔离 省/州。 然后,您需要进行干预,然后才能执行任何进一步的执行。
delay
此警报会通知您是否存在 查询执行结果的延迟 超过指定的阈值。 您可以设置自定义时间,以在该持续时间运行查询时触发警报,而不完成或失败。
NOTE
要收到查询运行被隔离的通知,您必须首先在中注册计划的查询运行 隔离功能.

请参阅 警报订阅API文档 以了解更多信息。

查看查询详细信息 query-details

选择信息图标( 信息图标。 ),以查看查询的详细信息面板。 详细信息面板包含查询的所有相关信息,但不包括计划查询表中包含的事实信息。 其他信息包括查询ID、上次修改日期、查询的SQL、计划ID和当前设置的计划。

计划查询选项卡,其信息图标和详细信息面板突出显示。

隔离的查询 quarantined-queries

NOTE
隔离警报不适用于“只运行一次”的临时查询。 隔离警报仅适用于计划批处理(CTAS和ITAS)查询。

注册隔离功能后,任何连续十次运行失败的计划查询都会自动放入 已隔离 状态。 具有此状态的查询将变为非活动状态,并且不会按其计划的节奏执行。 然后,您需要进行干预,然后才能执行任何进一步的执行。 这样可以保护系统资源,因为您必须先查看和更正SQL问题,然后才能进一步执行。

要为隔离功能启用计划查询,请选择省略号(...)后跟 启用隔离 从出现的下拉菜单中。

内联操作下拉菜单中突出显示了带有省略号和启用隔离的计划查询选项卡。

在计划创建过程中,还可以在隔离功能中注册查询。 请参阅 查询计划文档 以了解更多信息。

查询运行延迟 query-run-delay

通过设置查询延迟警报,保持对计算小时数的控制。 如果查询状态在特定时段后保持不变,则可以监视查询性能并接收通知。 使用'查询运行延迟'如果查询在特定时间段后继续处理而未完成,则会收到通知。

当您 订阅警报 对于计划的查询运行,可用的警报之一是 查询运行延迟. 此警报要求您设置执行时间的阈值,此时您会收到处理延迟的通知。

要选择触发通知的阈值持续时间,请在文本输入字段中输入数字,或使用向上和向下箭头递增1分钟。 由于阈值以分钟为单位进行设置,因此观察查询运行延迟的最长持续时间为1440分钟(24小时)。 运行延迟的默认时间段为150分钟。

NOTE
查询运行只能有一个运行延迟时间。 如果更改延迟阈值,则订阅警报的用户和整个组织的延迟阈值都会更改。

“已计划查询”选项卡上的“警报”对话框,其中高亮显示查询运行延迟输入字段。

请参阅订阅警报部分,了解如何 订阅 查询运行延迟 警报.

筛选查询 filter

您可以根据运行频率筛选查询。 从 计划的查询 选项卡,选择过滤器图标( 过滤器图标 )以打开过滤器侧栏。

突出显示过滤器图标的计划查询选项卡。

要根据查询的运行频率筛选查询列表,请选择 已计划运行一次 筛选复选框。

NOTE
任何已执行但未计划的查询均符合 运行一次.

突出显示筛选器侧栏的计划查询选项卡。

启用筛选条件后,选择 隐藏筛选器 以关闭过滤器面板。

查询运行计划详细信息 query-runs

要打开“计划详细信息”页,请从中选择查询名称 计划的查询 选项卡。 此视图提供在该计划查询中执行的所有运行的列表。 提供的信息包括开始和结束时间、状态以及所使用的数据集。

“调度详细资料”页。

此信息以五列表格形式提供。 每一行表示查询执行。

列名
描述
查询运行Id
每日执行的查询运行ID。 选择 查询运行Id 导航到 查询运行概述.
查询运行开始
执行查询的时间戳。 时间戳采用UTC格式。
查询运行完成
查询完成时的时间戳。 时间戳采用UTC格式。
状态
最近查询执行的状态。 状态值为: SuccessFailedIn progress,或 Quarantined.
数据集
执行中涉及的数据集。

欲知正在计划的查询详情,请参阅 属性 面板。 此面板包括初始查询ID、客户端类型、模板名称、查询SQL和计划的节奏。

突出显示属性面板的调度详细信息页面。

选择查询运行ID以定位至运行详细信息页并查看查询信息。

计划详细信息屏幕中突出显示了运行ID。

查询运行概述 query-run-overview

此 查询运行概述 提供此计划查询的单独运行信息,以及运行状态的更详细细分。 此页面还包括客户机信息以及可能导致查询失败的任何错误的详细信息。

运行详细信息屏幕,其中高亮显示概述部分。

查询状态部分提供了查询失败时的错误代码和错误消息。

运行详细信息屏幕中突出显示了错误部分。

您可以从此视图将查询SQL复制到剪贴板。 要复制查询,请选择SQL代码片段右上角的复制图标。 此时会显示一条弹出消息,确认已复制代码。

运行详细信息屏幕中突出显示SQL复制图标。

使用匿名块运行查询的详细信息 anonymous-block-queries

使用匿名块组成其SQL语句的查询被分隔到其各自的子查询中。 通过分隔为子查询,可单独检查每个查询块的运行详细信息。

NOTE
使用DROP命令的匿名块的运行详细信息将 将作为单独的子查询报告。 CTAS查询、ITAS查询和用作匿名块子查询的COPY语句有单独的运行详细信息可用。 当前不支持DROP命令的运行详细信息。

匿名块通过使用 $$ 查询前的前缀。 要了解有关查询服务中匿名块的更多信息,请参见 匿名块文档.

匿名块子查询的运行状态左侧有选项卡。 选择一个选项卡以显示运行详细信息。

显示匿名块查询的查询运行概述。 多个查询选项卡会突出显示。

如果匿名块查询失败,您可以通过此UI查找该特定块的错误代码。

查询运行概述显示了匿名块查询,其中突出显示了单个块的错误代码。

选择 查询 以返回计划详细信息屏幕,或者 计划的查询 以返回 计划的查询 选项卡。

运行详细信息屏幕中突出显示了查询。

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb