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)
- DuckDB 공식 문서: Attach to a DuckDB Database over HTTPS or S3
- 네트워크·클라우드 스토리지 개요: Network and Cloud Storage Overview
- HTTP에서 데이터 읽기: HTTP Import
- S3에서 데이터 가져오기: S3 Import