說說數(shù)倉(10)-任務(wù)注釋


數(shù)倉總結(jié)目錄:
說說數(shù)倉(1) - 什么是數(shù)倉
說說數(shù)倉(2) - 傳統(tǒng)數(shù)倉與互聯(lián)網(wǎng)數(shù)倉
說說數(shù)倉(3) - 數(shù)倉架構(gòu)
說說數(shù)倉(4) - 指標(biāo)字典
說說數(shù)倉(5)-最重要的維度之日期維度
說說數(shù)倉(6)-關(guān)于命名規(guī)范
說說數(shù)倉(7)-淺談數(shù)據(jù)治理
說說數(shù)倉(8)-關(guān)于增量
說說數(shù)倉(9)-上下游約定
說說數(shù)倉(10)-任務(wù)注釋


這一篇說說注釋饮醇,注釋總是讓人又愛又恨它抱。
沒有注釋,誰知道你這些代碼是用來干嘛的驳阎,從代碼角度來看抗愁,你想做的是A,而實(shí)際上需求確是B呵晚,具體干啥得靠猜蜘腌;
代碼有注釋,也不一定就可以高枕無憂饵隙,注釋可能是最初版的需求撮珠,改了幾版后,代碼早就變了金矛,注釋沒有變芯急,注釋和代碼不匹配,誰知道該以哪個(gè)為準(zhǔn)啊驶俊。

我們的數(shù)倉都是基于阿里云的娶耍,使用了它的DataWorks作為離線工具,所有的代碼都在這上面饼酿,所以這里簡(jiǎn)單介紹下榕酒,在阿里云上的任務(wù),幾點(diǎn)注釋規(guī)范故俐。

--    @name p_dwd_rack_machine
--    @description 貨架寬表
--    @target rack.dwd_rack_machine
 
--    @source owo_ods.kylin__machine_release_his
--    @source owo_ods.kylin__machine_device_his
 
--    @author yuguiyang 2017-12-25
--    @modify

@name:任務(wù)的名字想鹰,我們的任務(wù)名一般都是以 p_目標(biāo)表名,后來阿里的DataWorks升級(jí)后药版,推薦是任務(wù)名和表名保持一致辑舷。

@description:任務(wù)描述,該任務(wù)的主要內(nèi)容
@target:目標(biāo)表名槽片,一般一個(gè)任務(wù)只輸出一個(gè)目標(biāo)表

@source:來源表何缓,就是任務(wù)中使用的底層表,這里也可以省略筐乳,從血緣關(guān)系中可以直接看到歌殃,而且很容易漏更新

@author:創(chuàng)建者,和創(chuàng)建日期蝙云,
@modify:內(nèi)容變更記錄氓皱,變更人,變更日期,變更原因 波材,這個(gè)從版本控制中也可以找到股淡,但是這些這里更直觀一些。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末廷区,一起剝皮案震驚了整個(gè)濱河市唯灵,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌隙轻,老刑警劉巖埠帕,帶你破解...
    沈念sama閱讀 216,470評(píng)論 6 501
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異玖绿,居然都是意外死亡敛瓷,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,393評(píng)論 3 392
  • 文/潘曉璐 我一進(jìn)店門斑匪,熙熙樓的掌柜王于貴愁眉苦臉地迎上來呐籽,“玉大人,你說我怎么就攤上這事蚀瘸〗频” “怎么了?”我有些...
    開封第一講書人閱讀 162,577評(píng)論 0 353
  • 文/不壞的土叔 我叫張陵贮勃,是天一觀的道長(zhǎng)贪惹。 經(jīng)常有香客問我,道長(zhǎng)寂嘉,這世上最難降的妖魔是什么馍乙? 我笑而不...
    開封第一講書人閱讀 58,176評(píng)論 1 292
  • 正文 為了忘掉前任,我火速辦了婚禮垫释,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘撑瞧。我一直安慰自己棵譬,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,189評(píng)論 6 388
  • 文/花漫 我一把揭開白布预伺。 她就那樣靜靜地躺著订咸,像睡著了一般。 火紅的嫁衣襯著肌膚如雪酬诀。 梳的紋絲不亂的頭發(fā)上脏嚷,一...
    開封第一講書人閱讀 51,155評(píng)論 1 299
  • 那天,我揣著相機(jī)與錄音瞒御,去河邊找鬼父叙。 笑死,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的趾唱。 我是一名探鬼主播涌乳,決...
    沈念sama閱讀 40,041評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼甜癞!你這毒婦竟也來了夕晓?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 38,903評(píng)論 0 274
  • 序言:老撾萬榮一對(duì)情侶失蹤悠咱,失蹤者是張志新(化名)和其女友劉穎蒸辆,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體析既,經(jīng)...
    沈念sama閱讀 45,319評(píng)論 1 310
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡躬贡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,539評(píng)論 2 332
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了渡贾。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片逗宜。...
    茶點(diǎn)故事閱讀 39,703評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖空骚,靈堂內(nèi)的尸體忽然破棺而出纺讲,到底是詐尸還是另有隱情,我是刑警寧澤囤屹,帶...
    沈念sama閱讀 35,417評(píng)論 5 343
  • 正文 年R本政府宣布熬甚,位于F島的核電站,受9級(jí)特大地震影響肋坚,放射性物質(zhì)發(fā)生泄漏乡括。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,013評(píng)論 3 325
  • 文/蒙蒙 一智厌、第九天 我趴在偏房一處隱蔽的房頂上張望诲泌。 院中可真熱鬧,春花似錦铣鹏、人聲如沸敷扫。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,664評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽葵第。三九已至,卻和暖如春合溺,著一層夾襖步出監(jiān)牢的瞬間卒密,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 32,818評(píng)論 1 269
  • 我被黑心中介騙來泰國(guó)打工棠赛, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留哮奇,地道東北人膛腐。 一個(gè)月前我還...
    沈念sama閱讀 47,711評(píng)論 2 368
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像屏镊,于是被迫代替她去往敵國(guó)和親依疼。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,601評(píng)論 2 353