从零开始学Flink：实时数仓与维表时态Join实战

在前一篇《Flink 双流 JOIN 实战详解》中，我们用「订单流 + 支付流」搞懂了事实双流之间的时间关联。

但在真实的实时数仓项目里，光有事实流还不够，业务同学更关心的是：

下单用户是新客还是老客
用户当前的等级、城市、渠道
商品所属品类、类目层级

这些信息通常存放在 维度表 （维表）中，例如 MySQL 的 dim_user、dim_product 等。我们希望在实时计算时，能把「事实流」和「维表」在时间维度上正确地关联起来，构建一张带有完整业务属性的明细宽表。

这就是 维表时态 Join（Temporal Table Join） 要解决的问题。

本文我们就以「订单事实流 + 用户维表」为例，完成一个从 Kafka 到 MySQL 的简易实时数仓 Demo，并重点理解 Flink SQL 中维表时态 Join 的语法和注意事项。

一、业务场景与数仓目标

设想一个简化的电商业务场景：

Kafka 中有实时写入的 orders 订单事实流
MySQL 中维护一张 dim_user 用户维表，包含用户等级、所属城市、注册渠道等信息

我们想要在 Flink 中构建一张「订单明细宽表」，字段大致包括：

订单信息：订单号、下单用户、下单金额、下单时间
用户属性：用户昵称、等级、城市、注册渠道

并且要求：

当我们回看 10 分钟前的某条订单时，看到的是当时用户的等级和城市，而不是被后续变更"冲掉"的最新值

这正是 时态 Join 和「实时数仓」的关键：按事件发生时刻回放维度视图。

二、环境前提与依赖准备

1. 基础组件

本篇默认你已经完成前几篇中的环境准备：

Flink 1.20.1（WSL2 Ubuntu 下部署）
Kafka 集群已启动，且能正常写入 / 读取 Topic
Flink SQL Client 可以正常连接集群

在此基础上，我们还需要：

一套可访问的 MySQL（本地或远程均可）
Flink 的 JDBC Connector JAR 包

2. 安装 Flink JDBC Connector

和 Kafka 一样，JDBC 连接器也需要以 JAR 包形式放到 Flink 的 lib 目录中。

以 Flink 1.20.x 对应的 flink-connector-jdbc 为例：

确认 Flink 安装目录（假设为 /opt/flink）：
bash 复制代码
```
export FLINK_HOME=/opt/flink
```

复制代码

下载 JDBC Connector JAR 到 Flink 的 lib 目录：

bash 复制代码

cd $FLINK_HOME/lib
wget https://repo1.maven.org/maven2/org/apache/flink/flink-connector-jdbc/3.3.0-1.20/flink-connector-jdbc-3.3.0-1.20.jar

如果你使用的是独立集群或远程集群，需要重启 Flink 集群，让新 JAR 在 JobManager/TaskManager 上生效：
bash 复制代码
```
cd $FLINK_HOME
bin/stop-cluster.sh
bin/start-cluster.sh
```
重启 Flink SQL Client，使用新 Connector：
bash 复制代码
```
cd $FLINK_HOME
bin/sql-client.sh
```

如果你在 Windows + WSL2 上部署，只需在 WSL2 内执行上述命令即可；或者手动下载 JAR 后拷贝到 lib 目录，步骤完全一致。

三、准备 MySQL 用户维度表 dim_user

首先在 MySQL 中准备一张简单的用户维度表，用来存用户的基础属性。

在 MySQL 中执行：

sql 复制代码

CREATE DATABASE IF NOT EXISTS realtime_dwh;
USE realtime_dwh;

CREATE TABLE dim_user (
  user_id      VARCHAR(32)  PRIMARY KEY,
  user_name    VARCHAR(64),
  user_level   VARCHAR(16),
  city         VARCHAR(64),
  register_time DATETIME
);

INSERT INTO dim_user (user_id, user_name, user_level, city, register_time) VALUES
('u_1', '张三', 'VIP1', '北京', '2025-12-01 10:00:00'),
('u_2', '李四', 'VIP2', '上海', '2025-12-05 11:00:00'),
('u_3', '王五', 'VIP1', '广州', '2025-12-10 12:00:00');

为了演示「时态」效果，你可以在后续实验中手动更新某个用户的等级或城市，例如：

sql 复制代码

UPDATE dim_user
SET user_level = 'VIP3'
WHERE user_id = 'u_2';

这样我们在 Flink 里做时态 Join 时，就能观察"变更前后"的区别。

四、在 Flink 中注册事实流与维表

接下来回到 Flink SQL Client，把 Kafka 中的订单事实流和 MySQL 中的维表都注册成 Flink 表。

1. Kafka 订单事实表 orders

和上一篇双流 JOIN 类似，我们假设 Kafka 中有一个 orders Topic，写入订单事实数据。

在 Flink SQL Client 中执行：

sql 复制代码

CREATE TABLE orders (
  order_id     STRING,
  user_id      STRING,
  order_amount DECIMAL(10, 2),
  order_time   TIMESTAMP_LTZ(3),
  WATERMARK FOR order_time AS order_time - INTERVAL '5' SECOND,
  proc_time AS PROCTIME()
) WITH (
  'connector' = 'kafka',
  'topic' = 'orders',
  'properties.bootstrap.servers' = '127.0.0.1:9092',
  'properties.group.id' = 'flink-orders-dim',
  'scan.startup.mode' = 'earliest-offset',
  'format' = 'json',
  'json.timestamp-format.standard' = 'ISO-8601'
);

你可以沿用上一篇中 Kafka 造数的方式，用 kafka-console-producer.sh 发送 JSON 订单数据，只需要保证字段名一致。

2. MySQL 用户维表 dim_user（JDBC Lookup 表）

然后把刚才在 MySQL 中建好的 dim_user 注册为 Flink 的 JDBC 表：

sql 复制代码

CREATE TABLE dim_user (
  user_id       STRING,
  user_name     STRING,
  user_level    STRING,
  city          STRING,
  register_time TIMESTAMP(3),
  PRIMARY KEY (user_id) NOT ENFORCED
) WITH (
  'connector' = 'jdbc',
  'url' = 'jdbc:mysql://127.0.0.1:3306/realtime_dwh',
  'table-name' = 'dim_user',
  'driver' = 'com.mysql.cj.jdbc.Driver',
  'username' = 'root',
  'password' = '1qaz@WSX'
);

注意几点：

PRIMARY KEY (user_id) NOT ENFORCED 告诉 Flink 这是一张以 user_id 为主键的表，是做时态 Join 的前提
这里使用的是典型的 JDBC Lookup 模式，Flink 会在 Join 时按需去 MySQL 查维度信息

在生产环境中，你可以把 MySQL 作为维度存储，或者通过 CDC 把维表变更同步到 Kafka，构造成 changelog 流，这些都可以和 Temporal Join 结合使用。

五、维表时态 Join：把订单打上用户维度

有了订单事实表 orders 和维度表 dim_user，就可以通过时态 Join 来构建订单明细宽表。

1. 基础时态 Join 语法

Flink SQL 中的 Temporal Table Join 对于 JDBC 这类 外部维表，通常采用「处理时间（Processing Time）」语义来做 Lookup Join，典型写法如下：

sql 复制代码

SELECT
  o.order_id,
  o.user_id,
  d.user_name,
  d.user_level,
  d.city,
  o.order_amount,
  o.order_time
FROM orders AS o
LEFT JOIN dim_user FOR SYSTEM_TIME AS OF o.proc_time AS d
ON o.user_id = d.user_id;

这里有几个关键点：

proc_time AS PROCTIME() 是在 orders 上定义的处理时间字段
FOR SYSTEM_TIME AS OF o.proc_time 表示"以 Flink 处理这条订单记录的当前时间，去查维表的一个快照"，这是 JDBC Lookup 支持的典型用法
Join 条件依然是 user_id 等值关联
使用 LEFT JOIN 可以保留找不到维度的订单，并用空值来表示"维度缺失"

在 SQL Client 中执行这段查询，会看到实时流式刷新的结果，每一行订单都带上了对应的用户属性。

2. 验证时态效果：修改维表再观察 Join

为了验证这是"时态 Join"而不是"始终查最新维度"，可以按下面步骤操作：

先往 Kafka 的 orders Topic 写入几条订单数据，例如用户 u_2 下单的记录
观察 Flink SQL 中 Join 后的结果，此时 u_2 的等级是 VIP2

回到 MySQL，执行：

sql 复制代码

UPDATE dim_user
SET user_level = 'VIP3'
WHERE user_id = 'u_2';

再写入一批新的订单，仍然是用户 u_2

bash 复制代码

bin/kafka-console-producer.sh --bootstrap-server 127.0.0.1:9092 --topic orders

在命令行中输入一条 JSON 数据（按回车发送一条）：

json 复制代码

{"order_id":"o_3","user_id":"u_2","order_amount":200.00,"order_time":"2026-02-19T14:42:00Z"}

这时你会看到：

变更前的订单，维度字段仍然显示 VIP2
变更后的订单，维度字段变成了 VIP3

这就说明 Flink 的时态 Join 确实是"按订单发生时刻去回放维度视图"的，而不是简单查当前最新值。

六、把结果写回 Kafka 或 MySQL，形成实时数仓明细层

在真实项目中，我们不会只在 SQL Client 里 SELECT 一下就结束，而是要把 Join 后的订单明细宽表，写回到下游存储，形成实时数仓的一个层级。

例如，可以把结果写回 Kafka，作为 DWD 层的订单宽表：

sql 复制代码

CREATE TABLE dwd_order_user_wide (
  order_id     STRING,
  user_id      STRING,
  user_name    STRING,
  user_level   STRING,
  city         STRING,
  order_amount DECIMAL(10, 2),
  order_time   TIMESTAMP_LTZ(3),
  WATERMARK FOR order_time AS order_time - INTERVAL '5' SECOND
) WITH (
  'connector' = 'kafka',
  'topic' = 'dwd_order_user_wide',
  'properties.bootstrap.servers' = '127.0.0.1:9092',
  'properties.group.id' = 'flink-dwd-order-wide',
  'scan.startup.mode' = 'earliest-offset',
  'format' = 'json',
  'json.timestamp-format.standard' = 'ISO-8601'
);

INSERT INTO dwd_order_user_wide
SELECT
  o.order_id,
  o.user_id,
  d.user_name,
  d.user_level,
  d.city,
  o.order_amount,
  o.order_time
FROM orders AS o
LEFT JOIN dim_user FOR SYSTEM_TIME AS OF o.proc_time AS d
ON o.user_id = d.user_id;

这样，下游的实时应用或 BI 查询就可以直接订阅 dwd_order_user_wide 这个 Topic，拿到已经打好用户标签的订单明细数据。

你也可以把结果同步到 MySQL、ClickHouse 等分析型数据库中，构建实时明细表，为报表和可视化提供数据。

七、小结与下一步建议

通过这篇文章，我们完成了这样一件事：

在 Kafka 中维护订单事实流 orders
在 MySQL 中维护用户维度表 dim_user
使用 Flink SQL 的 JDBC Connector 把 MySQL 注册为维表
利用 FOR SYSTEM_TIME AS OF 语法做维表时态 Join
将 Join 结果写回 Kafka，形成实时数仓中的一张订单明细宽表

这背后有几个非常重要的实时数仓设计理念：

事实流是不断追加的事件序列，维表是相对缓慢变更的业务视图
时态 Join 让你能够"按事件发生的时间点"，回看当时的维度快照
实时数仓的 DWD 层，往往就是「事实表 + 多个维表时态 Join」后形成的明细宽表

在后续的文章中，我们可以继续沿着这个方向深入：

在一个任务里同时关联多张维表，构建更宽的明细表
引入 CDC，把维表变更实时同步到 Kafka，再在 Flink 中构建 changelog 维表
把实时数仓的明细层、汇总层（DWS）、指标主题层（ADS）串起来，做一个端到端的实时数仓小项目

如果你已经跑通了本文的 Demo，不妨试着自己设计一张商品维表 dim_product，再给订单打上商品品类维度，体验一下"事实 + 多维表时态 Join"在 Flink SQL 里的完整味道。

原文来自:http://blog.daimajiangxin.com.cn