概觀
根據 Chains 工件的最佳實踐,建議為 Wdata 工件(例如 Tables 和 Queries)實施一致的命名約定,以便於更輕鬆地導航和管理。此處提供的準則旨在説明您從一開始就一致地組織工件。
事實 數據表和 維度 表
事實數據表通常包含隨時間累積的數據,而維度表存儲為數據提供額外上下文的補充數據集。在命名這兩種類型的表時,請考慮以下最佳實踐:
- 命名約定: 使用一致的命名約定,清楚地表明事實表和維度表的用途和內容。
- 描述性名稱: 將描述性名稱應用於這兩種類型的表,以確保它們易於識別和理解。
- Source System: 在名稱中包含數據的原始系統。
例子:
-
事實表: 試算表 - Workday
描述: 存儲 Avikro Financial 的試算表交易數據,這些數據源自 Workday。 -
維度表: 會計科目表 - Workday
描述: 存儲 Avikro Financial 的會計科目表數據,數據源自 Workday。 -
維度表: 利潤中心 - SAP
描述: 存儲源自 SAP 的 Avikro Financial 的利潤中心資訊。 -
維度表: 匯率 - 中央銀行 API
描述: 提供 Avikro Financial 的貨幣兌換率,來源於中央銀行 API。
此範本可確保事實表和維度表的命名約定、描述性清晰度以及源系統的準確標識。
Wdata 查詢
在定義 Queries 的命名約定時,必須保持標準方法。這可確保使用者可以輕鬆識別用於檢索特定數據的正確查詢。
- 命名約定: 使用一致的命名約定,明確定義 Query 的用途和內容。
- Descriptive Names: 將描述性名稱應用於 Queries,以便於識別和理解。
- 源系統: 指定數據的原始系統。
例:
-
查詢名稱: 擴展試算表 - Workday - 財務報表
描述: 此查詢從 Workday 檢索試算表數據,其中包含為生成財務報表而定製的補充數據集。
注意:避免在表格和查詢中使用管道分隔符(|)非常重要。相反,請使用連字元 (-) 來防止這些工件出現任何潛在問題。
遵循此命名約定還將明確在創建到 Spreadsheet 的傳入 Connection 時應該使用哪個 Query。
描述
描述通常是設計和構建過程中最容易被忽視的部分,但它們對於提高理解和可用性至關重要。描述應提供額外的上下文,例如:
- 指示 Table 或 Query 是否為佔位元。
- 注意 Query 是否需要在使用前進行編輯。
- 闡明 Query 等工件的特定功能,例如識別比上一週期低 20% 以下的付款。
通過包含清晰詳細的描述,使用者可以快速掌握每個工件的用途和內容,從而減少混淆,最大限度地減少錯誤,並提高管理 Wdata 環境的整體效率。
資料夾/環境
在組織工作區時,建議根據其預期用途將表和查詢分類到資料夾中。此結構使用戶能夠輕鬆導航並確定哪些工件被指定為 Development、Testing 和 Production。
由於 Wdata 目前不支援開箱即用的 Application Lifecycle Management,因此建議將名稱附加到構件和資料夾以指示它們各自的環境。這有助於管理應用程式生命週期並避免任何錯誤或問題。請注意,生產構件不需要附加名稱。