公网访问DLF Paimon REST公测说明 - 数据湖构建

阿里云数据湖构建（DLF）自 2026 年 2 月 5 日起，正式开放 DLF Paimon REST 的公网访问功能。本功能目前处于公测阶段。

前置条件与配置

在开始使用前，请确保满足以下客户端版本及服务端配置要求。

1. 客户端版本要求

必须使用以下版本的Paimon客户端：

Paimon Java 1.4-SNAPSHOT（需为 2026 年 1 月 30 日及之后构建的版本）。
PyPaimon（需为 2026 年 2 月 10 日及之后构建的版本）。
Paimon Java/Python 1.4 及更高版本（待发布）。

2. 开启公网访问权限

出于安全考虑，DLF 服务的公网访问入口默认关闭。DLF 管理员必须手动启用该功能：

登录数据湖构建控制台，进入数据目录。
单击目标数据目录，选择目录配置页签。
在高级配置中添加或修改参数：enable.openapi设置为true。

公测说明与限制

服务等级协议（SLA）：公测期间不提供 SLA 保障，但核心服务功能保持完整。
性能说明：公网访问受互联网链路波动影响，其吞吐量（QPS）和响应延迟性能低于 VPC 内网访问。此模式不适用于大规模、高并发的生产环境业务。

计费说明

本功能在公测期间免费。公测结束后的收费策略将另行公告。

配置示例

以下代码示例展示了如何使用客户端通过公网连接 DLF。

核心代码

Java

Options options = new Options();
// 配置 DLF 公网地址
options.set("uri", "https://dlfnext.cn-hangzhou.aliyuncs.com");
options.set("warehouse", "paimon_test");
options.set("dlf.region", "cn-hangzhou");
options.set("dlf.access-key-id", "您的AccessKeyId");
options.set("dlf.access-key-secret", "您的AccessKeySecret");
// 必须配置 OSS 公网 Endpoint
options.set("dlf.oss-endpoint", "oss-cn-hangzhou.aliyuncs.com");
options.set("token.provider", "dlf");

Catalog restCatalog = new RESTCatalog(CatalogContext.create(options));

配置项	说明	示例值
uri	DLF OpenAPI公网服务地址。详情请参见服务接入点。	https://dlfnext.cn-hangzhou.aliyuncs.com
warehouse	DLF 数据目录名称。	paimon_test
dlf.region	DLF 服务所在的地域 ID（Region ID）。	cn-hangzhou
dlf.access-key-id	阿里云账号或 RAM 用户的 AccessKey ID。	-
dlf.access-key-secret	阿里云账号或 RAM 用户的 AccessKey Secret。	-
dlf.oss-endpoint	OSS 公网访问地址。详情请参见地域和Endpoint	oss-cn-hangzhou.aliyuncs.com
token.provider	鉴权提供方，请固定设置为`dlf`。	dlf

Python

from pypaimon import CatalogFactory

options = {
    # Python 客户端必须指定 metastore 类型为 rest
    'metastore': 'rest',
    'uri': 'https://dlfnext.cn-hangzhou.aliyuncs.com',
    'warehouse': 'paimon_test',
    'dlf.region': 'cn-hangzhou',
    'dlf.access-key-id': '您的AccessKeyId',
    'dlf.access-key-secret': '您的AccessKeySecret',
    # 若使用 STS 临时凭证，请配置此项
    'dlf.security-token': '您的SecurityToken',
    'dlf.oss-endpoint': 'oss-cn-hangzhou.aliyuncs.com',
    'token.provider': 'dlf',
}

rest_catalog = CatalogFactory.create(options)

配置项	说明	示例值
metastore	元数据存储类型。固定值`rest`。	rest
uri	DLF OpenAPI公网服务地址。详情请参见服务接入点。	https://dlfnext.cn-hangzhou.aliyuncs.com
warehouse	DLF 数据目录名称。	paimon_test
dlf.region	DLF 服务所在的地域 ID（Region ID）。	cn-hangzhou
dlf.access-key-id	阿里云账号或 RAM 用户的 AccessKey ID。	-
dlf.access-key-secret	阿里云账号或 RAM 用户的 AccessKey Secret。	-
dlf.security-token	STS 安全令牌。如果使用长期有效的 AccessKey，则无需配置。	-
dlf.oss-endpoint	OSS 公网访问地址。详情请参见地域和Endpoint	oss-cn-hangzhou.aliyuncs.com
token.provider	鉴权提供方，请固定设置为`dlf`。	dlf