使用限制

DataWorks目前僅支持華東1（杭州）、華東2（上海）、華北2（北京）、華北3（張家口）、華南1（深圳）、西南1（成都）、中國香港、新加坡、馬來西亞（吉隆坡）、印度尼西亞（雅加達）、德國（法蘭克福）、英國（倫敦）、美國（硅谷）、美國（弗吉尼亞）地域的工作空間使用函數計算功能。

步驟一：創建事件函數

1. 登錄函數計算3.0控制臺，當左上角顯示函數計算 FC 3.0時，表示當前控制臺為3.0控制臺。

   

2. 在左側導航欄，單擊函數，在頂部導航欄切換至目標地域，在函數頁面單擊創建函數。

3. 選擇事件函數并配置函數信息，高級配置、環境變量可根據實際情況進行設置。詳情可參見創建事件函數。

   

4. 單擊創建，在函數詳情頁簽的代碼頁面編輯index.py，輸入發送郵件的業務邏輯代碼，示例代碼如下：

   重要

   • 以下示例代碼中的mail_host、mail_port、mail_username、mail_password、mail_sender、mail_receivers參數請根據實際情況設置。

   • 電子郵件的賬號必須開啟SMTP服務。某些電子郵件服務提供商默認未開啟，需自行檢查并開啟。例如：163郵箱默認就未開啟SMTP服務。

   • 某些電子郵件服務提供商基于安全原因，可能會使用一種類似授權碼的專用密碼，用于三方郵件客戶端進行登錄。這時mail_password需設置為授權碼而不是賬號密碼。例如：163郵箱就存在授權碼，且三方登錄時必須使用授權碼來作為密碼登錄。

   # -*- coding: utf-8 -*-
   import logging
   import json
   import smtplib
   from email.mime.text import MIMEText
   
   def handler(event, context):
     evts = json.loads(event)
   
     logger = logging.getLogger()
     logger.info('event: %s', evts)
     mail_host = 'smtp.163.com'                 ## 郵箱服務地址
     mail_port = '465';                         ## 郵箱smtp協議端口號
     mail_username = 'sender_****@163.com'      ## 登錄用戶名
     mail_password = 'EWEL******KRU'            ## 登錄用戶密碼
     mail_sender = 'sender_****@163.com'        ## 發件人郵箱地址
     mail_receivers = ['receiver_****@163.com'] ## 收件人郵箱地址
   
     mail_content=generate_mail_content(evts)
     message = MIMEText(mail_content,'plain','utf-8')
     message['Subject'] = 'mail test'
     message['From'] = mail_sender
     message['To'] = mail_receivers[0]
     smtpObj = smtplib.SMTP_SSL(mail_host + ':' + mail_port)
     smtpObj.login(mail_username,mail_password)
     smtpObj.sendmail(mail_sender,mail_receivers,message.as_string())
     smtpObj.quit()
     return 'mail send success'
   
   def generate_mail_content(evt):
     mail_content=''
     if 'msg' in evt.keys():
         mail_content=evt['msg']
     else:
         logger = logging.getLogger()
         logger.error('msg not present in event')
     '''
     此處可增加處理郵件內容讀取邏輯
     '''
     return mail_content

5. 單擊部署代碼按鈕。

步驟二：（可選）測試函數

通過配置創建新測試事件參數，模擬測試。

1. 在函數詳情頁面的代碼頁簽，單擊測試函數右側的圖標，從下拉列表中，選擇配置測試參數。

   在配置測試參數面板，選擇創建新測試事件或編輯已有測試事件，輸入參數，點擊確定。

   

   事件內容輸入：

   {
       "msg": "This is a test message"
   }

2. 單擊測試函數即可完成測試。

   

3. 檢查收件人的郵箱中是否收到郵件。

   說明

   某些電子郵件服務器可能會將未知發件人識別為垃圾郵件從而進行攔截，因此若您未在收件箱中找到測試郵件，則需到垃圾郵件中進行查找。

步驟三：在DataWorks中創建并配置函數計算節點

1. 登錄DataWorks控制臺，單擊左側導航欄中的工作空間。

2. 將頁面頂部導航欄的地域列表切換為步驟一：創建事件函數中指定的地域。

3. 在工作空間列表中單擊目標工作空間名稱，進入工作空間詳情頁面。若您在當前地域下無工作空間，則需創建一個工作空間，詳情可參見創建工作空間。

4. 單擊左側導航欄中的數據開發與治理下的數據開發，進入DataWorks數據開發頁面。

5. 單擊目標業務流程名稱，在其展開的通用節點上右鍵單擊并選擇函數計算。在創建節點彈出框中輸入節點名稱并單擊確定按鈕，完成函數計算節點的創建。

   

6. 設置函數計算節點參數。

   

   參數	描述
   選擇函數	選擇步驟一：創建事件函數的函數名稱。
   選擇版本或別名	選擇調用函數時所使用的版本或別名，默認版本為LATEST。更多請見版本管理和別名管理。
   調用方式	本文選擇同步。調用方式詳情可參見同步調用、異步調用。
   變量	調用函數的參數。本文示例如下： { "msg": "This is a test message from dataworks!" }

7. （可選）調試函數計算節點。節點配置完成后，您可單擊圖標，為代碼變量賦值常量進行調試運行，測試節點代碼邏輯是否正確。

8. 配置節點的周期調度屬性。DataWorks提供的調度參數，可實現調度場景下代碼動態傳參。打開右側的調度配置，在參數區域設置參數。更多調度參數的配置，請參見調度參數支持的格式。更多調度屬性，請參見任務調度屬性配置概述。