更新时间:2026-11-06 GMT+08:00
分享

Print连接器

概述

Print连接器将数据输出到TaskManager的标准输出(日志),常用于开发和调试阶段快速查看Flink SQL作业的输出结果。

表1 连接器详情

类别

详情

支持类型

结果表

运行模式

批模式和流模式

数据格式

暂不适用

API种类

SQL

是否支持更新或删除结果表数据

是

适用场景

  • 开发调试:快速验证Flink SQL处理逻辑的输出结果,无需搭建外部存储。
  • 问题排查:在作业运行过程中实时观察数据流内容,定位数据处理问题。
  • 数据抽样:通过标准输出查看少量数据样本,确认数据格式和内容。

约束与限制

  • 仅支持作为Sink使用,不支持作为Source。
  • 大数据量场景下可能影响性能,不建议在生产环境中使用。

语法结构

CREATE TABLE {table_name} (
  {column_name} {column_type},
  ...
) WITH (
  'connector' = 'print'
);

WITH参数说明

参数

是否必填

类型

默认值

取值范围

说明

connector

是

String

无

print

标识连接器类型为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;

相关文档