設定 Slack 通知

AI/BI 儀表板支援將排程快照傳送至 Slack 頻道。 這允許團隊直接在他們的 Slack 工作區中接收儀表板更新。 本頁說明如何建立Slack應用程式,並將Slack頻道設定為通知目的地。 然後,儀表板編輯者可以將此通知目的地新增為排程儀表板的訂閱者。 關於如何將 Slack 頻道加入訂閱者的資訊,請參閱 訂閱 Slack 或 Microsoft Teams 頻道。

Slack 訂閱提供儀表板快照,包括:

  • 儀表板的PNG影像快照,可直接在頻道中顯示
  • 在 Azure Databricks 中開啟儀錶板的直接連結
  • 訊息討論串中的 PDF 快照附件

顯示儀表板快照的 Slack 通知範例

需求

您必須具有下列權限:

  • 您必須是 Azure Databricks 工作區系統管理員,才能設定通知目的地。
  • 您必須擁有適當的權限,才能在 Slack 工作區中建立和安裝應用程式。

在設定程式期間,您會從 Slack 收集驗證認證,以設定 Azure Databricks 通知目的地。

設定通知目的地之後,任何在儀表板上具有 CAN EDIT 權限的使用者都可以將 Slack 目的地新增為他們管理的排程的訂閱者。

步驟 1:建立和設定 Slack 應用程式

為您的工作區建立 Slack 應用程式並配置必要的權限。

建立 Slack 應用程式

  1. 前往 Slack API 文件中的 您的應用程式 。 系統可能會提示您登入 Slack 工作區。
  2. 按一下 [建立應用程式]。
  3. 按一下 [ 從資訊清單 ] 或 [ 從頭開始],視您是否有資訊清單檔案來新增應用程式的基本資訊,或是想使用 Slack 的設定 UI 建立資訊清單檔案。 請參閱 Slack 的說明文件,了解 有關使用 應用程式資訊清單設定 應用程式的指示,這些是從資訊清單建立的步驟。

建立應用程式後,Slack 應用程式設定頁面會自動開啟。

新增必要的 OAuth 範圍

  1. 在側邊欄的 功能 下,按一下 OAuth 和權限。
  2. 向下捲動至 範圍。
  3. 在 機器人令牌範疇 下,點擊 新增 OAuth 範疇。
  4. 新增下列範圍:
    • incoming-webhook
    • files:write
    • files:read
    • chat:write

在您的工作區中安裝應用程式

  1. 在 Slack 應用程式設定側邊欄的「設定」下,按一下「安裝應用程式」。
  2. 按一下 [安裝] 或 [要求安裝]。
  3. 選取工作區中的目的地頻道。
  4. 按一下 [允許] 以完成安裝。

確認應用程式已新增至您的目標頻道

  1. 在您的 Slack 工作區中,開啟目的地頻道。 按一下視窗頂端附近的頻道名稱。

  2. 按一下 整合項目 標籤。

    Slack 工作區中的頻道詳細資料。

  3. 在 [應用程式] 底下,確認您看到剛建立的 Bot。 如果您沒有看到它,請單擊 添加應用程序 並添加它。

擷取驗證認證

您需要 Slack 應用程式中的下列資訊,才能設定 Azure Databricks 通知目的地:

  1. 機器人用戶 OAuth 代幣:
    • 導覽至 Slack 應用程式設定中的 OAuth 和權限 。
    • 複製 Bot 使用者 OAuth 權杖。
  2. Webhook 網址:
    • 導覽至 Slack 應用程式設定中的 傳入 Webhooks 。
    • 複製目的地通道的 Webhook URL 。

取得 Slack 頻道 ID

  1. 在您的 Slack 工作區中,導覽至目的地頻道。
  2. 按一下頻道名稱以開啟頻道詳細資料。
  3. 從頻道詳細資料複製 頻道 ID 。

步驟 2:在 Azure Databricks 中設定通知目的地

在指向 Slack 通道的 Azure Databricks 工作區中建立通知目的地。

  1. 登入您的 Azure Databricks 工作區。
  2. 按一下工作區右上角的使用者名稱。
  3. 從下拉式清單中選取 設定 。
  4. 在 [工作區管理員] 區段中,按下 [通知] 索引標籤 。
  5. 在通知目的地區段中按一下管理。
  6. 按一下 新增目的地。
  7. 從目的地型別下拉式清單中選取 Slack 。
  8. 輸入下列資訊:
    • 目的地名稱:此 Slack 目的地的描述性名稱
    • Slack Webhook URL:來自你 Slack 應用程式的 webhook 網址
    • OAuth 權杖:來自 Slack 應用程式的機器人使用者 OAuth 權杖
    • Slack 頻道 ID:你 Slack 工作區的頻道 ID
  9. 點擊 建立。

使用者現在可以將此Slack通知目的地新增為儀表板排程的訂閱者。

關於如何將 Slack 頻道訂閱到儀表板排程的說明,請參閱 訂閱 Slack 或 Microsoft Teams 頻道。

故障排除

使用下列方法來疑難排解 Slack 通知的常見錯誤。

缺少 PDF 附件

如果 Slack 通知顯示時沒有 PDF 附件,請確認:

  • OAuth權杖已在通知目的地中正確設定
  • 通道ID與目的地通道相符
  • Slack 應用程式具有所需的 files:write 範圍

通知未出現

如果通知未出現在您的 Slack 頻道中:

  • 確認 Webhook URL 正確且符合目的地通道
  • 檢查工作區中是否已安裝 Slack 應用程式
  • 確保機器人已新增至目的地頻道
  • 確認排程處於作用中且未暫停

後續步驟