Python pyflink StatementSet.add_insert用法及代碼示例

本文簡要介紹 python 語言中 pyflink.table.StatementSet.add_insert 的用法。

用法:

add_insert(target_path_or_descriptor: Union[str, pyflink.table.table_descriptor.TableDescriptor], table, overwrite: bool = False) → pyflink.table.statement_set.StatementSet

添加一條語句，將給定 Table 對象定義的管道應寫入在指定路徑下注冊或通過給定 TableDescriptor 表示的表(由 DynamicTableSink 支持)。

1. 當target_path_or_descriptor 是故事路徑時：

   有關路徑解析的規則，請參閱use_database() 或use_catalog() 的文檔。

2. 當target_path_or_descriptor 是表說明符時：

   給定的 TableDescriptor 注冊為內聯(即匿名)臨時目錄表(請參閱 create_temporary_table() )。

   然後將一條語句添加到將 Table 對象的管道插入該臨時表的語句集中。

   此方法允許為接收器說明符聲明一個模式。該聲明類似於 SQL 中的 {@code CREATE TABLE} DDL，並允許：

   1. 使用自定義 DataType 覆蓋自動派生列

   2. 在物理列旁邊添加元數據列

   3. 聲明一個主鍵

   可以聲明沒有物理/常規列的模式。在這種情況下，這些列將自動派生並隱式放置在模式聲明的開頭。

   例子：

   >>> stmt_set = table_env.create_statement_set()
   >>> source_table = table_env.from_path("SourceTable")
   >>> sink_descriptor = TableDescriptor.for_connector("blackhole") \
   ...     .schema(Schema.new_builder()
   ...         .build()) \
   ...     .build()
   >>> stmt_set.add_insert(sink_descriptor, source_table)

   注意

   表說明符的add_insert(案例 2.)是從 flink 1.14.0 添加的。

參數：

• target_path_or_descriptor- 注冊路徑TableSink或說明應插入數據的接收器表的說明符Table是寫的。

• table(pyflink.table.Table) - 要添加的表。

• overwrite- 指示插入是否應覆蓋現有數據。

返回：

當前StatementSet 實例。

版本 1.11.0 中的新函數。