先决条件

从 S3 加载 Iceberg 文件需要 httpfs 和 iceberg 扩展。请使用 INSTALL SQL 命令进行安装。扩展只需安装一次。

INSTALL httpfs;
INSTALL iceberg;

要加载这些扩展，请使用 LOAD 命令

LOAD httpfs;
LOAD iceberg;

凭证

加载扩展后，请设置凭证和 S3 区域以读取数据。你可以使用访问密钥（Access Key）和密钥（Secret），或者使用令牌（Token）。

CREATE SECRET (
    TYPE s3,
    KEY_ID 'AKIAIOSFODNN7EXAMPLE',
    SECRET 'wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY',
    REGION 'us-east-1'
);

或者，使用 aws 扩展 自动检索凭据

CREATE SECRET (
    TYPE s3,
    PROVIDER credential_chain
);

从 S3 加载 Iceberg 表

在设置好扩展并正确配置 S3 凭证后，可以使用以下命令从 S3 读取 Iceberg 表

SELECT *
FROM iceberg_scan('s3://bucket/iceberg_table_folder/metadata/id.metadata.json');

请注意，你需要直接链接到元数据清单文件（manifest file）。否则，你将收到如下所示的错误

IO Error:
Cannot open file "s3://bucket/iceberg_table_folder/metadata/version-hint.text": No such file or directory