为 Apache Iceberg™ REST 目录配置目录集成

Apache Iceberg™ REST 目录集成 可让 Snowflake 访问远程目录中管理的 Apache Iceberg™ 表，该目录符合开源 Apache Iceberg REST OpenAPI 规范 (https://github.com/apache/iceberg/blob/main/open-api/rest-catalog-open-api.yaml)。

当使用 Iceberg REST 目录集成时，Snowflake 支持以下附加功能：

身份验证方法

Snowflake 支持 Iceberg REST 目录的以下身份验证方法：

  • OAuth

  • 持有者令牌或个人访问令牌 (PAT)

  • 签名版本 4 (SigV4)

支持的身份验证方法因 目录来源 而异。

凭证轮换

要轮换目录集成的凭证，您可以使用 ALTER CATALOG INTEGRATION 命令更新 Snowflake 用于对远程目录进行身份验证的凭证。

例如：

ALTER CATALOG INTEGRATION my_cat_int SET
  REST_AUTHENTICATION (
    OAUTH_CLIENT_SECRET = 'myNewSecret'
  );
Copy

连接选项

This section describes the connection options for Iceberg REST catalogs.

Vended credentials

除 外部卷 外，Snowflake 还支持 Iceberg REST 目录的以下连接选项：

支持的连接选项因 目录来源 而异。

Private connectivity

Snowflake supports connecting to Iceberg REST catalogs through private connectivity.

However, when you connect to the catalog through private connectivity, you must use an external volume to connect to the catalog data.

支持的连接选项因 目录来源 而异。

目录来源

Snowflake 支持任何符合 Iceberg REST 规范的外部目录服务器。

以下主题提供了常用 REST 目录的示例：

浏览远程目录

为 Iceberg REST 创建目录集成后，您可以使用以下 Snowflake 系统函数浏览目录中的命名空间和表：

将表迁移到 Iceberg REST 目录集成

在您为 Iceberg REST 创建目录集成后，如果需要，您可以将标准 Snowflake 数据库中与外部管理的 Iceberg 表关联的目录集成替换为您创建的目录集成。有关说明，请参阅 SYSTEM$SET_CATALOG_INTEGRATION。

语言: 中文