警报

使用SQL编辑器定义警报通知你什么时候返回的字段计划查询满足一个阈值。您可以使用警报监视您的业务或警报等工具开始工作流集成用户新员工培训或支持的票。警报补充计划查询,但是他们的标准检查每次执行。

重要的

  • 警报利用查询和参数使用SQL编辑器中指定的默认值为每个参数。

视图和组织警报

警报可以以两种方式之一:

  • 新的警报在工作空间浏览器现在可以被点击工作空间的图标工作空间在侧边栏。这些警报是看得见的,默认情况下,在<强>家文件夹中。用户可以在浏览器工作区警报组织到文件夹中连同其他砖对象。视图和组织目前现有的警报在工作区中浏览器,用户(或管理员)必须迁移到工作空间浏览器。砖SQL的工作空间浏览器的信息,包括迁移,明白了工作空间浏览器

  • 所有的警报,无论创建时间或迁移状态,可以通过点击查看警告图标警报在侧边栏。

重要的

7月10日开始,2023年,砖将force-migrate砖SQL的所有内容(仪表板、查询、提醒)工作空间浏览器。访问<强>我的提醒寻找任何un-migrated警报,将左边的复选框。当一个盒子检查,<强>迁移按钮就会出现,让你一次迁移多个资产。如果不采取行动,你的提醒将移动到您的用户文件夹中。工作空间管理员应确保对象没有一个有效的积极的主人有一个更新。9月10日,2023年开始,我们将删除所有已迁移对象没有一个有效的所有者。

默认情况下,对象是倒序排序。你可以重新排序通过单击列标题列表。

  • 的名字显示每个警报的字符串名称。

  • 状态显示了警戒状态是否触发,好吧,或未知的

  • 最后一次更新显示了最后更新时间或日期。

  • 在创建显示的日期和时间创建警报。

    • 触发意味着最近执行,值列在你的目标的查询符合条件和阈值配置。如果你提醒检查是否“猫”是1500以上,你的提醒将被触发,只要“猫”是1500年以上。

    • 好吧意味着在最近的查询执行,列值不符合条件和阈值配置。这并不意味着警报并不是之前触发。如果你的“猫”值是1470,你的提醒将显示好吧

    • 未知的意味着砖SQL没有足够的数据来评估预警标准。你会看到这个状态后立即创建警报和直到查询执行。你也会看到这个状态如果没有查询结果中的数据或者最近的查询结果不包括的< em >值列你配置。

创建一个警报

按照以下步骤创建一个警报在单个列的查询。

  1. 做下列之一:

    • 点击新图标在侧边栏并选择<强>警报。

    • 点击警告图标警报在侧边栏,然后点击<强>+新的警报按钮。

    • 点击工作空间的图标工作空间在侧边栏,然后单击<强>+创建警报。

  2. 寻找一个目标查询。

    目标查询

    提醒在多个列,您需要修改您的查询。看到警报聚合

  3. 在<强>触发条件领域,配置警报。

    • 的<强>值列下拉控制哪个字段的查询结果评估。警报条件上可以设置查询结果中的第一个值的列,或者你可以选择设置一个聚合所有单个列的行,比如SUM或平均。

      警报聚合
    • 的<强>操作符下拉控制应用的逻辑操作。

    • 的<强>阈值比较文本输入和使用您所指定的条件值列。

    提醒设置
  4. 点击<强>预览警报预览警报和测试警报是否会触发与当前数据。

  5. 在<强>当触发时,发送通知字段中,选择多少通知发送警报触发时:

    • 只有一次:发送一个通知警戒状态改变从好吧触发

    • 每一次警报评估:发送一个通知每当警戒状态触发无论其地位在前面的评价。

    • 最多每:发送一个通知每当警戒状态触发在特定的时间间隔。这个选择可以让你避免垃圾邮件通知警报触发。

    无论你选择哪个通知设置,只要地位从你收到一个通知好吧触发或从触发好吧。时间表的设置影响你将收到多少通知如果状态仍然存在触发从一个执行下一个。有关详细信息,请参见通知频率

  6. 在<强>模板下拉,选择一个模板:

    • 使用默认模板:警报通知消息和警报配置屏幕的链接查询屏幕。

    • 使用自定义模板:警报通知包括更具体的预警信息。

      1. 将显示一个框,输入字段为主题和正文组成。任何静态内容是有效的,你可以把内置模板变量:

        • ALERT_STATUS:评估警报状态(字符串)。

        • ALERT_CONDITION:警报条件操作符(字符串)。

        • ALERT_THRESHOLD:警报阈值(字符串或数字)。

        • ALERT_NAME:警报名称(字符串)。

        • ALERT_URL:警报页面URL(字符串)。

        • QUERY_NAME:相关的查询名称(字符串)。

        • QUERY_URL:相关的查询页面URL(字符串)。

        • QUERY_RESULT_TABLE:查询结果表。

        • QUERY_RESULT_VALUE:查询结果值(字符串或数字)。

        • QUERY_RESULT_ROWS:查询结果行(值数组)。

        • QUERY_RESULT_COLS:查询结果列(字符串数组)。

        主题的一个例子,例如,可能是:警报“{{ALERT_NAME}}”改变了状态{{ALERT_STATUS}}

      2. 您可以使用HTML格式消息在一个自定义的模板。以下标记和属性允许在模板:

        • 标签:<一>,<方法>,<缩略词>,< b >,< blockquote >,<身体>,< br >,<代码>,< div >,< em >,<标题>,< h2 >,< h3 >,< h4 >,< h5>,<代替>,<头>,<人力资源>,< html >,<我>,<李>,< ol >,< p >,< span >,<强>,<表>,tbody > <,< td >,< th >,< tr >,< ul >

        • 属性:href (<一>)、标题(<一>,<方法>,<缩略词>)

      3. 单击<强>预览切换按钮来预览渲染的结果。

        重要的

        预览是用于验证模板变量是正确地呈现。这不是一个最终的准确表示通知内容,因为每个通知目的地可以显示不同的通知。

      4. 单击<强>保存更改按钮。

  7. 在<强>刷新,设定一个刷新进度。警报的刷新时间独立于查询刷新进度。

    • 如果查询是一个<强>作为所有者运行查询,查询运行使用查询所有者凭证警惕的刷新进度。

    • 如果查询是一个<强>作为观众运行查询,查询运行使用警报创造者的凭据警惕的刷新进度。

  8. 点击<强>创建警报。

  9. 选择一个通知目的地

    重要的

    如果你跳过这一步< em >不会警报触发时得到通知。

    通知目的地

警报聚合

聚合在警报通过修改原始SQL的砖SQL查询的警报。警报来包装原始查询文本在一个公共表表达式(CTE)和执行包装聚合查询聚合查询结果。

作为一个例子,一个总和聚合与文本警报附加到一个查询选择1作为column_name意味着只要刷新提醒,修改后的SQL将运行:作为(选择1作为column_name)选择总和(column_name)

这意味着最初的查询结果()进行聚合不能显示在警报定义的身体(等参数QUERY_RESULT_ROWSQUERY_RESULT_COLS)只要有一个聚合在一个警告。相反,这些变量只会显示最后,事后的查询结果。

请注意

所有触发条件不支持聚合相关的API。

警报在多个列

设置警报基于多个列的查询,查询可以实现报警逻辑并返回一个布尔值警报触发的。例如:

选择情况下drafts_count>10000年archived_count>5000年然后1其他的0结束(选择总和(情况下is_archived然后1其他的0结束)作为archived_count,总和(情况下is_draft然后1其他的0结束)作为drafts_count查询)数据

这个查询返回1drafts_count>10000年archived_count>5000年。然后您可以配置警戒值时触发1

通知频率

砖SQL将通知发送给您选择的通知目的地时检测到警戒状态发生了变化好吧触发反之亦然。考虑一下这个例子,警报配置在一个查询,将每天运行一次。警报的日常状态出现在下面的表。周一前警戒状态好吧

一天

警戒状态

周一

好吧

周二

好吧

周三

触发

周四

触发

星期五

触发

周六

触发

周日

好吧

如果通知频率设置只是一次周三,砖SQL发送一个通知当状态改变好吧触发再一次周日时开关。它不发送警报周四,周五或周六,除非你特别配置它因为执行之间的警戒状态并未改变。

配置警报权限

配置谁能管理和运行警报,请参阅警报的访问控制

所有权转移的一个警告

当您保存一个警告,你变得警觉的主人。如果警报的主人从工作区中删除,警报不再有一个所有者。工作区管理用户可以警报的所有权转移到一个不同的用户。通过使用砖SQL的UI:所有权转移

  1. 打开警报。

  2. 点击<强>分享。

  3. 选择一个用户,然后选择<强>可以管理。

  4. 阅读提示。如果你同意,请点击<强>确认。

转移所有权通过使用REST API,明白了所有权转移的一个警告

如果警报之前一个所有者,用户不再有<强>可以管理用户许可警惕,你给了谁<强>可以管理现在业主许可。