ctc_poc2026/src/tm_building_user_wifi_m/README.md

tm_building_user_wifi_m 执行说明

表说明

楼宇 WiFi 指标月表，分析楼宇内用户的 WiFi 连接偏好与蜂窝网络协同情况，楼宇 4G/5G_SA 用户数和市场份额落在 tm_building_coverage_m。

执行步骤

1. 前置依赖

必须先执行以下表：

• td_building（楼宇维表#，需已入库）

2. 在Hive中执行计算

hive -hivevar:year_month=2026-05 -f src/tm_building_user_wifi_m/compute.sql

或直接在Hive CLI中执行 src/tm_building_user_wifi_m/compute.sql 中的SQL

3. 执行同步脚本

bash src/tm_building_user_wifi_m/sync.sh

4. 验证数据

在PG中执行：

SELECT COUNT(*) FROM dmk.tm_building_user_wifi_m;  -- 应大于0
SELECT year_month, building_id, wifi_total_user_count, wifi_user_count, wifi_market_share
FROM dmk.tm_building_user_wifi_m LIMIT 10;  -- 检查WiFi指标

计算侧与持久化

• 计算侧：HiveSQL（默认侧）
• 持久化侧：PostgreSQL

关键计算逻辑

1. 数据源：ODS OTT WiFi数据
2. indoor_flag固定-1：由于无MR数据支撑WiFi指标
3. 用户统计：使用 approx_count_distinct(device_id_list) 统计连接特定WiFi的去重用户数
4. 关联逻辑：通过 device_id 关联用户的蜂窝覆盖指标，以分析WiFi卸载价值
5. WiFi市场份额：本运营商WiFi用户数 / 总WiFi用户数

注意事项

1. 仅关注电信(telecom)数据
2. WiFi指标独立于蜂窝网络指标
3. 楼宇4G/5G用户数和市场份额实际落在 tm_building_coverage_m
4. 同步脚本中的数据库连接参数需根据实际情况修改