實(shí)時(shí)計(jì)算模板指進(jìn)行實(shí)時(shí)數(shù)據(jù)研發(fā)過(guò)程中實(shí)時(shí)計(jì)算任務(wù)開(kāi)發(fā)所提供的模板，可提高研發(fā)效率。本文為您介紹如何新建及管理實(shí)時(shí)計(jì)算模板。

應(yīng)用場(chǎng)景

基本場(chǎng)景下，實(shí)時(shí)計(jì)算任務(wù)需24小時(shí)不間斷運(yùn)行，以保證數(shù)據(jù)產(chǎn)出的實(shí)效性。在該要求下實(shí)時(shí)任務(wù)的穩(wěn)定性、低延遲及高容災(zāi)變得尤為重要。為解決如上需求，通常在生產(chǎn)環(huán)境中通過(guò)雙鏈路及以上實(shí)現(xiàn)實(shí)時(shí)任務(wù)的主備容災(zāi)處理。相對(duì)的，鏈路數(shù)量的增加將會(huì)導(dǎo)致維護(hù)成本和難度的提高。如在變更任務(wù)時(shí)，需手動(dòng)進(jìn)行變更，非常容易導(dǎo)致變更不一致情況。在該場(chǎng)景下，您可在Dataphin中創(chuàng)建實(shí)時(shí)計(jì)算模板，并在創(chuàng)建實(shí)時(shí)任務(wù)時(shí)引用實(shí)時(shí)計(jì)算模板實(shí)例化任務(wù)。在后續(xù)變更維護(hù)時(shí)，您可通過(guò)編輯維護(hù)實(shí)時(shí)計(jì)算模板的方式，統(tǒng)一維護(hù)多個(gè)實(shí)時(shí)任務(wù)，大大的節(jié)省了開(kāi)發(fā)維護(hù)成本和降低了變更風(fēng)險(xiǎn)。

操作步驟

1. 請(qǐng)參見(jiàn)數(shù)據(jù)開(kāi)發(fā)入口，進(jìn)入數(shù)據(jù)開(kāi)發(fā)頁(yè)面。

2. 在數(shù)據(jù)開(kāi)發(fā)頁(yè)面，按照下圖操作指引，進(jìn)入新建模板對(duì)話框。

   

3. 在新建模板對(duì)話中，配置參數(shù)。

   參數(shù)	描述
   模板名稱	請(qǐng)輸入模板名稱，新建后不可修改。僅支持英文字母、數(shù)字、下劃線（_）、連接符（-）。
   選擇目錄	選擇模板所屬目錄。若無(wú)對(duì)應(yīng)所需目錄。您可按照下圖操作指引新建文件夾。
   描述	填寫(xiě)模板的簡(jiǎn)單描述，1000字符內(nèi)。

4. 單擊確定。

5. 在實(shí)時(shí)計(jì)算模板的代碼開(kāi)發(fā)頁(yè)面，開(kāi)發(fā)實(shí)時(shí)計(jì)算的模板代碼。

   重要

   開(kāi)發(fā)的模板代碼中需至少包含一個(gè)參數(shù)，才可正常編譯和提交。參數(shù)格式：@@{參數(shù)名稱}。

   

   說(shuō)明

   您可以單擊頁(yè)面右上方的按鈕，系統(tǒng)自動(dòng)調(diào)整SQL代碼格式。

6. 模板代碼編寫(xiě)完成后，單擊頁(yè)面左上方的按鈕，并在參數(shù)填寫(xiě)對(duì)話框中選擇引擎版本和填寫(xiě)參數(shù)值。

   參數(shù)	描述
   引擎版本	選擇預(yù)編譯代碼的引擎版本。
   參數(shù)填寫(xiě)	填寫(xiě)用于預(yù)編譯的參數(shù)值。若不配置參數(shù)值，可勾選填寫(xiě)空值或全部為空值。

7. 單擊確定，校驗(yàn)代碼任務(wù)的語(yǔ)法及權(quán)限問(wèn)題。

   說(shuō)明

   • 預(yù)編譯成功，在頁(yè)面上方出現(xiàn)彈窗。

   • 預(yù)編譯失敗，在頁(yè)面上方出現(xiàn)彈窗，單擊頁(yè)面底部Console，查看預(yù)編譯失敗日志。

7. 完成開(kāi)發(fā)及預(yù)編譯后，您需為實(shí)時(shí)計(jì)算模板配置參數(shù)的說(shuō)明信息和默認(rèn)值。按照下圖操作指引，在屬性彈框中，配置參數(shù)。

   

   參數(shù)	描述
   參數(shù)說(shuō)明	輸入?yún)?shù)的說(shuō)明信息。128個(gè)字符以內(nèi)。
   默認(rèn)值	填寫(xiě)參數(shù)的默認(rèn)值。

   說(shuō)明

   Dataphin支持在實(shí)時(shí)模板中配置運(yùn)行參數(shù)信息，基于當(dāng)前實(shí)時(shí)模板創(chuàng)建的實(shí)時(shí)任務(wù)將繼承所配置運(yùn)行參數(shù)。具體操作，請(qǐng)參見(jiàn)配置實(shí)時(shí)模板運(yùn)行參數(shù)。

8. 單擊頁(yè)面左上方的按鈕，并在提交代碼模板對(duì)話框中填寫(xiě)版本名稱及備注信息。

9. 單擊確定并提交。

后續(xù)步驟

發(fā)布成功后，您可在運(yùn)維中心查看并管理實(shí)時(shí)計(jì)算模板任務(wù)。詳情請(qǐng)參見(jiàn)查看并管理實(shí)時(shí)任務(wù)。