大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:Paimon JDBC Catalog

· 52CE 我爱测

自 4.1.5 版本起,创建或修改 Catalog 时会统一校验 JDBC 驱动地址:不带协议的值只能是匹配 的文件名;需要绝对路径时使用 。URL 解码后的路径不得含 父目录段。现有驱动安全路径及 URL 白名单限制仍然生效。

本文档用于介绍通过 CREATE CATALOG 语句连接并访问使用 JDBC 接口的 Paimon Catalog 元数据服务时所支持的参数。

该功能为试验功能,自 4.1.0 版本支持。

参数总览

属性名称 描述 默认值 是否必须
paimon.jdbc.uri 指定 JDBC 连接地址 - 是
paimon.jdbc.user JDBC 连接用户名 - 是
paimon.jdbc.password JDBC 连接密码 - 是
warehouse 指定 Paimon warehouse - 是
paimon.jdbc.driver_class JDBC 驱动类名,如 org.postgresql.Driver,com.mysql.cj.jdbc.Driver 等 - 否
paimon.jdbc.driver_url JDBC 驱动 JAR 包的路径 - 否

注:

  1. Paimon JDBC Catalog 支持多种关系型数据库作为后端存储,包括 PostgreSQL、MySQL 等。

  2. 需要确保 JDBC 驱动 JAR 包可访问。可以通过 paimon.jdbc.driver_url 指定驱动位置。

自 4.1.5 版本起,创建或修改 Catalog 时会统一校验 JDBC 驱动地址:不带协议的值只能是匹配 [A-Za-z0-9._-]+.jar 的文件名;需要绝对路径时使用 file:///...。URL 解码后的路径不得含 .. 父目录段。现有驱动安全路径及 URL 白名单限制仍然生效。

示例配置

PostgreSQL 作为元数据存储

使用 PostgreSQL 数据库存储 Paimon 元数据:

CREATE CATALOG paimon_jdbc_postgresql PROPERTIES (
    'type' = 'paimon',
    'paimon.catalog.type' = 'jdbc',
    'paimon.jdbc.uri' = 'jdbc:postgresql://127.0.0.1:5432/paimon_db',
    'paimon.jdbc.user' = 'paimon_user',
    'paimon.jdbc.password' = 'password',
    'paimon.jdbc.driver_class' = 'org.postgresql.Driver',
    'paimon.jdbc.driver_url' = '<jdbc_driver_jar>',
    'warehouse' = 's3://bucket/warehouse',
    's3.access_key' = '<ak>',
    's3.secret_key' = '<sk>',
    's3.endpoint' = 'https://s3.us-east-1.amazonaws.com',
    's3.region' = 'us-east-1'
);

MySQL 作为元数据存储

使用 MySQL 数据库存储 Paimon 元数据:

CREATE CATALOG paimon_jdbc_mysql PROPERTIES (
    'type' = 'paimon',
    'paimon.catalog.type' = 'jdbc',
    'paimon.jdbc.uri' = 'jdbc:mysql://127.0.0.1:3306/paimon_db',
    'paimon.jdbc.user' = 'paimon_user',
    'paimon.jdbc.password' = 'password',
    'paimon.jdbc.driver_class' = 'com.mysql.cj.jdbc.Driver',
    'paimon.jdbc.driver_url' = '<jdbc_driver_jar>',
    'warehouse' = 's3://bucket/warehouse',
    's3.access_key' = '<ak>',
    's3.secret_key' = '<sk>',
    's3.endpoint' = 'https://s3.us-east-1.amazonaws.com',
    's3.region' = 'us-east-1'
);

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。