您可以通过 HTTPS 或 S3 API 与 DuckDB 实例建立只读连接。

先决条件

本指南需要 httpfs 扩展，您可以使用 INSTALL httpfs SQL 命令安装它。这只需运行一次。

通过 HTTPS 连接到数据库

要通过 HTTPS 连接到 DuckDB 数据库，请使用 ATTACH 语句，如下所示：

ATTACH 'https://blobs.duckdb.org/databases/stations.duckdb' AS stations_db;

从 DuckDB 1.1 版本开始，ATTACH 语句会创建到 HTTP 端点的只读连接。在早期版本中，必须使用 READ_ONLY 标志。

然后，可以使用以下方式查询数据库：

SELECT count(*) AS num_stations
FROM stations_db.stations;

通过 S3 API 连接到数据库

要通过 S3 API 连接到 DuckDB 数据库，请为您的存储桶配置身份验证（如果需要）。然后，使用 ATTACH 语句，如下所示：

ATTACH 's3://duckdb-blobs/databases/stations.duckdb' AS stations_db;

从 DuckDB 1.1 版本开始，ATTACH 语句会创建到 HTTP 端点的只读连接。在早期版本中，必须使用 READ_ONLY 标志。

可以使用以下方式查询数据库：

SELECT count(*) AS num_stations
FROM stations_db.stations;

也支持连接到 S3 兼容的 API，例如 Google Cloud Storage (gs://)。

限制

• 只允许只读连接，无法通过 HTTPS 协议或 S3 API 写入数据库。