查询计划

上次更新: 2023-11-14
  • 主题:
  • Queries
    查看有关此主题的更多信息
  • 创建对象:
  • Developer
    User
    Admin
    Leader

您可以通过创建查询计划来自动运行查询。 计划的查询以自定义节奏运行,以根据频率、日期和时间管理您的数据。 如果需要,您还可以为结果选择输出数据集。 可以从“查询编辑器”安排已另存为模板的查询。

重要

您只能向已创建、保存和运行的查询添加计划。

任何计划查询都会添加到的列表 计划的查询 选项卡。 在该工作区中,您可以通过UI监控所有已计划查询作业的状态。 在 计划的查询 选项卡,您可以找到有关查询运行的重要信息并订阅警报。 可用信息包括运行失败时的状态、计划详细信息和错误消息/代码。 请参阅 监视计划查询文档 以了解更多信息。

创建查询计划

要向查询添加计划,请从以下任一位置选择查询模板 模板 选项卡或 计划的查询 选项卡,导航到查询编辑器。

要了解如何使用API添加计划,请参阅 计划查询端点指南.

当从查询编辑器访问保存的查询时, 时间表 选项卡显示在查询名称下方。 选择 时间表.

突出显示了“计划”选项卡的查询编辑器。

此时将显示计划工作区。 选择 添加计划 创建计划。

查询编辑器计划工作区中突出显示了添加计划。

此时将显示“调度详细资料”页。 在此页面上,您可以选择计划查询的频率、开始和结束日期、计划查询在一周中的哪一天运行,以及要将查询导出到哪个数据集。

突出显示“计划详细信息”面板。

您可以选择以下选项 频率

  • 每小时:计划查询将在您选择的日期范围内每小时运行一次。
  • 每日:计划查询将每隔X天运行一次您选择的时间和日期时段。 请注意,所选时间位于 UTC​而不是您当地的时区。
  • 每周:选定的查询将在选定的一周、时间和日期时段运行。 请注意,所选时间位于 UTC​而不是您当地的时区。
  • 每月:选定的查询将在每个月的选定日期、时间和日期时段运行。 请注意,所选时间位于 UTC​而不是您当地的时区。
  • 每年:选定的查询每年将在您选择的天、月、时间和日期时段运行。 请注意,所选时间位于 UTC​而不是您当地的时区。

对于输出数据集,您可以选择使用现有数据集或创建新数据集。

重要

由于您使用的是现有数据集或创建新数据集,因此您需要 需要包括 INSERT INTOCREATE TABLE AS SELECT 作为查询的一部分,因为数据集已设置。 包括 INSERT INTOCREATE TABLE AS SELECT 作为您计划查询的一部分,将导致错误。

如果您无权访问参数化查询,请继续访问 删除或禁用计划 部分。

为计划的参数化查询设置参数

重要

参数化查询UI功能当前在以下位置可用: 仅限限量发布 并非所有客户均适用。

如果要为参数化查询创建计划查询,现在必须为这些查询运行设置参数值。

计划创建工作流的“计划详细信息”部分,其中高亮显示查询参数部分。

确认所有这些详细信息后,选择 保存 创建计划。 您将返回到显示新创建计划的详细信息的计划工作区,包括计划ID、计划本身和计划的输出数据集。 您可以使用计划ID查找有关运行计划查询本身的更多信息。 要了解更多信息,请阅读 计划查询运行端点指南.

突出显示新创建计划的计划工作区。

删除或禁用计划

您可以从特定查询的计划工作区或以下位置删除或禁用计划 计划的查询 列出所有计划查询的工作区。

要访问 时间表 选项卡中,您必须从以下任一位置选择查询模板的名称: 模板 选项卡或 计划的查询 选项卡。 这将导航到该查询的查询编辑器。 从查询编辑器中,选择 时间表 以访问时间表工作区。

从可用计划的行中选择一个计划。 您可以使用切换来禁用或启用计划查询。

重要

您必须先禁用计划,然后才能删除查询的计划。

选择 删除计划 删除已禁用的计划。

突出显示具有“禁用计划”和“删除”计划的计划工作区。

或者, 计划的查询 选项卡提供每个计划查询的内联操作集合。 可用的内联操作包括 禁用计划 或 启用计划, 删除计划、和 订阅 用于计划查询的警报。 有关如何通过“计划查询”选项卡删除或禁用计划查询的完整说明,请参阅 monitor scheduled queried指南.

在此页面上