INSERT 语句

INSERT 语句用来向表中添加行。

执行 INSERT 语句

Java

单条 INSERT 语句，可以使用 TableEnvironment 中的 executeSql() 方法执行。executeSql() 方法执行 INSERT 语句时会立即提交一个 Flink 作业，并且返回一个 TableResult 对象，通过该对象可以获取 JobClient 方便的操作提交的作业。 多条 INSERT 语句，使用 TableEnvironment 中的 createStatementSet 创建一个 StatementSet 对象，然后使用 StatementSet 中的 addInsertSql() 方法添加多条 INSERT 语句，最后通过 StatementSet 中的 execute() 方法来执行。

以下的例子展示了如何在 TableEnvironment 中执行一条 INSERT 语句，或者通过 StatementSet 执行多条 INSERT 语句。

Scala

单条 INSERT 语句，可以使用 TableEnvironment 中的 executeSql() 方法执行。executeSql() 方法执行 INSERT 语句时会立即提交一个 Flink 作业，并且返回一个 TableResult 对象，通过该对象可以获取 JobClient 方便的操作提交的作业。 多条 INSERT 语句，使用 TableEnvironment 中的 createStatementSet 创建一个 StatementSet 对象，然后使用 StatementSet 中的 addInsertSql() 方法添加多条 INSERT 语句，最后通过 StatementSet 中的 execute() 方法来执行。

以下的例子展示了如何在 TableEnvironment 中执行一条 INSERT 语句，或者通过 StatementSet 执行多条 INSERT 语句。

Python

单条 INSERT 语句，可以使用 TableEnvironment 中的 execute_sql() 方法执行。execute_sql() 方法执行 INSERT 语句时会立即提交一个 Flink 作业，并且返回一个 TableResult 对象，通过该对象可以获取 JobClient 方便的操作提交的作业。 多条 INSERT 语句，使用 TableEnvironment 中的 create_statement_set 创建一个 StatementSet 对象，然后使用 StatementSet 中的 add_insert_sql() 方法添加多条 INSERT 语句，最后通过 StatementSet 中的 execute() 方法来执行。

以下的例子展示了如何在 TableEnvironment 中执行一条 INSERT 语句，或者通过 StatementSet 执行多条 INSERT 语句。

SQL CLI

可以在 SQL CLI 中执行 INSERT 语句

以下的例子展示了如何在 SQL CLI 中执行一条 INSERT 语句。

Java

  1. TableEnvironment tEnv = TableEnvironment.create(...);
  3. // 注册一个 "Orders" 源表，和 "RubberOrders" 结果表
  4. tEnv.executeSql("CREATE TABLE Orders (`user` BIGINT, product VARCHAR, amount INT) WITH (...)");
  5. tEnv.executeSql("CREATE TABLE RubberOrders(product VARCHAR, amount INT) WITH (...)");
  7. // 运行一条 INSERT 语句，将源表的数据输出到结果表中
  8. TableResult tableResult1 = tEnv.executeSql(
  9.   "INSERT INTO RubberOrders SELECT product, amount FROM Orders WHERE product LIKE '%Rubber%'");
  10. // 通过 TableResult 来获取作业状态
  11. System.out.println(tableResult1.getJobClient().get().getJobStatus());
  13. //----------------------------------------------------------------------------
  14. // 注册一个 "GlassOrders" 结果表用于运行多 INSERT 语句
  15. tEnv.executeSql("CREATE TABLE GlassOrders(product VARCHAR, amount INT) WITH (...)");
  17. // 运行多条 INSERT 语句，将原表数据输出到多个结果表中
  18. StatementSet stmtSet = tEnv.createStatementSet();
  19. // `addInsertSql` 方法每次只接收单条 INSERT 语句
  20. stmtSet.addInsertSql(
  21.   "INSERT INTO RubberOrders SELECT product, amount FROM Orders WHERE product LIKE '%Rubber%'");
  22. stmtSet.addInsertSql(
  23.   "INSERT INTO GlassOrders SELECT product, amount FROM Orders WHERE product LIKE '%Glass%'");
  24. // 执行刚刚添加的所有 INSERT 语句
  25. TableResult tableResult2 = stmtSet.execute();
  26. // 通过 TableResult 来获取作业状态
  27. System.out.println(tableResult1.getJobClient().get().getJobStatus());

Scala

  1. val tEnv = TableEnvironment.create(...)
  3. // 注册一个 "Orders" 源表，和 "RubberOrders" 结果表
  4. tEnv.executeSql("CREATE TABLE Orders (`user` BIGINT, product STRING, amount INT) WITH (...)")
  5. tEnv.executeSql("CREATE TABLE RubberOrders(product STRING, amount INT) WITH (...)")
  7. // 运行一个 INSERT 语句，将源表的数据输出到结果表中
  8. val tableResult1 = tEnv.executeSql(
  9.   "INSERT INTO RubberOrders SELECT product, amount FROM Orders WHERE product LIKE '%Rubber%'")
  10. // 通过 TableResult 来获取作业状态
  11. println(tableResult1.getJobClient().get().getJobStatus())
  13. //----------------------------------------------------------------------------
  14. // 注册一个 "GlassOrders" 结果表用于运行多 INSERT 语句
  15. tEnv.executeSql("CREATE TABLE GlassOrders(product VARCHAR, amount INT) WITH (...)");
  17. // 运行多个 INSERT 语句，将原表数据输出到多个结果表中
  18. val stmtSet = tEnv.createStatementSet()
  19. // `addInsertSql` 方法每次只接收单条 INSERT 语句
  20. stmtSet.addInsertSql(
  21.   "INSERT INTO RubberOrders SELECT product, amount FROM Orders WHERE product LIKE '%Rubber%'")
  22. stmtSet.addInsertSql(
  23.   "INSERT INTO GlassOrders SELECT product, amount FROM Orders WHERE product LIKE '%Glass%'")
  24. // 执行刚刚添加的所有 INSERT 语句
  25. val tableResult2 = stmtSet.execute()
  26. // 通过 TableResult 来获取作业状态
  27. println(tableResult1.getJobClient().get().getJobStatus())

Python

  1. table_env = TableEnvironment.create(...)
  3. # 注册一个 "Orders" 源表，和 "RubberOrders" 结果表
  4. table_env.executeSql("CREATE TABLE Orders (`user` BIGINT, product STRING, amount INT) WITH (...)")
  5. table_env.executeSql("CREATE TABLE RubberOrders(product STRING, amount INT) WITH (...)")
  7. # 运行一条 INSERT 语句，将源表的数据输出到结果表中
  8. table_result1 = table_env \
  9.     .executeSql("INSERT INTO RubberOrders SELECT product, amount FROM Orders WHERE product LIKE '%Rubber%'")
  10. # 通过 TableResult 来获取作业状态
  11. print(table_result1.get_job_client().get_job_status())
  13. #----------------------------------------------------------------------------
  14. # 注册一个 "GlassOrders" 结果表用于运行多 INSERT 语句
  15. table_env.execute_sql("CREATE TABLE GlassOrders(product VARCHAR, amount INT) WITH (...)")
  17. # 运行多条 INSERT 语句，将原表数据输出到多个结果表中
  18. stmt_set = table_env.create_statement_set()
  19. # `add_insert_sql` 方法每次只接收单条 INSERT 语句
  20. stmt_set \
  21.     .add_insert_sql("INSERT INTO RubberOrders SELECT product, amount FROM Orders WHERE product LIKE '%Rubber%'")
  22. stmt_set \
  23.     .add_insert_sql("INSERT INTO GlassOrders SELECT product, amount FROM Orders WHERE product LIKE '%Glass%'")
  24. # 执行刚刚添加的所有 INSERT 语句
  25. table_result2 = stmt_set.execute()
  26. # 通过 TableResult 来获取作业状态
  27. print(table_result2.get_job_client().get_job_status())

SQL CLI

  1. Flink SQL> CREATE TABLE Orders (`user` BIGINT, product STRING, amount INT) WITH (...);
  2. [INFO] Table has been created.
  4. Flink SQL> CREATE TABLE RubberOrders(product STRING, amount INT) WITH (...);
  6. Flink SQL> SHOW TABLES;
  7. Orders
  8. RubberOrders
  10. Flink SQL> INSERT INTO RubberOrders SELECT product, amount FROM Orders WHERE product LIKE '%Rubber%';
  11. [INFO] Submitting SQL update statement to the cluster...
  12. [INFO] Table update statement has been successfully submitted to the cluster:

将 SELECT 查询数据插入表中

通过 INSERT 语句，可以将查询的结果插入到表中，

语法

  2. [EXECUTE] INSERT { INTO | OVERWRITE } [catalog_name.][db_name.]table_name [PARTITION part_spec] select_statement
  4. part_spec:
  5.   (part_col_name1=val1 [, part_col_name2=val2, ...])

OVERWRITE

INSERT OVERWRITE 将会覆盖表中或分区中的任何已存在的数据。否则，新数据会追加到表中或分区中。

PARTITION

PARTITION 语句应该包含需要插入的静态分区列与值。

COLUMN LIST

给定一个表 T(a INT, b INT, c INT)，Flink 支持 INSERT INTO T(c, b) SELECT x, y FROM S。 预期行为是 “x” 被写入 “c” 列，“y” 被写入 “b” 列，而 “a” 被设置为空值（假设 “a” 列可为空）。
连接器开发人员在处理部分列更新时，如果希望避免用空值覆盖非目标列，可以从 DynamicTableSink$Context.getTargetColumns() 中获取用户插入语句指定的目标列信息，然后决定如何处理部分更新。

示例

  1. -- 创建一个分区表
  2. CREATE TABLE country_page_view (user STRING, cnt INT, date STRING, country STRING)
  3. PARTITIONED BY (date, country)
  4. WITH (...)
  6. -- 追加行到该静态分区中 (date='2019-8-30', country='China')
  7. INSERT INTO country_page_view PARTITION (date='2019-8-30', country='China')
  8.   SELECT user, cnt FROM page_view_source;
  10. -- Insert语句的开头可以额外增加EXECUTE关键字,带EXECUTE关键字和不带是等价的
  11. EXECUTE INSERT INTO country_page_view PARTITION (date='2019-8-30', country='China')
  12.   SELECT user, cnt FROM page_view_source;
  14. -- 追加行到分区 (date, country) 中，其中 date 是静态分区 '2019-8-30'；country 是动态分区，其值由每一行动态决定
  15. INSERT INTO country_page_view PARTITION (date='2019-8-30')
  16.   SELECT user, cnt, country FROM page_view_source;
  18. -- 覆盖行到静态分区 (date='2019-8-30', country='China')
  19. INSERT OVERWRITE country_page_view PARTITION (date='2019-8-30', country='China')
  20.   SELECT user, cnt FROM page_view_source;
  22. -- 覆盖行到分区 (date, country) 中，其中 date 是静态分区 '2019-8-30'；country 是动态分区，其值由每一行动态决定
  23. INSERT OVERWRITE country_page_view PARTITION (date='2019-8-30')
  24.   SELECT user, cnt, country FROM page_view_source;

将值插入表中

通过 INSERT 语句，也可以直接将值插入到表中，

语法

  1. [EXECUTE] INSERT { INTO | OVERWRITE } [catalog_name.][db_name.]table_name VALUES values_row [, values_row ...]
  3. values_row:
  4.     : (val1 [, val2, ...])

OVERWRITE

INSERT OVERWRITE 将会覆盖表中的任何已存在的数据。否则，新数据会追加到表中。

示例

  2. CREATE TABLE students (name STRING, age INT, gpa DECIMAL(3, 2)) WITH (...);
  4. EXECUTE INSERT INTO students
  5.   VALUES ('fred flintstone', 35, 1.28), ('barney rubble', 32, 2.32);

插入数据到多张表

STATEMENT SET 可以实现通过一个语句插入数据到多个表。

语法

  1. EXECUTE STATEMENT SET
  2. BEGIN
  3. insert_statement;
  4. ...
  5. insert_statement;
  6. END;
  8. insert_statement:
  9.    <insert_from_select>|<insert_from_values>

示例

  2. CREATE TABLE students (name STRING, age INT, gpa DECIMAL(3, 2)) WITH (...);
  4. EXECUTE STATEMENT SET
  5. BEGIN
  6. INSERT INTO students
  7.   VALUES ('fred flintstone', 35, 1.28), ('barney rubble', 32, 2.32);
  8. INSERT INTO students
  9.   VALUES ('fred flintstone', 35, 1.28), ('barney rubble', 32, 2.32);
  10. END;