⌘+k ctrl+k
1.1.3 (stable)
Search Shortcut cmd + k | ctrl + k
Attach to a DuckDB Database over HTTPS or S3

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

先决条件

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

通过HTTPS连接到数据库

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

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;
站点数量
578

通过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;
站点数量
578

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

Limitations

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