Python pyflink TableResult.collect用法及代码示例

本文简要介绍 python 语言中 pyflink.table.TableResult.collect 的用法。

用法:

collect() → pyflink.table.table_result.CloseableIterator

将结果内容作为可关闭的行迭代器获取。

注意：

对于 SELECT 操作，除非已收集所有结果数据，否则作业不会完成。所以我们应该通过 CloseableIterator#close 方法主动关闭作业以避免资源泄漏。调用 CloseableIterator#close 方法将取消作业并释放相关资源。

对于 DML 操作，Flink 现在不支持获取实际受影响的行数。因此，对于每个接收器，受影响的行数始终为 -1(未知)，并且它们将被返回，直到作业完成。调用 CloseableIterator#close 方法将取消作业。

对于其他操作，不会提交任何 flink 作业(get_job_client() 始终为空)，并且结果是有界的。调用 CloseableIterator#close 方法时请注意。

调用 CloseableIterator#close 方法的推荐代码如下所示：

>>> table_result = t_env.execute("select ...")
>>> with table_result.collect() as results:
>>>    for result in results:
>>>        ...

为了将结果提取到本地，您可以调用collect() 和print()。但是，不能在同一个TableResult 实例上同时调用它们。

返回：

一个 CloseableIterator。

版本 1.12.0 中的新函数。