DataWorks：自訂鏡像

適用範圍

• 版本限制：

  • 所有版本均可建立和使用自訂鏡像。

  • 僅專業版及以上版本支援鏡像構建能力。

• 資源群組限制：鏡像功能僅支援Serverless資源群組。

  舊版資源群組請使用營運助手安裝外部依賴。

• 許可權限制：擁有AliyunDataWorksFullAccess或ModifyResourceGroup權限原則。

  授權詳情請參見產品及控制台許可權控制詳情：RAM Policy。

配額與限制

• 鏡像數量：不同DataWorks版本，支援建立的自訂鏡像數量上限不同。

  • 基礎版和標準版：10個。

  • 專業版：50個。

  • 企業版：100個。

• 構建並發：每個地區最多支援 2 個鏡像同時進行構建。

• ACR 鏡像要求：

  • 執行個體版本：僅支援企業版的阿里雲ACR執行個體。

  • 執行個體架構：僅支援AMD64架構。

  • 鏡像大小：單個鏡像大小不能超過5GB。

  • 時區配置：需要安裝時區相關的基礎包tzdata，避免因與DataWorks設定的時區不一致導致容器異常退出。

• 鏡像構建：僅支援基於 DataWorks 官方鏡像建立的自訂鏡像。引用阿里雲 ACR 鏡像建立的自訂鏡像不支援持久化構建，每次運行任務時均需重新拉取和部署。

• 支援的節點類型與對應方式：

  節點類型	直接基於官方鏡像構建	引用ACR鏡像構建
  PyODPS2	支援	不支援
  PyODPS3	支援	不支援
  EMR Spark	支援	不支援
  EMR Spark SQL	支援	不支援
  EMR SHELL	支援	不支援
  Shell	支援	支援
  Python	支援	支援
  Notebook	不支援	支援
  CDH	支援	不支援
  賦值節點	支援	不支援

操作流程

計費說明

構建鏡像會按照CU數量 × 構建時間長度收取計算費用，系統預設分配0.5CU。計費詳情，請參見Serverless資源群組計費標準。

應用於生產

為確保在生產環境中穩定、高效、經濟地使用自訂鏡像，請參考以下建議。

• 持久化鏡像：建議對發行且配置穩定的鏡像進行鏡像構建，形成持久化鏡像。這樣可避免任務每次運行時都重新安裝依賴，從而縮短啟動時間、降低計算成本並提高穩定性。

• 環境一致性：確保用於測試、構建和生產調度的Serverless 資源群組所綁定的VPC和網路設定一致，尤其是在訪問私人 ACR 倉庫或公網時。

• 版本鎖定：在通過 Script方式安裝依賴時，強烈建議明確指定版本號碼（如 pip install pandas==1.5.3），避免上遊庫更新導致非預期的行為變更。

• 復原方案：如果更新鏡像後生產任務失敗，可通過任務發布歷史復原到上一個版本，或在調度配置中將鏡像重新指向舊的、穩定的版本。

情境實踐案例

本實踐示範如何通過PyODPS節點使用鏡像實現中文分詞能力。假設需要對MaxCompute表中的某一列中文資料進行分詞，然後將分詞結果存入另一張表中，用於下遊調度節點使用。您可在自訂鏡像中預裝jieba分詞工具包，然後通過PyODPS任務使用該鏡像對資料表中的中文資料進行分詞處理，並將結果儲存至新表，無縫整合至下遊調度流程。

1. 建立測試資料。

   1. 建立DataWorks工作空間綁定MaxCompute計算資源。詳情請參見建立工作空間、計算資源管理。

   2. 在資料開發中，建立ODPS節點（舊版資料開發）或MaxCompute SQL節點（新版資料開發），建立測試表並添加測試資料。

      說明

      如下樣本使用了調度參數，請在右側調度配置中設定參數名為bday，參數值為$[yyyymmdd]。

      建立測試表。

      -- 建立測試表
      CREATE TABLE IF NOT EXISTS custom_img_test_tb
      (
          c_customer_id BIGINT NOT NULL,
          c_customer_text STRING NOT NULL,
          PRIMARY KEY (c_customer_id)
      )
      COMMENT 'TABLE COMMENT'
      PARTITIONED BY (ds STRING COMMENT '分區')
      LIFECYCLE 90;
      -- 向表中插入測試資料
      INSERT INTO custom_img_test_tb PARTITION (ds='${bday}') (c_customer_id, c_customer_text) VALUES
      (1, '晚來天欲雪，能飲一杯無？'),
      (2, '月落烏啼霜滿天，江楓漁火對愁眠。'),
      (3, '山重水複疑無路，柳暗花明又一村。'),
      (4, '春眠不覺曉，處處聞啼鳥。'),
      (5, '靜夜思，床前明月光，疑是地上霜。'),
      (6, '海上生明月，天涯共此時。'),
      (7, '舊時王謝堂前燕，飛入尋常百姓家。'),
      (8, '一行白鷺上青天，窗含西嶺千秋雪。'),
      (9, '人生得意須盡歡，莫使金樽空對月。'),
      (10, '天生我材必有用，千金散盡還複來。');

   3. 儲存並發布。

2. 建立自訂鏡像。

   參見建立自訂鏡像，關鍵參數如下：

   • 鏡像名稱/ID：選擇dataworks_pyodps_task_pod，DataWorks PyODPS節點官方鏡像。

   • 支援任務類型：支援PyODPS2、PyODPS 3。

   • 安裝包：選擇Python3和jieba。

3. 發布自訂鏡像並修改歸屬專案空間。具體請參見發布自訂鏡像和修改鏡像歸屬空間。

4. 在調度任務中使用自訂鏡像。

   1. 在資料開發中，建立PyODPS3節點，配置如下內容：

      使用自訂鏡像。

      import jieba
      from odps import ODPS
      from odps.models import TableSchema as Schema, Column, Partition
      # 讀取表資料
      table = o.get_table('custom_img_test_tb')
      partition_spec = f"ds={args['bday']}"
      with table.open_reader(partition=partition_spec) as reader:
          records = [record for record in reader]
      # 對提取的文本進行分詞
      participles = [' | '.join(jieba.cut(record['c_customer_text'])) for record in records]
      # 建立目標表
      if not o.exist_table("participle_tb"):
          schema = Schema(columns=[Column(name='word_segment', type='string', comment='分詞結果')], partitions=[Column(name='ds', type='string', comment='分區欄位')])
          o.create_table("participle_tb", schema)
      # 寫入分詞結果到目標表
      # 定義輸出分區和表
      output_partition = f"ds={args['bday']}"
      output_table = o.get_table("participle_tb")
      # 如果分區不存在，先建立分區
      if not output_table.exist_partition(output_partition):
          output_table.create_partition(output_partition)
      # 將分詞結果寫入表
      record = output_table.new_record()
      with output_table.open_writer(partition=output_partition, create_partition=True) as writer:
          for participle in participles:
              record['word_segment'] = participle
              writer.write(record)

   2. 在右側調度配置中，設定如下關鍵參數：

      • 調度參數：參數名bday，參數值為$[yyyymmdd]。

      • 調度資源群組：選擇Serverless資源群組，與發布鏡像時選擇的測試資源群組相同。

      • 鏡像：選擇發行並綁定了當前工作空間的自訂鏡像。

   3. 節點調試。

      • 如果使用舊版資料開發，請在節點頂部工具列單擊帶參運行（），配置資源群組名稱、运行CU、鏡像和自定義參數，然後單擊運行。

      • 如果使用新版資料開發，請在節點右側回合組態中，配置計算資源、資源組、計算 CU、鏡像和腳本參數，然後在節點頂部工具列單擊運行。

   4. （可選）建立臨時查詢（舊版資料開發）或在個人目錄下建立SQL檔案（新版資料開發），使用如下SQL查詢產出表中是否有資料。

      -- 將<分區日期>替換成具體日期。
      SELECT * FROM participle_tb WHERE ds=<分區日期>;

      查詢成功返回資料時，結果包含 word_segment（分詞結果，各詞以豎線 | 分隔）和 ds（分區日期）兩列，表明產出表中已有資料。

   5. 將PyODPS節點發布至生產環境。

      說明

      資料開發中修改的鏡像不會同步到生產環境中，您需要將任務發布後，才能在生產環境中生效。詳情請參見發布任務（舊版資料開發）或節點/工作流程發布（新版資料開發）。

5. 將自訂鏡像構建為持久化鏡像。具體請參見構建持久化鏡像。

常見問題

Q：Python任務報錯urllib3 v2.0 only supports OpenSSL 1.1.1+。

A：urllib3 v2.0僅支援OpenSSL1.1.1+，可降低urllib3版本以相容OpenSSL。例如，安裝三方包的時候強行指定urllib3的版本：/home/tops/bin/pip3 install urllib3==1.26.16。

相關文檔

• DataWorks官方鏡像。

• 使用Serverless資源群組。

• 基於自建Hadoop叢集進行任務開發。

• MaxCompute PyODPS開發。

附錄：安裝命令參考

如果使用自訂鏡像的script方式配置安裝命令，則可以參考如下命令安裝：

• 如果依賴PyODPS 2節點，請執行如下命令。

  pip install <需要安裝的包> -i  https://pypi.tuna.tsinghua.edu.cn/simple

  pip install <需要安裝的包>

  說明

  執行命令後，如果提示需要升級PIP版本，請執行命令pip install --upgrade pip。

• 如果依賴PyODPS 3節點，請執行如下命令。

  /home/tops/bin/pip3 install <需要安裝的包> -i https://pypi.tuna.tsinghua.edu.cn/simple

  /home/tops/bin/pip3 install <需要安裝的包>

  說明

  • 執行命令後，如果提示需要升級PIP版本，請執行命令/home/tops/bin/pip3 install --upgrade pip。

  • 如果出現報錯/home/admin/usertools/tools/cmd-0.sh:行3: /home/tops/bin/python3: 沒有那個檔案或目錄，請提交工單申請開啟許可權。

  Python公開鏡像源參考如下，可按需切換。

  機構/公司	鏡像地址
  阿里雲 (Aliyun)	https://mirrors.aliyun.com/pypi/simple/ 重要 從阿里雲擷取Python包，無需開通公網訪問能力。
  清華大學 (Tsinghua)	https://pypi.tuna.tsinghua.edu.cn/simple
  中國科學技術大學 (USTC)	https://pypi.mirrors.ustc.edu.cn/simple/