本页介绍如何为工作区创建和配置通知目标。
系统通知是指示工作流何时遇到运行事件(启动、成功和失败)的消息。 默认情况下,通知发送到用户电子邮件地址,但管理员可以使用 Webhook 配置备用通知目标。 这使你可以与 Azure Databricks 生成事件驱动的集成。
管理员还可以配置通知目标,以接收来自工作区用户的访问请求,例如 Unity 目录对象的特权请求。
只有 Azure Databricks 工作区管理员才能管理通知目标。 配置目标后,所有用户都可以使用该目标。
网络要求
对于基于webhook的目的地,接收端点必须满足以下要求:
Azure Databricks 强制使用 HTTPS 以确保安全。 通知目标必须使用由受信任的证书颁发机构签名的安全套接字层 (SSL) 证书。
通知目标必须将工作区控制平面和数据平面出站 IP 地址添加到其允许列表:
有关控制平面的 Web 应用 IP 地址,请参阅Azure Databricks 服务和资产的 IP 地址和域。
有关数据平面出站 IP 地址,请参阅 Azure Databricks 发布的
ip-ranges.json文件。 在文件中搜索工作区的数据平面区域,并在网络堆栈中列出相应的出站 IP 地址。Azure Databricks可能会每隔 30 天更新一次出站 IP。 发布后 60 天后,更新的 IP 就会处于活动状态,因此请在激活窗口关闭之前定期查看文件并更新允许列表。
若要跟踪版本之间的更改,请保存 JSON 文件的后续版本并比较
timestampSeconds该值。 筛选条目,其中:字段
service为Databricks字段
platform为azure字段
type为outbound
创建新通知目标
配置新通知目标
在工作区顶部栏中单击你的用户名,然后从下拉列表中选择“设置”。
在“工作区管理员”部分中,单击“通知”选项卡。
然后单击“管理”按钮。
单击“+添加目标”。
选择目标类型。 目前支持以下目标:
Microsoft Teams
PagerDuty
根据类型配置目的地。
单击 “创建” 。
为每个目标使用不同的凭据
目标配置安全地加密存储在 Azure Databricks 工作区中。 对于需要提供URL或凭据的目的地,Azure Databricks建议为每个配置的目的地使用不同的凭证。 这限制了第三方终端被攻破时的影响。 这些包括:
Microsoft Teams 使用 Webhook:用于发送通知的 URL。
PagerDuty:用于将通知唯一路由到 PagerDuty 服务的集成密钥。
Webhook:用于 HTTP Basic 认证的用户名和密码,或用于 OAuth 认证(测试版)的客户端 ID 和客户端密钥。
通过对每个配置的目标使用不同的机密,可以单独撤销单个通知目标的访问权限,而不会影响 Azure Databricks 工作区中所有其他目标的操作。
PagerDuty目的地
要设置PagerDuty目的地:
在 PagerDuty 中,向你的服务添加集成,并选择 Events API V2 集成类型。
复制 PagerDuty 为集成生成的集成密钥。
在 Azure Databricks 中,将集成密钥粘贴到 PagerDuty 通知目的地。
在作业中添加 Webhook
配置目标后,可以在作业的 作业通知 设置中访问它们。 有关详细信息,请参阅为作业添加通知。
每个作业每个事件类型最多支持三个系统目标。 配置作业通知时,必须手动输入电子邮件地址。
限制
通知目标目前存在以下限制:
电子邮件通知目标对收件人地址长度的限制为 1,300 个字符。
对于自定义通知正文,非电子邮件目标(如Microsoft Teams)不支持 HTML 格式。 某些通知目标支持 Markdown。
对于作业,必须在作业的设置中手动设置电子邮件目标。