您可以通过 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 '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，例如 Google Cloud Storage (gs://)。

限制

• 仅允许建立只读连接，无法通过 HTTPS 协议或 S3 API 对数据库进行写入操作。