|
|
@@ -1,7 +1,7 @@
|
|
|
# 数仓命名规范
|
|
|
|
|
|
> 本文档是 `poyee-data-warehouse` 数据仓库的命名权威规范。所有建表、字段、文件、目录命名必须遵循本规范。
|
|
|
-> 给人看：作为开发手册；给 AI 看：作为代码生成和 Review 的依据。
|
|
|
+> 开发手册与 code review 的参考依据。
|
|
|
|
|
|
## 1. 核心原则
|
|
|
|
|
|
@@ -267,10 +267,10 @@ ads 是面向具体应用场景的输出表（报表、接口、导出），表
|
|
|
|
|
|
- **一套代码跑多环境**：不在 ini 文件名里加 `prod` / `dev` / `test` 前缀。环境差异体现在 `datasource/{db_type}/{env}/{instance}.ini`，由脚本根据 `-env` 参数注入
|
|
|
- ini 内 reader/writer 的 `dataSource` 字段只写 `{db_type}/{instance}`（不含 env），例如 `dataSource = mongo/hobby`
|
|
|
-- DataX 生成引擎（`dw_base/datax/job_config_generator.py`）对文件名**不做校验**，上述命名规则是人/AI 写作约定，靠 code review 保证
|
|
|
+- DataX 生成引擎（`dw_base/datax/job_config_generator.py`）对文件名**不做校验**，上述命名规则是开发者写作约定，靠 code review 保证
|
|
|
- 命名唯一性保证 JSON 输出目录 `conf/datax-json/{env}/{ini_basename}.json` 不会互相覆盖
|
|
|
|
|
|
-**参考样板**：`conf/templates/datax/{raw,ads,manual}/*.template.ini` 提供各类同步场景的字段齐全样本，新开发者和 AI 写新 ini 时抄这里。
|
|
|
+**参考样板**：`conf/templates/datax/{raw,ads,manual}/*.template.ini` 提供各类同步场景的字段齐全样本，新开发者写新 ini 时抄这里。
|
|
|
|
|
|
**为什么不按老项目的 `{from}-{to}-{db}-{table}.ini` 命名**：
|
|
|
- 同步方向已经在 ini 的 `[reader]` / `[writer]` section 的 `dataSource` 里体现，文件名再写一遍是冗余
|
