數(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è)從版本控制中也可以找到股淡,但是這些這里更直觀一些。