feiqiu-ETL/etl_billiards/docs/ods_to_dwd_mapping.md

ODS → DWD 映射文档（重建版）

本文件基于最新 DWD 质检结果重构，列出 DWD 表的 ODS 来源与字段映射状态。DIM 表默认使用 SCD2（SCD2_start_time / SCD2_end_time / SCD2_is_current / SCD2_version）。

表级映射概览

DWD 表	主键/提示	对应 ODS 表	SCD2
billiards_dwd.dim_site	见 schema_dwd_doc.sql	billiards_ods.site_tables_master	是
billiards_dwd.dim_site_ex	见 schema_dwd_doc.sql	billiards_ods.site_tables_master	是
billiards_dwd.dim_table	见 schema_dwd_doc.sql	billiards_ods.site_tables_master	是
billiards_dwd.dim_table_ex	见 schema_dwd_doc.sql	billiards_ods.site_tables_master	是
billiards_dwd.dim_assistant	见 schema_dwd_doc.sql	billiards_ods.assistant_accounts_master	是
billiards_dwd.dim_assistant_ex	见 schema_dwd_doc.sql	billiards_ods.assistant_accounts_master	是
billiards_dwd.dim_member	见 schema_dwd_doc.sql	billiards_ods.member_profiles	是
billiards_dwd.dim_member_ex	见 schema_dwd_doc.sql	billiards_ods.member_profiles	是
billiards_dwd.dim_member_card_account	见 schema_dwd_doc.sql	billiards_ods.member_stored_value_cards	是
billiards_dwd.dim_member_card_account_ex	见 schema_dwd_doc.sql	billiards_ods.member_stored_value_cards	是
billiards_dwd.dim_tenant_goods	见 schema_dwd_doc.sql	billiards_ods.tenant_goods_master	是
billiards_dwd.dim_tenant_goods_ex	见 schema_dwd_doc.sql	billiards_ods.tenant_goods_master	是
billiards_dwd.dim_store_goods	见 schema_dwd_doc.sql	billiards_ods.store_goods_master	是
billiards_dwd.dim_store_goods_ex	见 schema_dwd_doc.sql	billiards_ods.store_goods_master	是
billiards_dwd.dim_goods_category	见 schema_dwd_doc.sql	billiards_ods.stock_goods_category_tree	是
billiards_dwd.dim_groupbuy_package	见 schema_dwd_doc.sql	billiards_ods.group_buy_packages	是
billiards_dwd.dim_groupbuy_package_ex	见 schema_dwd_doc.sql	billiards_ods.group_buy_packages	是
billiards_dwd.dwd_settlement_head	见 schema_dwd_doc.sql	billiards_ods.settlement_records	否
billiards_dwd.dwd_settlement_head_ex	见 schema_dwd_doc.sql	billiards_ods.settlement_records	否
billiards_dwd.dwd_table_fee_log	见 schema_dwd_doc.sql	billiards_ods.table_fee_transactions	否
billiards_dwd.dwd_table_fee_log_ex	见 schema_dwd_doc.sql	billiards_ods.table_fee_transactions	否
billiards_dwd.dwd_table_fee_adjust	见 schema_dwd_doc.sql	billiards_ods.table_fee_discount_records	否
billiards_dwd.dwd_table_fee_adjust_ex	见 schema_dwd_doc.sql	billiards_ods.table_fee_discount_records	否
billiards_dwd.dwd_store_goods_sale	见 schema_dwd_doc.sql	billiards_ods.store_goods_sales_records	否
billiards_dwd.dwd_store_goods_sale_ex	见 schema_dwd_doc.sql	billiards_ods.store_goods_sales_records	否
billiards_dwd.dwd_assistant_service_log	见 schema_dwd_doc.sql	billiards_ods.assistant_service_records	否
billiards_dwd.dwd_assistant_service_log_ex	见 schema_dwd_doc.sql	billiards_ods.assistant_service_records	否
billiards_dwd.dwd_assistant_trash_event	见 schema_dwd_doc.sql	billiards_ods.assistant_cancellation_records	否
billiards_dwd.dwd_assistant_trash_event_ex	见 schema_dwd_doc.sql	billiards_ods.assistant_cancellation_records	否
billiards_dwd.dwd_member_balance_change	见 schema_dwd_doc.sql	billiards_ods.member_balance_changes	否
billiards_dwd.dwd_member_balance_change_ex	见 schema_dwd_doc.sql	billiards_ods.member_balance_changes	否
billiards_dwd.dwd_groupbuy_redemption	见 schema_dwd_doc.sql	billiards_ods.group_buy_redemption_records	否
billiards_dwd.dwd_groupbuy_redemption_ex	见 schema_dwd_doc.sql	billiards_ods.group_buy_redemption_records	否
billiards_dwd.dwd_platform_coupon_redemption	见 schema_dwd_doc.sql	billiards_ods.platform_coupon_redemption_records	否
billiards_dwd.dwd_platform_coupon_redemption_ex	见 schema_dwd_doc.sql	billiards_ods.platform_coupon_redemption_records	否
billiards_dwd.dwd_recharge_order	见 schema_dwd_doc.sql	billiards_ods.recharge_settlements	否
billiards_dwd.dwd_recharge_order_ex	见 schema_dwd_doc.sql	billiards_ods.recharge_settlements	否
billiards_dwd.dwd_payment	见 schema_dwd_doc.sql	billiards_ods.payment_transactions	否
billiards_dwd.dwd_refund	见 schema_dwd_doc.sql	billiards_ods.refund_transactions	否
billiards_dwd.dwd_refund_ex	见 schema_dwd_doc.sql	billiards_ods.refund_transactions	否

字段级映射（同名直拷 / 需映射）

同名直拷：DWD 字段与 ODS 同名，直接复制；需映射：ODS 无同名列，需要在装载逻辑中指定来源或默认值。

字段级映射（同名直拷 / 需映射）

同名直拷：DWD 字段与 ODS 同名，直接复制；需映射：ODS 无同名列，需要在装载逻辑中指定来源或默认值。

billiards_dwd.dim_site

来源：billiards_ods.site_tables_master 同名直拷字段： site_id 需映射/派生字段： org_id, shop_name, business_tel, full_address, tenant_id, scd2_start_time, scd2_end_time, scd2_is_current, scd2_version

billiards_dwd.dim_site_ex

来源：billiards_ods.site_tables_master 同名直拷字段： site_id, light_status, create_time 需映射/派生字段： avatar, address, longitude, latitude, tenant_site_region_id, auto_light, light_type, light_token, site_type, site_label, attendance_enabled, attendance_distance, customer_service_qrcode, customer_service_wechat, fixed_pay_qrcode, prod_env, shop_status, update_time, scd2_start_time, scd2_end_time, scd2_is_current, scd2_version

billiards_dwd.dim_table

来源：billiards_ods.site_tables_master 同名直拷字段： site_id, table_name, site_table_area_id, table_price 需映射/派生字段： table_id, tenant_id, site_table_area_name, tenant_table_area_id, scd2_start_time, scd2_end_time, scd2_is_current, scd2_version

billiards_dwd.dim_table_ex

来源：billiards_ods.site_tables_master 同名直拷字段： show_status, is_online_reservation, table_cloth_use_time, table_cloth_use_cycle, table_status 需映射/派生字段： table_id, last_maintenance_time, remark, scd2_start_time, scd2_end_time, scd2_is_current, scd2_version

billiards_dwd.dim_assistant

来源：billiards_ods.assistant_accounts_master 同名直拷字段： assistant_no, real_name, nickname, mobile, tenant_id, site_id, team_id, team_name, level, entry_time, resign_time, leave_status, assistant_status 需映射/派生字段： assistant_id, user_id, scd2_start_time, scd2_end_time, scd2_is_current, scd2_version

billiards_dwd.dim_assistant_ex

来源：billiards_ods.assistant_accounts_master 同名直拷字段： gender, avatar, video_introduction_url, staff_id, staff_profile_id, sum_grade, get_grade_times, work_status, show_status, show_sort, create_time, update_time, start_time, end_time, order_trade_no 需映射/派生字段： assistant_id, birth_date, introduce, height, weight, shop_name, group_id, group_name, person_org_id, assistant_grade, charge_way, allow_cx, is_guaranteed, salary_grant_enabled, entry_type, entry_sign_status, resign_sign_status, online_status, is_delete, criticism_status, last_table_id, last_table_name, last_update_name, ding_talk_synced, site_light_cfg_id, light_equipment_id, light_status, is_team_leader, serial_number, scd2_start_time, scd2_end_time, scd2_is_current, scd2_version

billiards_dwd.dim_member

来源：billiards_ods.member_profiles 同名直拷字段： system_member_id, tenant_id, register_site_id, mobile, nickname, member_card_grade_code, member_card_grade_name, create_time 需映射/派生字段： member_id, update_time, scd2_start_time, scd2_end_time, scd2_is_current, scd2_version

billiards_dwd.dim_member_ex

来源：billiards_ods.member_profiles 同名直拷字段： referrer_member_id, point, growth_value, user_status, status 需映射/派生字段： member_id, register_site_name, scd2_start_time, scd2_end_time, scd2_is_current, scd2_version

billiards_dwd.dim_member_card_account

来源：billiards_ods.member_stored_value_cards 同名直拷字段： tenant_id, register_site_id, tenant_member_id, system_member_id, card_type_id, member_card_grade_code, member_card_grade_code_name, member_card_type_name, member_name, member_mobile, balance, start_time, end_time, last_consume_time, status, is_delete 需映射/派生字段： member_card_id, scd2_start_time, scd2_end_time, scd2_is_current, scd2_version

billiards_dwd.dim_member_card_account_ex

来源：billiards_ods.member_stored_value_cards 同名直拷字段： site_name, tenantavatar, effect_site_id, able_cross_site, card_physics_type, card_no, bind_password, use_scene, denomination, create_time, disable_start_time, disable_end_time, is_allow_give, is_allow_order_deduct, sort, table_discount, goods_discount, assistant_discount, assistant_reward_discount, table_service_discount, goods_service_discount, assistant_service_discount, coupon_discount, table_discount_sub_switch, goods_discount_sub_switch, assistant_discount_sub_switch, assistant_reward_discount_sub_switch, goods_discount_range_type, table_deduct_radio, goods_deduct_radio, assistant_deduct_radio, table_service_deduct_radio, goods_service_deduct_radio, assistant_service_deduct_radio, assistant_reward_deduct_radio, coupon_deduct_radio, cardsettlededuct, tablecarddeduct, tableservicecarddeduct, goodscardeduct, goodsservicecarddeduct, assistantcarddeduct, assistantservicecarddeduct, assistantrewardcarddeduct, couponcarddeduct, deliveryfeededuct, tableareaid, goodscategoryid, pdassisnatlevel, cxassisnatlevel 需映射/派生字段： member_card_id, tenant_name, scd2_start_time, scd2_end_time, scd2_is_current, scd2_version

billiards_dwd.dim_tenant_goods

来源：billiards_ods.tenant_goods_master 同名直拷字段： tenant_id, supplier_id, goods_category_id, goods_second_category_id, goods_name, goods_number, unit, market_price, goods_state, create_time, update_time, is_delete 需映射/派生字段： tenant_goods_id, category_name, scd2_start_time, scd2_end_time, scd2_is_current, scd2_version

billiards_dwd.dim_tenant_goods_ex

来源：billiards_ods.tenant_goods_master 同名直拷字段： remark_name, pinyin_initial, goods_cover, goods_bar_code, commodity_code, min_discount_price, cost_price, cost_price_type, able_discount, sale_channel, is_warehousing, able_site_transfer, common_sale_royalty, point_sale_royalty 需映射/派生字段： tenant_goods_id, commodity_code_list, is_in_site, out_goods_id, scd2_start_time, scd2_end_time, scd2_is_current, scd2_version

billiards_dwd.dim_store_goods

来源：billiards_ods.store_goods_master 同名直拷字段： tenant_id, site_id, tenant_goods_id, goods_name, goods_category_id, goods_second_category_id, sale_price, goods_state, enable_status, send_state, is_delete 需映射/派生字段： site_goods_id, category_level1_name, category_level2_name, batch_stock_qty, sale_qty, total_sales_qty, created_at, updated_at, avg_monthly_sales, scd2_start_time, scd2_end_time, scd2_is_current, scd2_version

billiards_dwd.dim_store_goods_ex

来源：billiards_ods.store_goods_master 同名直拷字段： unit, pinyin_initial, cost_price, cost_price_type, total_purchase_cost, min_discount_price, audit_status, sale_channel, is_warehousing, forbid_sell_status, able_site_transfer, custom_label_type, option_required, remark 需映射/派生字段： site_goods_id, site_name, goods_barcode, goods_cover_url, stock_qty, stock_secondary_qty, safety_stock_qty, provisional_total_cost, is_discountable, days_on_shelf, freeze_status, sort_order, scd2_start_time, scd2_end_time, scd2_is_current, scd2_version

billiards_dwd.dim_goods_category

来源：billiards_ods.stock_goods_category_tree 同名直拷字段： tenant_id, category_name, alias_name, business_name, tenant_goods_business_id, open_salesman, is_warehousing 需映射/派生字段： category_id, parent_category_id, category_level, is_leaf, sort_order, scd2_start_time, scd2_end_time, scd2_is_current, scd2_version

billiards_dwd.dim_groupbuy_package

来源：billiards_ods.group_buy_packages 同名直拷字段： tenant_id, site_id, package_name, selling_price, start_time, end_time, table_area_name, is_enabled, is_delete, create_time, tenant_table_area_id_list, card_type_ids 需映射/派生字段： groupbuy_package_id, package_template_id, coupon_face_value, duration_seconds, scd2_start_time, scd2_end_time, scd2_is_current, scd2_version

billiards_dwd.dim_groupbuy_package_ex

来源：billiards_ods.group_buy_packages 同名直拷字段： site_name, usable_count, date_type, usable_range, date_info, start_clock, end_clock, add_start_clock, add_end_clock, area_tag_type, table_area_id, tenant_table_area_id, table_area_id_list, group_type, system_group_type, effective_status, max_selectable_categories, creator_name 需映射/派生字段： groupbuy_package_id, package_type, scd2_start_time, scd2_end_time, scd2_is_current, scd2_version

billiards_dwd.dwd_settlement_head

来源：billiards_ods.settlement_records 同名直拷字段： 无 需映射/派生字段： order_settle_id, tenant_id, site_id, site_name, table_id, settle_name, order_trade_no, create_time, pay_time, settle_type, revoke_order_id, member_id, member_name, member_phone, member_card_account_id, member_card_type_name, is_bind_member, member_discount_amount, consume_money, table_charge_money, goods_money, real_goods_money, assistant_pd_money, assistant_cx_money, adjust_amount, pay_amount, balance_amount, recharge_card_amount, gift_card_amount, coupon_amount, rounding_amount, point_amount

billiards_dwd.dwd_settlement_head_ex

来源：billiards_ods.settlement_records 同名直拷字段： 无 需映射/派生字段： order_settle_id, serial_number, settle_status, can_be_revoked, revoke_order_name, revoke_time, is_first_order, service_money, cash_amount, card_amount, online_amount, refund_amount, prepay_money, payment_method, coupon_sale_amount, all_coupon_discount, goods_promotion_money, assistant_promotion_money, activity_discount, assistant_manual_discount, point_discount_price, point_discount_cost, is_use_coupon, is_use_discount, is_activity, operator_name, salesman_name, order_remark, operator_id, salesman_user_id

billiards_dwd.dwd_table_fee_log

来源：billiards_ods.table_fee_transactions 同名直拷字段： order_trade_no, order_settle_id, order_pay_id, tenant_id, site_id, site_table_id, site_table_area_id, site_table_area_name, tenant_table_area_id, member_id, ledger_name, ledger_unit_price, ledger_count, ledger_amount, real_table_charge_money, coupon_promotion_amount, member_discount_amount, adjust_amount, real_table_use_seconds, add_clock_seconds, start_use_time, ledger_end_time, create_time, ledger_status, is_single_order, is_delete 需映射/派生字段： table_fee_log_id

billiards_dwd.dwd_table_fee_log_ex

来源：billiards_ods.table_fee_transactions 同名直拷字段： operator_name, salesman_name, used_card_amount, service_money, mgmt_fee, fee_total, ledger_start_time, last_use_time, operator_id, salesman_user_id, salesman_org_id 需映射/派生字段： table_fee_log_id

billiards_dwd.dwd_table_fee_adjust

来源：billiards_ods.table_fee_discount_records 同名直拷字段： order_trade_no, order_settle_id, tenant_id, site_id, tenant_table_area_id, ledger_amount, ledger_status, is_delete 需映射/派生字段： table_fee_adjust_id, table_id, table_area_id, table_area_name, adjust_time

billiards_dwd.dwd_table_fee_adjust_ex

来源：billiards_ods.table_fee_discount_records 同名直拷字段： adjust_type, ledger_count, ledger_name, applicant_name, operator_name, applicant_id, operator_id 需映射/派生字段： table_fee_adjust_id

billiards_dwd.dwd_store_goods_sale

来源：billiards_ods.store_goods_sales_records 同名直拷字段： order_trade_no, order_settle_id, order_pay_id, order_goods_id, site_id, tenant_id, site_goods_id, tenant_goods_id, tenant_goods_category_id, tenant_goods_business_id, site_table_id, ledger_name, ledger_group_name, ledger_unit_price, ledger_count, ledger_amount, real_goods_money, cost_money, ledger_status, is_delete, create_time 需映射/派生字段： store_goods_sale_id, discount_price

billiards_dwd.dwd_store_goods_sale_ex

来源：billiards_ods.store_goods_sales_records 同名直拷字段： goods_remark, option_value_name, operator_name, salesman_user_id, salesman_name, salesman_role_id, discount_money, coupon_deduct_money, member_discount_amount, point_discount_money, point_discount_money_cost, package_coupon_id, order_coupon_id, member_coupon_id, option_price, option_member_discount_money, option_coupon_deduct_money, push_money, is_single_order, sales_type, operator_id 需映射/派生字段： store_goods_sale_id, legacy_order_goods_id, site_name, legacy_site_id, open_salesman_flag, salesman_org_id, returns_number

billiards_dwd.dwd_assistant_service_log

来源：billiards_ods.assistant_service_records 同名直拷字段： order_trade_no, order_settle_id, order_pay_id, order_assistant_id, order_assistant_type, tenant_id, site_id, site_table_id, nickname, assistant_team_id, person_org_id, assistant_level, ledger_unit_price, ledger_amount, projected_income, coupon_deduct_money, income_seconds, real_use_seconds, add_clock, create_time, start_use_time, last_use_time, is_delete 需映射/派生字段： assistant_service_id, tenant_member_id, system_member_id, assistant_no, site_assistant_id, user_id, level_name, skill_id, skill_name

billiards_dwd.dwd_assistant_service_log_ex

来源：billiards_ods.assistant_service_records 同名直拷字段： ledger_name, ledger_group_name, ledger_count, member_discount_amount, manual_discount_amount, service_money, returns_clock, ledger_start_time, ledger_end_time, ledger_status, is_confirm, is_single_order, is_not_responding, is_trash, trash_applicant_id, trash_applicant_name, trash_reason, salesman_user_id, salesman_name, salesman_org_id, skill_grade, service_grade, composite_grade, sum_grade, get_grade_times, grade_status, composite_grade_time 需映射/派生字段： assistant_service_id, table_name, assistant_name

billiards_dwd.dwd_assistant_trash_event

来源：billiards_ods.assistant_cancellation_records 同名直拷字段： 无 需映射/派生字段： assistant_trash_event_id, site_id, table_id, table_area_id, assistant_no, assistant_name, charge_minutes_raw, abolish_amount, trash_reason, create_time

billiards_dwd.dwd_assistant_trash_event_ex

来源：billiards_ods.assistant_cancellation_records 同名直拷字段： 无 需映射/派生字段： assistant_trash_event_id, table_name, table_area_name

billiards_dwd.dwd_member_balance_change

来源：billiards_ods.member_balance_changes 同名直拷字段： tenant_id, site_id, register_site_id, tenant_member_id, system_member_id, tenant_member_card_id, card_type_id, from_type, payment_method, is_delete, remark 需映射/派生字段： balance_change_id, card_type_name, member_name, member_mobile, balance_before, change_amount, balance_after, change_time

billiards_dwd.dwd_member_balance_change_ex

来源：billiards_ods.member_balance_changes 同名直拷字段： refund_amount, operator_id, operator_name 需映射/派生字段： balance_change_id, pay_site_name, register_site_name

billiards_dwd.dwd_groupbuy_redemption

来源：billiards_ods.group_buy_redemption_records 同名直拷字段： tenant_id, site_id, table_id, tenant_table_area_id, table_charge_seconds, order_trade_no, order_settle_id, order_coupon_id, coupon_origin_id, promotion_activity_id, promotion_coupon_id, order_coupon_channel, ledger_unit_price, ledger_count, ledger_amount, coupon_money, promotion_seconds, coupon_code, is_single_order, is_delete, ledger_name, create_time 需映射/派生字段： redemption_id

billiards_dwd.dwd_groupbuy_redemption_ex

来源：billiards_ods.group_buy_redemption_records 同名直拷字段： order_pay_id, goods_promotion_money, table_service_promotion_money, assistant_promotion_money, assistant_service_promotion_money, reward_promotion_money, recharge_promotion_money, offer_type, ledger_status, operator_id, operator_name, salesman_user_id, salesman_name, salesman_role_id, ledger_group_name 需映射/派生字段： redemption_id, site_name, table_name, table_area_name, goods_option_price, salesman_org_id

billiards_dwd.dwd_platform_coupon_redemption

来源：billiards_ods.platform_coupon_redemption_records 同名直拷字段： tenant_id, site_id, coupon_code, coupon_channel, coupon_name, sale_price, coupon_money, coupon_free_time, channel_deal_id, deal_id, group_package_id, site_order_id, table_id, certificate_id, verify_id, use_status, is_delete, create_time, consume_time 需映射/派生字段： platform_coupon_redemption_id

billiards_dwd.dwd_platform_coupon_redemption_ex

来源：billiards_ods.platform_coupon_redemption_records 同名直拷字段： coupon_cover, coupon_remark, groupon_type, operator_id, operator_name 需映射/派生字段： platform_coupon_redemption_id

billiards_dwd.dwd_recharge_order

来源：billiards_ods.recharge_settlements 同名直拷字段： 无 需映射/派生字段： recharge_order_id, tenant_id, site_id, member_id, member_name_snapshot, member_phone_snapshot, tenant_member_card_id, member_card_type_name, settle_relate_id, settle_type, settle_name, is_first, pay_amount, refund_amount, point_amount, cash_amount, payment_method, create_time, pay_time

billiards_dwd.dwd_recharge_order_ex

来源：billiards_ods.recharge_settlements 同名直拷字段： 无 需映射/派生字段： recharge_order_id, site_name_snapshot, settle_status, is_bind_member, is_activity, is_use_coupon, is_use_discount, can_be_revoked, online_amount, balance_amount, card_amount, coupon_amount, recharge_card_amount, gift_card_amount, prepay_money, consume_money, goods_money, real_goods_money, table_charge_money, service_money, activity_discount, all_coupon_discount, goods_promotion_money, assistant_promotion_money, assistant_pd_money, assistant_cx_money, assistant_manual_discount, coupon_sale_amount, member_discount_amount, point_discount_price, point_discount_cost, adjust_amount, rounding_amount, operator_id, operator_name_snapshot, salesman_user_id, salesman_name, order_remark, table_id, serial_number, revoke_order_id, revoke_order_name, revoke_time

billiards_dwd.dwd_payment

来源：billiards_ods.payment_transactions 同名直拷字段： site_id, relate_type, relate_id, pay_amount, pay_status, payment_method, online_pay_channel, create_time, pay_time 需映射/派生字段： payment_id, pay_date

billiards_dwd.dwd_refund

来源：billiards_ods.refund_transactions 同名直拷字段： tenant_id, site_id, relate_type, relate_id, pay_amount, channel_fee, pay_time, create_time, payment_method, member_id, member_card_id 需映射/派生字段： refund_id

billiards_dwd.dwd_refund_ex

来源：billiards_ods.refund_transactions 同名直拷字段： pay_sn, refund_amount, round_amount, balance_frozen_amount, card_frozen_amount, pay_status, action_type, is_revoke, is_delete, check_status, online_pay_channel, online_pay_type, pay_terminal, pay_config_id, cashier_point_id, operator_id, channel_payer_id, channel_pay_no 需映射/派生字段： refund_id, tenant_name