为 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'
);
连接选项¶
除 外部卷 外,Snowflake 还支持 Iceberg REST 目录的以下连接选项:
支持的连接选项因 目录来源 而异。
目录来源¶
Snowflake 支持任何符合 Iceberg REST 规范的外部目录服务器。
以下主题提供了常用 REST 目录的示例:
Snowflake Open Catalog。这些说明也适用于 Apache Polaris™。
浏览远程目录¶
为 Iceberg REST 创建目录集成后,您可以使用以下 Snowflake 系统函数浏览目录中的命名空间和表: