更新时间:2026-11-06 GMT+08:00
Print连接器
概述
Print连接器将数据输出到TaskManager的标准输出(日志),常用于开发和调试阶段快速查看Flink SQL作业的输出结果。
| 类别 | 详情 |
|---|---|
| 支持类型 | 结果表 |
| 运行模式 | 批模式和流模式 |
| 数据格式 | 暂不适用 |
| API种类 | SQL |
| 是否支持更新或删除结果表数据 | 是 |
适用场景
- 开发调试:快速验证Flink SQL处理逻辑的输出结果,无需搭建外部存储。
- 问题排查:在作业运行过程中实时观察数据流内容,定位数据处理问题。
- 数据抽样:通过标准输出查看少量数据样本,确认数据格式和内容。
约束与限制
- 仅支持作为Sink使用,不支持作为Source。
- 大数据量场景下可能影响性能,不建议在生产环境中使用。
语法结构
CREATE TABLE {table_name} (
{column_name} {column_type},
...
) WITH (
'connector' = 'print'
); WITH参数说明
| 参数 | 是否必填 | 类型 | 默认值 | 取值范围 | 说明 |
|---|---|---|---|---|---|
| connector | 是 | String | 无 | | 标识连接器类型为Print连接器。 必须填写且值固定为print。Flink运行时根据此值加载对应的Print SinkFactory,将表声明为Print输出表。 |
使用示例
- 示例1:创建一个最简Print Sink表,将数据直接输出到TaskManager日志。
-- 创建DataGen源表 CREATE TABLE datagen_source ( id BIGINT, name STRING, score DOUBLE ) WITH ( 'connector' = 'datagen', 'rows-per-second' = '10', 'fields.id.kind' = 'sequence', 'fields.id.start' = '1', 'fields.id.end' = '100' ); -- 创建Print结果表 CREATE TABLE print_sink ( id BIGINT, name STRING, score DOUBLE ) WITH ( 'connector' = 'print' ); -- 提交作业 INSERT INTO print_sink SELECT id, name, score FROM datagen_source;
- 示例2:当作业中存在多个Print Sink时,通过标识前缀区分不同数据流的输出。
-- 创建DataGen源表 CREATE TABLE datagen_source ( user_id INT, event_type STRING, event_time TIMESTAMP(3), WATERMARK FOR event_time AS event_time - INTERVAL '5' SECOND ) WITH ( 'connector' = 'datagen', 'rows-per-second' = '10', 'fields.user_id.kind' = 'sequence', 'fields.user_id.start' = '1', 'fields.user_id.end' = '100' ); -- 创建Print结果表(带标识前缀) CREATE TABLE print_sink_with_id ( user_id INT, event_type STRING, event_time TIMESTAMP(3) ) WITH ( 'connector' = 'print', 'print-identifier' = 'user-event' ); -- 提交作业 INSERT INTO print_sink_with_id SELECT user_id, event_type, event_time FROM datagen_source;
输出效果示例:
user-event> +I[1, login, 2024-01-01 10:00:00.000] user-event> +I[2, click, 2024-01-01 10:01:00.000]
- 示例3:使用DataGen生成模拟数据,通过Print输出结果,构建完整的零依赖测试链路。
-- 创建DataGen源表 CREATE TABLE datagen_source ( id INT, name STRING, event_time TIMESTAMP(3), WATERMARK FOR event_time AS event_time - INTERVAL '5' SECOND ) WITH ( 'connector' = 'datagen', 'rows-per-second' = '10', 'fields.id.kind' = 'sequence', 'fields.id.start' = '1', 'fields.id.end' = '100' ); -- 创建Print结果表 CREATE TABLE print_sink ( id INT, name STRING, event_time TIMESTAMP(3) ) WITH ( 'connector' = 'print', 'print-identifier' = 'debug-output' ); -- 提交作业:将源表数据写入结果表 INSERT INTO print_sink SELECT id, name, event_time FROM datagen_source;
父主题: 连接器