Data Agent 沙箱管理 - DataWorks

功能概述

Data Agent 執行任務時，需要一個可運行代碼、讀寫檔案、訪問資料來源的執行環境。沙箱將底層的計算資源和運行環境封裝為一個可直接使用的對象：您無需瞭解專用網路、交換器等雲資源概念，在會話中選擇一個沙箱即可開始工作；管理員可在控制台統一管理所有沙箱的成本與許可權。

Data Agent 提供兩類沙箱，分別適用於不同的使用情境：

會話式沙箱：隨會話自動建立和釋放的臨時執行環境，無需手動操作，目前僅支援Data Integration、資料治理、資料品質、營運中心、語義圖譜模組。
持久化沙箱：面向主 Data Agent的長期執行環境，支援自訂 CU、網路等配置，可反覆啟停。

兩類沙箱及相關術語的詳細說明，請參見下文核心概念。

核心概念

術語	說明
沙箱（Sandbox）	將底層計算資源和運行環境封裝為可直接使用的對象，是使用者在會話中選擇和執行任務的承載單元。
會話式沙箱	在各模組啟用 Data Agent 時使用的臨時沙箱，開啟會話後系統自動建立，會話結束後自動釋放。目前僅支援Data Integration、資料治理、資料品質、營運中心、語義圖譜模組。
持久化沙箱	長期存在的沙箱（含預設沙箱與使用者主動建立的自訂沙箱），建立時可指定 CU、Virtual Private Cloud和交換器（vSwitch），可反覆啟停；啟用空閑自動停機後，停機期間不計費，再次啟動時配置與檔案保留。持久化沙箱面向主 Data Agent。
預設沙箱	使用者首次進入 Data Agent 時系統自動建立的持久化沙箱（預設 4 CU、30 分鐘空閑停機），用於承接首個任務，免去手工配置。建立後與使用者自建的持久化沙箱一致，可修改或刪除。
CU	計算單元（Compute Unit），沙箱的算力規格和計費單位。
空閑自動停機	自最後一次活躍心跳起，無活動達到設定時間長度後自動停止沙箱執行個體並停止計費。最低 10 分鐘；填 0 或留空表示不啟用。

建立沙箱

沙箱有三種擷取方式：會話式沙箱由系統隨會話自動建立；首次進入主 Data Agent 時，系統自動建立預設持久化沙箱；如需自訂規格，您也可以手動建立自訂持久化沙箱。

會話式沙箱（自動建立）

會話式沙箱在各模組啟用 Data Agent 時自動建立，全程無需手動操作：當您在模組的 Data Agent 下開啟會話後，系統會自動建立一個會話式沙箱作為任務執行環境；會話結束後自動釋放。

重要

目前僅支援Data Integration、資料治理、資料品質、營運中心、語義圖譜模組。

持久化沙箱

重要

持久化沙箱功能目前僅在西南1（成都）地區開放，其他地區將陸續開通並另行通知。

當您開通 Data Agent 後首次進入時，如果名下沒有任何可用沙箱，系統會在後台自動建立一個預設持久化沙箱（預設 4 CU、30 分鐘空閑自動停機）用於承接首個任務，全程無需手工配置。如果預設沙箱無法滿足需求，您可以手動建立自訂持久化沙箱。

操作步驟

在主 Data Agent 會話輸入框的底欄，單擊沙箱選取器，然後單擊建立沙箱。

在彈出的建立對話方塊中，配置以下參數：

參數	是否必填	說明
沙箱名稱	是	沙箱的顯示名稱，預設為 `Sandbox_data_dev`。建立後可修改。
空閑自動停機	否	空閑多少分鐘後自動停機（單位：分鐘）。預設 30 分鐘，最低 10 分鐘。填 0 或留空表示不啟用空閑停機。停機後不再計費，配置與檔案保留。
規格（CU）	是	沙箱的計算單元配額。預設 4 CU，不能超過管理員設定的單沙箱 CU 上限。

單擊建立。

說明
建立自訂持久化沙箱需要管理員為您開通沙箱建立許可權。如果建立入口置灰，請聯絡管理員開通。

使用沙箱

在主 Data Agent 會話中執行任務時，您可以通過沙箱選取器選用合適的持久化沙箱；會話式沙箱由系統自動建立和承接，無需選擇。

在會話中選擇和切換沙箱

通過主 Data Agent 進行會話時，可在輸入框底欄的沙箱選取器中查看和切換當前可用的持久化沙箱：

沙箱列表：下拉式清單展示當前可用的持久化沙箱，包括名稱、運行狀態和 CU 規格。
狀態指示：通過顏色區分沙箱狀態——綠色表示運行中、灰色表示已停機、黃色脈衝表示啟動中/停止中/變更配置中、紅色表示失敗、橙色表示刪除中。
建立入口：在下拉式清單中單擊建立沙箱可快速建立持久化沙箱。

管理沙箱

登入 DataWorks 控制台，在左側導覽列選擇沙箱管理 > 沙箱，即可進入沙箱列表頁面。
在沙箱管理頁面，您可以查看和管理自己的沙箱、查看沙箱監控。管理員還可查看團隊所有沙箱並配置資源策略。

沙箱生命週期

在沙箱列表中，您可以查看每個沙箱當前的運行狀態。沙箱在其生命週期中可能處於以下狀態：

狀態	說明
建立中	沙箱正在建立底層資源，建立完成後自動轉為啟動中。
啟動中	沙箱正在啟動運行環境，就緒後轉為運行中。
運行中	沙箱已就緒，可承接和執行任務。運行態下可查看 CPU、記憶體、磁碟等監控資料。
停止中	沙箱正在停止，通常由手動停機或空閑自動停機觸發。
已停機	沙箱已停止運行，不再計費。配置與檔案保留，可隨時再次啟動。
刪除中	沙箱正在刪除，底層資源正在釋放。刪除完成後沙箱將從列表中移除。
變更配置中	沙箱正在變更 CU 規格。變更配置實質為重建底層沙箱，完成後按新規格啟動。
失敗	沙箱建立或啟動失敗，可查看錯誤資訊或聯絡管理員。

說明

運行中的沙箱在空閑達到設定時間長度（預設 30 分鐘）後會自動停機，停機後不再計費。停機沙箱被再次選擇或發起任務時，將自動重新啟動，配置與上下文保留。

查看沙箱列表

在沙箱頁簽下，您可以查看三個關鍵計量：沙箱總數（團隊累計的持久化沙箱數量）、運行中沙箱數（當前處於運行狀態的沙箱數量）、總佔用 CU（所有運行中沙箱的 CU 之和）。

下方的沙箱列表展示所有沙箱的名稱、擁有者、狀態、CU 和最後啟用時間。您可以通過名稱或擁有者搜尋沙箱，並在操作列對沙箱執行以下動作：

操作	說明
查看	進入沙箱詳情頁，查看基本資料、監控指標、會話列表和動作記錄。
停機/啟動	手動停止運行中的沙箱，停機後不再計費，配置與檔案保留；已停機的沙箱可再次啟動，恢複承接任務。
刪除	永久刪除沙箱，釋放底層資源。刪除操作不可撤回。運行中的沙箱需先停機後再刪除。

查看沙箱詳情

在沙箱列表中單擊查看，可進入沙箱詳情頁。在該頁面中，您可以查看以下資訊：

基本資料：沙箱名稱、ID、擁有者、狀態、計費方式、當前佔用 CU、建立日期、空閑停機時間長度、專用網路和交換器。
監控指標：展示 CPU 使用率、記憶體使用量率和磁碟使用率的即時數值，並以時間序列曲線圖呈現歷史趨勢，支援自訂時間範圍。頁面右上方提供刪除沙箱的快捷入口。
會話列表：展示該沙箱當前承接的會話（會話名稱、發起人、佔用 CU、開始時間等），支援查看或終止會話。
動作記錄：記錄沙箱的建立、啟停、變更配置、轉交等操作歷史，保留近 90 天。

說明

CU 規格變更在下次啟動時生效；空閑停機時間長度儲存後即時生效。

配置策略

在左側導覽列單擊配置策略，管理員可設定團隊成員的沙箱資源上限。您可配置以下兩類策略：

單帳號預設策略：設定團隊級預設邊界，單擊編輯可修改以下參數：

參數	說明
最大沙箱數	每個使用者可擁有的沙箱總數上限。
最大運行 CU	每個使用者所有運行中沙箱的 CU 總和上限。
單沙箱 CU 上限	單個沙箱允許配置的最大 CU 數。建立或變更沙箱時以此為上限校正基準。
預設空閑停機（分鐘）	沙箱無活動後自動停機的預設時間長度，停機後不再計費。

單帳號例外策略：為特定子帳號單獨設定與預設策略不同的參數，覆蓋團隊預設值。單擊添加單帳號例外即可添加。未配置例外的帳號均使用單帳號預設策略。

重要

管理員對預設策略和單帳號例外的修改即時生效，會影響後續的建立和變更操作。

RAM IP 白名單允許存取

除控制台中的沙箱資源策略外，如果您已通過 RAM 自訂權限原則限制 RAM 使用者只能從特定 IP 訪問 DataWorks（即啟用了 RAM IP 白名單），還需將沙箱網段一併加入白名單，以確保沙箱能夠正常調用 DataWorks 服務執行任務。由於沙箱以自身網段的 IP 訪問 DataWorks，當白名單未包含這些網段時，相關請求會落在 Deny 語句的限制範圍內，任務會因許可權校正未通過而無法執行。

需允許存取的網段如下，兩個網段均需添加：

網段	說明
21.80.0.0/12	Data Agent 沙箱出口網段
21.224.0.0/12	Data Agent 沙箱出口網段

說明

會話式沙箱與持久化沙箱均從上述網段發起請求，無需為單個沙箱單獨允許存取。
沙箱的啟停、變更配置、刪除不會改變該網段，一次允許存取後無需隨沙箱變更維護。

配置樣本

在原有辦公網 IP 白名單的基礎上追加沙箱網段，其中 203.0.113.10 為允許訪問 DataWorks 的辦公網出口 IP，請替換為您的實際 IP：

{
    "Version": "1",
    "Statement": [
        {
            "Effect": "Deny",
            "Action": [
                "dataworks:*"
            ],
            "Resource": [
                "acs:dataworks:*:*:*"
            ],
            "Condition": {
                "NotIpAddress": {
                    "acs:SourceIp": [
                        "203.0.113.10",
                        "21.80.0.0/12",
                        "21.224.0.0/12"
                    ]
                }
            }
        }
    ]
}

重要

請以追加方式修改策略，不要用沙箱網段替換原有的辦公網 IP，否則您將無法從本地訪問 DataWorks。權限原則的建立與授權步驟，請參見RAM使用者僅從特定IP登入DataWorks。

計費說明

沙箱沿用 Data Agent 現有的隨用隨付口徑，不單獨產生計費賬單。

運行期間：沙箱從建立或啟動時刻開始計費，到停止或刪除時刻結束，按實際運行時間長度和 CU 規格計費。
停機期間：沙箱停機後不再計費。多次啟停產生的多個活躍時間段累計計費。
空閑自動停機：開啟空閑自動停機後，沙箱在空閑達到設定時間長度後自動停機並停止計費，有效降低閑置成本。
規格變更：變更配置 CU 後，新規格在下次啟動時生效，並按新規格的單價計費。

詳細的計費規則和單價，請參見Data Agent 費用。