root/feiqiu-ETL
Template
1
0
Fork 0
Code Pull Requests Packages Releases Wiki Activity

更新数据库文档 20260201-2

Browse Source
This commit is contained in:
Neo
2026-02-01 23:42:18 +08:00
parent 9b2c2c5c78
commit 294c6edbc9
47 changed files with 961 additions and 138 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
etl_billiards/docs/bd_manual/Ex/BD_manual_dim_assistant_ex.md
View File

@@ -2,7 +2,6 @@
> 生成时间：2026-01-28
## 表信息
| 属性 | 值 |
@@ -69,6 +68,21 @@
## 使用说明
**版本与最新值**
本表为 SCD2 维度表，版本字段：scd2_start_time / scd2_end_time / scd2_is_current / scd2_version。
- 最新版本：scd2_is_current = 1
- 按业务主键取最新：按 scd2_start_time 倒序
```sql
-- 取某业务主键的最新版本
SELECT *
FROM billiards_dwd.dim_assistant_ex
WHERE assistant_id = <value>
ORDER BY scd2_start_time DESC
LIMIT 1;
```
**使用示例**
```sql
-- 关联主表与扩展表
SELECT m.*, e.*

16
etl_billiards/docs/bd_manual/Ex/BD_manual_dim_groupbuy_package_ex.md
View File

@@ -2,7 +2,6 @@
> 生成时间：2026-01-28
## 表信息
| 属性 | 值 |
@@ -53,6 +52,21 @@
## 使用说明
**版本与最新值**
本表为 SCD2 维度表，版本字段：scd2_start_time / scd2_end_time / scd2_is_current / scd2_version。
- 最新版本：scd2_is_current = 1
- 按业务主键取最新：按 scd2_start_time 倒序
```sql
-- 取某业务主键的最新版本
SELECT *
FROM billiards_dwd.dim_groupbuy_package_ex
WHERE groupbuy_package_id = <value>
ORDER BY scd2_start_time DESC
LIMIT 1;
```
**使用示例**
```sql
-- 关联主表与扩展表
SELECT m.package_name, m.duration_seconds, e.start_clock, e.end_clock, e.effective_status

16
etl_billiards/docs/bd_manual/Ex/BD_manual_dim_member_card_account_ex.md
View File

@@ -2,7 +2,6 @@
> 生成时间：2026-01-28
## 表信息
| 属性 | 值 |
@@ -77,6 +76,21 @@
## 使用说明
**版本与最新值**
本表为 SCD2 维度表，版本字段：scd2_start_time / scd2_end_time / scd2_is_current / scd2_version。
- 最新版本：scd2_is_current = 1
- 按业务主键取最新：按 scd2_start_time 倒序
```sql
-- 取某业务主键的最新版本
SELECT *
FROM billiards_dwd.dim_member_card_account_ex
WHERE member_card_id = <value>
ORDER BY scd2_start_time DESC
LIMIT 1;
```
**使用示例**
```sql
-- 关联查询卡片及折扣配置
SELECT

16
etl_billiards/docs/bd_manual/Ex/BD_manual_dim_member_ex.md
View File

@@ -2,7 +2,6 @@
> 生成时间：2026-01-28
## 表信息
| 属性 | 值 |
@@ -40,6 +39,21 @@
## 使用说明
**版本与最新值**
本表为 SCD2 维度表，版本字段：scd2_start_time / scd2_end_time / scd2_is_current / scd2_version。
- 最新版本：scd2_is_current = 1
- 按业务主键取最新：按 scd2_start_time 倒序
```sql
-- 取某业务主键的最新版本
SELECT *
FROM billiards_dwd.dim_member_ex
WHERE member_id = <value>
ORDER BY scd2_start_time DESC
LIMIT 1;
```
**使用示例**
```sql
-- 关联主表与扩展表
SELECT m.*, e.point, e.growth_value, e.status

16
etl_billiards/docs/bd_manual/Ex/BD_manual_dim_site_ex.md
View File

@@ -2,7 +2,6 @@
> 生成时间：2026-01-28
## 表信息
| 属性 | 值 |
@@ -46,6 +45,21 @@
## 使用说明
**版本与最新值**
本表为 SCD2 维度表，版本字段：scd2_start_time / scd2_end_time / scd2_is_current / scd2_version。
- 最新版本：scd2_is_current = 1
- 按业务主键取最新：按 scd2_start_time 倒序
```sql
-- 取某业务主键的最新版本
SELECT *
FROM billiards_dwd.dim_site_ex
WHERE site_id = <value>
ORDER BY scd2_start_time DESC
LIMIT 1;
```
**使用示例**
```sql
-- 关联主表与扩展表
SELECT m.*, e.*

16
etl_billiards/docs/bd_manual/Ex/BD_manual_dim_store_goods_ex.md
View File

@@ -2,7 +2,6 @@
> 生成时间：2026-01-28
## 表信息
| 属性 | 值 |
@@ -51,6 +50,21 @@
## 使用说明
**版本与最新值**
本表为 SCD2 维度表，版本字段：scd2_start_time / scd2_end_time / scd2_is_current / scd2_version。
- 最新版本：scd2_is_current = 1
- 按业务主键取最新：按 scd2_start_time 倒序
```sql
-- 取某业务主键的最新版本
SELECT *
FROM billiards_dwd.dim_store_goods_ex
WHERE site_goods_id = <value>
ORDER BY scd2_start_time DESC
LIMIT 1;
```
**使用示例**
```sql
-- 关联主表与扩展表
SELECT m.goods_name, m.sale_price, m.sale_qty, e.unit, e.stock_qty, e.cost_price

16
etl_billiards/docs/bd_manual/Ex/BD_manual_dim_table_ex.md
View File

@@ -2,7 +2,6 @@
> 生成时间：2026-01-28
## 表信息
| 属性 | 值 |
@@ -39,6 +38,21 @@
## 使用说明
**版本与最新值**
本表为 SCD2 维度表，版本字段：scd2_start_time / scd2_end_time / scd2_is_current / scd2_version。
- 最新版本：scd2_is_current = 1
- 按业务主键取最新：按 scd2_start_time 倒序
```sql
-- 取某业务主键的最新版本
SELECT *
FROM billiards_dwd.dim_table_ex
WHERE table_id = <value>
ORDER BY scd2_start_time DESC
LIMIT 1;
```
**使用示例**
```sql
-- 关联主表与扩展表
SELECT m.table_name, m.site_table_area_name, e.show_status, e.table_status

16
etl_billiards/docs/bd_manual/Ex/BD_manual_dim_tenant_goods_ex.md
View File

@@ -2,7 +2,6 @@
> 生成时间：2026-01-28
## 表信息
| 属性 | 值 |
@@ -43,6 +42,21 @@
## 使用说明
**版本与最新值**
本表为 SCD2 维度表，版本字段：scd2_start_time / scd2_end_time / scd2_is_current / scd2_version。
- 最新版本：scd2_is_current = 1
- 按业务主键取最新：按 scd2_start_time 倒序
```sql
-- 取某业务主键的最新版本
SELECT *
FROM billiards_dwd.dim_tenant_goods_ex
WHERE tenant_goods_id = <value>
ORDER BY scd2_start_time DESC
LIMIT 1;
```
**使用示例**
```sql
-- 关联主表与扩展表
SELECT m.goods_name, m.market_price, e.cost_price, e.min_discount_price

14
etl_billiards/docs/bd_manual/Ex/BD_manual_dwd_assistant_service_log_ex.md
View File

@@ -2,7 +2,6 @@
> 生成时间：2026-01-28
## 表信息
| 属性 | 值 |
@@ -51,6 +50,19 @@
## 使用说明
**版本与最新值**
本表为事实表，无 SCD2 版本字段。
- 可用时间字段：ledger_start_time, ledger_end_time, composite_grade_time
```sql
-- 取最新一条（按时间字段倒序）
SELECT *
FROM billiards_dwd.dwd_assistant_service_log_ex
ORDER BY ledger_start_time DESC NULLS LAST
LIMIT 1;
```
**使用示例**
```sql
-- 关联主表与扩展表
SELECT m.nickname, m.ledger_amount, e.table_name, e.assistant_name, e.grade_status

15
etl_billiards/docs/bd_manual/Ex/BD_manual_dwd_assistant_trash_event_ex.md
View File

@@ -2,7 +2,6 @@
> 生成时间：2026-01-28
## 表信息
| 属性 | 值 |
@@ -46,4 +45,18 @@
## 使用说明
**版本与最新值**
本表为事实表，无 SCD2 版本字段。
- 主表可用时间字段：create_time
```sql
-- 取最新一条（按主表时间字段）
SELECT e.*
FROM billiards_dwd.dwd_assistant_trash_event m
JOIN billiards_dwd.dwd_assistant_trash_event_ex e ON m.assistant_trash_event_id = e.assistant_trash_event_id
ORDER BY m.create_time DESC NULLS LAST
LIMIT 1;
```
**使用示例**
与主表 `dwd_assistant_trash_event` 通过 `assistant_trash_event_id` 关联，提供台桌和台区名称信息。

15
etl_billiards/docs/bd_manual/Ex/BD_manual_dwd_groupbuy_redemption_ex.md
View File

@@ -2,7 +2,6 @@
> 生成时间：2026-01-28
## 表信息
| 属性 | 值 |
@@ -59,4 +58,18 @@
## 使用说明
**版本与最新值**
本表为事实表，无 SCD2 版本字段。
- 主表可用时间字段：create_time
```sql
-- 取最新一条（按主表时间字段）
SELECT e.*
FROM billiards_dwd.dwd_groupbuy_redemption m
JOIN billiards_dwd.dwd_groupbuy_redemption_ex e ON m.redemption_id = e.redemption_id
ORDER BY m.create_time DESC NULLS LAST
LIMIT 1;
```
**使用示例**
与主表 `dwd_groupbuy_redemption` 通过 `redemption_id` 关联，提供门店、台桌名称、操作员等扩展信息。

15
etl_billiards/docs/bd_manual/Ex/BD_manual_dwd_member_balance_change_ex.md
View File

@@ -2,7 +2,6 @@
> 生成时间：2026-01-28
## 表信息
| 属性 | 值 |
@@ -46,4 +45,18 @@
## 使用说明
**版本与最新值**
本表为事实表，无 SCD2 版本字段。
- 主表可用时间字段：change_time
```sql
-- 取最新一条（按主表时间字段）
SELECT e.*
FROM billiards_dwd.dwd_member_balance_change m
JOIN billiards_dwd.dwd_member_balance_change_ex e ON m.balance_change_id = e.balance_change_id
ORDER BY m.change_time DESC NULLS LAST
LIMIT 1;
```
**使用示例**
与主表 `dwd_member_balance_change` 通过 `balance_change_id` 关联，提供操作员和门店名称等扩展信息。

16
etl_billiards/docs/bd_manual/Ex/BD_manual_dwd_platform_coupon_redemption_ex.md
View File

@@ -2,7 +2,6 @@
> 生成时间：2026-01-28
## 表信息
| 属性 | 值 |
@@ -42,6 +41,19 @@
## 使用说明
与主表 `dwd_platform_coupon_redemption` 通过 `platform_coupon_redemption_id` 关联，提供操作员等扩展信息。
**版本与最新值**
本表为事实表，无 SCD2 版本字段。
- 主表可用时间字段：coupon_free_time, create_time, consume_time
```sql
-- 取最新一条（按主表时间字段）
SELECT e.*
FROM billiards_dwd.dwd_platform_coupon_redemption m
JOIN billiards_dwd.dwd_platform_coupon_redemption_ex e ON m.platform_coupon_redemption_id = e.platform_coupon_redemption_id
ORDER BY m.create_time DESC NULLS LAST
LIMIT 1;
```
**使用示例**
与主表 `dwd_platform_coupon_redemption` 通过 `platform_coupon_redemption_id` 关联，提供操作员等扩展信息。
**注意**: `coupon_remark` 字段在抖音渠道的核销记录中包含核验信息。

15
etl_billiards/docs/bd_manual/Ex/BD_manual_dwd_recharge_order_ex.md
View File

@@ -2,7 +2,6 @@
> 生成时间：2026-01-28
## 表信息
| 属性 | 值 |
@@ -64,6 +63,18 @@
## 使用说明
与主表 `dwd_recharge_order` 通过 `recharge_order_id` 关联，提供操作员、各类金额明细等扩展信息。
**版本与最新值**
本表为事实表，无 SCD2 版本字段。
- 可用时间字段：revoke_time
```sql
-- 取最新一条（按时间字段倒序）
SELECT *
FROM billiards_dwd.dwd_recharge_order_ex
ORDER BY revoke_time DESC NULLS LAST
LIMIT 1;
```
**使用示例**
与主表 `dwd_recharge_order` 通过 `recharge_order_id` 关联，提供操作员、各类金额明细等扩展信息。
**注意**: 样本数据获取时因日期解析错误未能获取。

15
etl_billiards/docs/bd_manual/Ex/BD_manual_dwd_refund_ex.md
View File

@@ -2,7 +2,6 @@
> 生成时间：2026-01-28
## 表信息
| 属性 | 值 |
@@ -48,4 +47,18 @@
## 使用说明
**版本与最新值**
本表为事实表，无 SCD2 版本字段。
- 主表可用时间字段：pay_time, create_time
```sql
-- 取最新一条（按主表时间字段）
SELECT e.*
FROM billiards_dwd.dwd_refund m
JOIN billiards_dwd.dwd_refund_ex e ON m.refund_id = e.refund_id
ORDER BY m.pay_time DESC NULLS LAST
LIMIT 1;
```
**使用示例**
与主表 `dwd_refund` 通过 `refund_id` 关联，提供退款状态和渠道等扩展信息。

15
etl_billiards/docs/bd_manual/Ex/BD_manual_dwd_settlement_head_ex.md
View File

@@ -2,7 +2,6 @@
> 生成时间：2026-01-28
## 表信息
| 属性 | 值 |
@@ -51,6 +50,19 @@
## 使用说明
**版本与最新值**
本表为事实表，无 SCD2 版本字段。
- 可用时间字段：revoke_time
```sql
-- 取最新一条（按时间字段倒序）
SELECT *
FROM billiards_dwd.dwd_settlement_head_ex
ORDER BY revoke_time DESC NULLS LAST
LIMIT 1;
```
**使用示例**
```sql
-- 关联主表与扩展表
SELECT
@@ -59,7 +71,6 @@ SELECT
FROM billiards_dwd.dwd_settlement_head m
JOIN billiards_dwd.dwd_settlement_head_ex e
ON m.order_settle_id = e.order_settle_id;
-- 统计备注订单
SELECT order_remark, COUNT(*)
FROM billiards_dwd.dwd_settlement_head_ex

15
etl_billiards/docs/bd_manual/Ex/BD_manual_dwd_store_goods_sale_ex.md
View File

@@ -2,7 +2,6 @@
> 生成时间：2026-01-28
## 表信息
| 属性 | 值 |
@@ -56,4 +55,18 @@
## 使用说明
**版本与最新值**
本表为事实表，无 SCD2 版本字段。
- 主表可用时间字段：create_time
```sql
-- 取最新一条（按主表时间字段）
SELECT e.*
FROM billiards_dwd.dwd_store_goods_sale m
JOIN billiards_dwd.dwd_store_goods_sale_ex e ON m.store_goods_sale_id = e.store_goods_sale_id
ORDER BY m.create_time DESC NULLS LAST
LIMIT 1;
```
**使用示例**
与主表 `dwd_store_goods_sale` 通过 `store_goods_sale_id` 关联，提供销售详情、折扣优惠等扩展信息。

15
etl_billiards/docs/bd_manual/Ex/BD_manual_dwd_table_fee_adjust_ex.md
View File

@@ -2,7 +2,6 @@
> 生成时间：2026-01-28
## 表信息
| 属性 | 值 |
@@ -36,4 +35,18 @@
## 使用说明
**版本与最新值**
本表为事实表，无 SCD2 版本字段。
- 主表可用时间字段：adjust_time
```sql
-- 取最新一条（按主表时间字段）
SELECT e.*
FROM billiards_dwd.dwd_table_fee_adjust m
JOIN billiards_dwd.dwd_table_fee_adjust_ex e ON m.table_fee_adjust_id = e.table_fee_adjust_id
ORDER BY m.adjust_time DESC NULLS LAST
LIMIT 1;
```
**使用示例**
与主表 `dwd_table_fee_adjust` 通过 `table_fee_adjust_id` 关联，提供调整类型、申请人、操作员等扩展信息。

14
etl_billiards/docs/bd_manual/Ex/BD_manual_dwd_table_fee_log_ex.md
View File

@@ -2,7 +2,6 @@
> 生成时间：2026-01-28
## 表信息
| 属性 | 值 |
@@ -41,4 +40,17 @@
## 使用说明
**版本与最新值**
本表为事实表，无 SCD2 版本字段。
- 可用时间字段：ledger_start_time, last_use_time
```sql
-- 取最新一条（按时间字段倒序）
SELECT *
FROM billiards_dwd.dwd_table_fee_log_ex
ORDER BY ledger_start_time DESC NULLS LAST
LIMIT 1;
```
**使用示例**
与主表 `dwd_table_fee_log` 通过 `table_fee_log_id` 关联，提供操作员和时间相关的扩展信息。