操作

「操作」區包含執行批次 Label Jobs 及查看結果的工具。這些操作可能一次影響大量 Entities，因此 Osprey 提供防護措施，協助降低非預期影響。

Bulk Actions

Bulk Actions 可以為符合目前查詢條件的每個 Entity 套用 Label。當團隊已辨識出明確模式，並需要一次處理多個 Entities 時，可以使用這項功能。

Warning

批次 action 的 false positive 可能讓大量 Entities 被錯誤套用 Labels。確認 Job 前，務必先檢查 Entity 數量。

啟動批次 action

有兩種方式可以啟動批次 action。

1. 前往 Bulk Actions → Create New Job，從包含 Entities 的上傳檔案建立 Job
2. 在 Query 頁面使用圖表欄的 bulk label drawer，系統會自動填入目前 session 的查詢

提交前，Osprey 會顯示即將套用 Label 的 unique Entities 數量。請仔細檢查這個數字，理解批次 action 的影響範圍。

若要從 command line 以 script 或批次方式套用 Labels，例如匯入外部來源的 Label 清單，請參考英文官方文件 CLI Reference 中的 apply_label 與 bulk_apply_label。

每個 Label Job 包含下列設定。

• 要套用的 Label 及其 status
• 所有 Label 操作都必須提供的原因
• 選填的到期時間

標準批次 Jobs 的上限為 100,000 個 Entities。表單提供核取方塊，可以移除限制以執行更大型的 Jobs。

治理提醒

移除數量上限前，應先使用較小範圍驗證查詢、抽樣檢查 Entities，並確認取消、回復、權限與稽核方式。介面顯示的數量只能協助判斷影響範圍，無法取代複核。

監看 Jobs

Bulk Actions 頁面會以表格列出所有 Jobs，包括 ID、status、progress percentage、建立者及建立時間。仍在執行的 Jobs 會顯示 cancel 按鈕。

頁面會自動輪詢更新，不需要手動重新整理即可看到進度。

Bulk Job History

Bulk Job History 頁面提供過去批次 Jobs 的詳細檢視。

頁面包含兩欄。

• 近期批次 Jobs，包含 status、progress 與 summary statistics，並可依 task ID 篩選
• 單一 Job 的詳細檢視，包含完整結果與 logs

若要尋找特定 Job，請在搜尋欄位輸入 task ID。每個批次 Job 都有 unique ID，並會在建立 Job 時寫入 log。