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

先决条件

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

通过HTTPS连接到数据库

要通过HTTPS连接到DuckDB数据库，请使用ATTACH statement如下：

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

Note

自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;

Note

自DuckDB版本1.1起，ATTACH语句创建了一个到HTTP端点的只读连接。 在之前的版本中，必须使用READ_ONLY标志。

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

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

Note

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

Limitations

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