语法
参数
这些参数的说明分别与表函数s3、azureBlobStorage、HDFS 和 file 中对应参数的说明一致。
format 表示 Paimon 表中数据文件的格式。
对于 paimonS3,可使用可选参数 extra_credentials 传递 role_arn,以便在 ClickHouse Cloud 中实现基于角色的访问。有关配置步骤,请参见 安全访问 S3。
返回值
一个具有指定结构的表,用于读取指定 Paimon 表中的数据。限制
尚未实现读取时合并,因此无法读取主键表:读取器会直接返回 快照中所有数据文件的内容,其中仍包含已被后续 upsert 操作覆盖的旧行版本。因此,读取 schema 中声明了primary-key 的表会引发异常。
定义命名集合
下面是一个用于存储 URL 和凭据的命名集合配置示例:别名
表函数paimon 现为 paimonS3 的别名。
虚拟列
_path— 文件路径。类型:LowCardinality(String)。_file— 文件名。类型:LowCardinality(String)。_size— 文件大小 (以字节为单位) 。类型:Nullable(UInt64)。如果文件大小未知,则值为NULL。_time— 文件的最后修改时间。类型:Nullable(DateTime)。如果时间未知,则值为NULL。_etag— 文件的 ETag。类型:LowCardinality(String)。如果 ETag 未知,则值为NULL。
支持的数据类型
支持的分区键
Paimon 分区键支持的数据类型:CHARVARCHARBOOLEANDECIMALTINYINTSMALLINTINTEGERDATETIMETIMESTAMPTIMESTAMP WITH LOCAL TIME ZONEBIGINTFLOATDOUBLE