公網訪問DLF Paimon REST公測說明 - Data Lake Formation

阿里雲資料湖構建（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