HTTPS 또는 S3로 DuckDB 데이터베이스 연결

HTTPS 또는 S3로 DuckDB 데이터베이스 연결 (Attach to a DuckDB Database over HTTPS or S3)

HTTPS나 S3 API를 통해 DuckDB 인스턴스에 읽기 전용(read-only) 연결을 만들 수 있습니다. 이 가이드는 httpfs 확장이 필요하며, INSTALL httpfs SQL 명령으로 설치할 수 있어요. 설치 명령은 한 번만 실행하면 됩니다.

출처: 공식문서

HTTPS로 데이터베이스 연결하기

HTTPS로 DuckDB 데이터베이스에 연결하려면 ATTACH 문을 다음과 같이 쓰세요:

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

그러면 데이터베이스를 이렇게 조회할 수 있습니다:

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

S3 API로 데이터베이스 연결하기

S3 API로 DuckDB 데이터베이스에 연결하려면, 필요하다면 먼저 버킷에 대한 인증을 설정합니다. 그 다음 ATTACH 문을 이렇게 사용해요:

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

데이터베이스를 이렇게 조회할 수 있습니다:

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

Google Cloud Storage(gs://) 같은 S3 호환 API로의 연결도 지원됩니다.

제한 사항 (Limitations)

  • 읽기 전용 연결만 허용됩니다. HTTPS 프로토콜이나 S3 API로 데이터베이스에 쓰는 것은 불가능해요.

더 알아보기 (Learn more)