# 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;
  ```
  
 
