الگوهای نام‌گذاری
رعایت استانداردهای یکپارچه در نام‌گذاری جداول و ستون‌ها، خوانایی مدل‌های داده را افزایش می‌دهد و فرآیند نگهداری انبار داده و کوئری‌نویسی را تسهیل می‌سازد. در داده‌لند برخی از این قواعد الزامی و برخی دیگر به عنوان الگوهای پیشنهادی مطرح هستند.
نام‌گذاری جداول
نام‌گذاری کلیه جداول در داده‌لند به صورت اجباری باید با فرمت snake_case (حروف کوچک انگلیسی همراه با زیرخط جهت تفکیک کلمات) انجام پذیرد. همچنین سقف مجاز برای طول نام جدول حداکثر ۲۵ کاراکتر است.
برای ساختار نام جداول، دو الگوی استاندارد زیر پیشنهاد می‌شوند:
| الگو | ساختار پیشنهادی | کاربرد | مثال |
|---|---|---|---|
| الگوی مستقیم | [prefix]_[table_name] | حالت پیش‌فرض جهت سادگی و جلوگیری از عبور از سقف ۲۵ کاراکتر | fact_invoices |
| الگوی پروژه‌محور | [prefix]_[project_name]_[table_name] | مناسب برای جلوگیری از تداخل نام در فضاهای دارای چند پروژه هم‌نام | fact_sales_invoices |
پیشوندهای پیشنهادی متناسب با نوع جدول و نمونه‌های کاربردی آن‌ها در جدول زیر ارائه شده است:
| نوع جدول | پیشوند پیشنهادی | کاربرد جدول | نام با الگوی مستقیم | نام با الگوی پروژه |
|---|---|---|---|---|
| وقایع (Fact) و آزاد (Plain) | fact_ | ثبت وقایع و شاخص‌های عددی کسب‌وکار (مانند فاکتورها) | fact_invoices | fact_sales_invoices |
| وصف (Dimension) و آزاد (Plain) | dim_ | نگهداری مشخصات توصیفی موجودیت‌ها (مانند کارکنان) | dim_employees | dim_hr_employees |
| استیجینگ (STG) | stg_ | ذخیره داده‌های خام لایه استیجینگ (مانند پرداختی‌ها) | stg_payments | stg_fin_payments |
نام‌گذاری ستون‌ها
برای نام اصلی ستون‌ها استفاده از فرمت snake_case توصیه می‌شود و سقف مجاز برای طول آن حداکثر ۲۵ کاراکتر است.
چنانچه جداول دارای شناسه هستند، برای استانداردسازی کوئری‌ها پیشنهاد می‌شود در جداول وقایع (Fact) از fact_id و در جداول وصف (Dimension) از dim_id برای شناسه اصلی استفاده نمایید:
| نوع جدول | موجودیت نمونه | شناسه موجودیت | ستون پیشنهادی در داده‌لند |
|---|---|---|---|
| وقایع (Fact) | تراکنش‌ها (Transactions) | شناسه تراکنش (Transaction ID) | fact_id |
| وقایع (Fact) | اقلام فاکتور (Items) | شناسه آیتم (Item ID) | fact_id |
| وصف (Dimension) | کاربران (Users) | شناسه کاربر (User ID) | dim_id |
| وصف (Dimension) | کالاها (Products) | شناسه محصول (Product ID) | dim_id |