JdbcSink 简析

---

1、JdbcSink

  用于DataStream增加Jdbc的Sink输出，主要两个接口：sink()和exactlyOnceSink()。其中exactlyOnceSink()是13版本新增的支持事务性的接口，本次主要介绍sink()接口。

public static <T> SinkFunction<T> sink(
        String sql,
        JdbcStatementBuilder<T> statementBuilder,
        JdbcExecutionOptions executionOptions,
        JdbcConnectionOptions connectionOptions) {
   
   
    return new GenericJdbcSinkFunction<>(
            new JdbcBatchingOutputFormat<>(
                    new SimpleJdbcConnectionProvider(connectionOptions),
                    executionOptions,
                    context -> {
   
   
                        Preconditions.checkState(
                                !context.getExecutionConfig().isObjectReuseEnabled(),
                                "objects can not be reused with JDBC sink function");
                        return JdbcBatchStatementExecutor.simple(
                                sql, statementBuilder, Function.identity());
                    },
                    JdbcBatchingOutputFormat.RecordExtractor.identity()));
}

1.1、参数

  接口有四个参数，其中第三个参数executionOptions可以省略使用默认值，具体样例参看1、JdbcSink方式

• sql

  String类型，一个SQL语句模板，就是通常使用的PreparedStatement那种形式，例如：insert into wordcount (wordcl, countcl) values (?,?)

• statementBuilder

  JdbcStatementBuilder类型，作用是完成流数据与SQL具体列的对应，基于上一个参数的PreparedStatement形式，完成对应关系

• executionOptions

  Flink Jdbc输出的执行规则，主要设置执行触发机制，主要设置三个参数：数据量触发阈值、时间触发阈值、最大重试次数。其中，数据量触发默认为5000，时间触发默认为0，即关闭时间触发。注意触发阈值不要设置的过低，否则可能造成数据库的阻塞。

• connectionOptions

  JdbcConnectionOptions类型，用于设置数据库连接属性，包括Url、Driver、Username、Password等

1.2、返回

  接口返回的是一个基于SinkFunction实现的GenericJdbcSinkFunction类，其核心是参数JdbcBatchingOutputFormat。

  GenericJdbcSinkFunction的结果核心方法如下，都是基于JdbcBatchingOutputFormat的操作。

@Override
public void open(Configuration parameters) throws Exception {
   
   
    super.open(parameters);
    RuntimeContext ctx = getRuntimeContext();
    outputFormat.setRuntimeContext(ctx)