與Chains 工件的最佳實務一致,建議對 Wdata 物件(如表格和查詢)實施一致的命名慣例,以方便導覽和管理。此處提供的指引旨在幫助您從一開始就以一致的方式組織工件。
事實表和維度表
事實資料表通常包含隨時間累積的資料,而維度資料表則儲存補充資料集,為資料提供額外的上下文。命名這兩種類型的表時,請考慮下列最佳實務:
- 命名慣例: 使用一致的命名慣例,清楚指出「事實表」和「尺寸表」的目的和內容。
- 描述性名稱: 為兩種類型的表格套用描述性名稱,以確保它們容易識別和理解。
- 來源系統: 在名稱中包含資料的來源系統。
範例
-
事實表: 試算表 - Workday
描述:儲存 Avikro Financial 的試算表交易資料: 儲存 Avikro Financial 的試算表交易資料,資料來源為 Workday。 -
維度表: Chart of Accounts - Workday
描述: 儲存 Avikro Financial 的會計表資料,資料來源為 Workday。 -
維度表: 利潤中心 - SAP
描述: 儲存 Avikro Financial 的利潤中心資訊,資料來源為 SAP。 -
尺寸表: 匯率 - 中央銀行 API
描述: 提供 Avikro Financial 的貨幣換算匯率,來源為中央銀行 API。
此模板可確保命名慣例的一致性、描述的清晰度,以及準確識別事實表和維度表的來源系統。
查詢
定義查詢的命名慣例時,必須保持標準的方法。這可確保使用者能輕鬆識別正確的查詢,以檢索特定資料。
- 命名慣例: 使用一致的命名慣例,清楚定義查詢的目的與內容。
- 描述性名稱: 為查詢套用描述性名稱,以便於識別和理解。
- 來源系統: 指定資料的來源系統。
範例:
-
查詢名稱: Extended Trial Balance - Workday - Financial Statement
說明: 此查詢可從 Workday 擷取試算表資料,以及專為製作財務報表而設計的補充資料集。
注意: 重要的是,,避免 在表格和查詢 中使用管道分隔符 (|) 。請勿使用連字線 (-),以避免這些元件可能產生的問題。
遵守此命名慣例也可清楚說明在建立傳入至試算表的連線時,應該使用哪個查詢。
說明
說明通常是設計和建置流程中最容易被忽略的部分,但它們對於改善理解和可用性卻至關重要。說明應該提供額外的上下文,例如: 說明表格或查詢是否是占位符:
- 指出表或查詢是否為占位符。
- 注意查詢在使用前是否需要編輯。
- 闡明查詢等工件的特定功能,例如找出比上一期低 20% 以下的付款。
透過清晰且詳細的說明,使用者可以快速掌握每個物件的目的與內容,減少混亂、減少錯誤,並提升管理 Wdata 環境的整體效率。
資料夾/環境
組織工作區時,建議根據預期用途將資料表和查詢分類至資料夾。此結構可讓使用者輕鬆導覽並確定哪些工件指定用於開發、測試和生產。
由於 Wdata 目前不支援開箱即用的應用程式生命週期管理,因此建議在工件和資料夾中附加名稱,以指示其各自的環境。這有助於管理應用程式生命週期,並避免任何錯誤或問題。請注意,生產工件不需要附加名稱。