Cloudflare R2 가져오기

Cloudflare R2 가져오기

Cloudflare R2는 S3 Compatible API를 제공하기 때문에, DuckDB의 S3 지원을 그대로 사용해서 R2 버킷을 읽고 쓸 수 있어요.

출처: 공식문서

사전 준비 (Prerequisites)

R2 연동에는 httpfs 확장이 필요합니다. INSTALL SQL 명령으로 설치할 수 있고, 이 작업은 한 번만 실행하면 돼요.

자격증명과 설정

S3 auth token을 생성한 뒤 DuckDB에 R2 시크릿을 만들면 됩니다.

CREATE SECRET (
    TYPE r2,
    KEY_ID '⟨«redacted:AKIA…»⟩',
    SECRET '⟨wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY⟩',
    ACCOUNT_ID '⟨your-33-character-hexadecimal-account-ID⟩'
);

조회

R2 자격증명을 설정하고 나면 read_csv나 read_parquet 같은 DuckDB 내장 메서드로 R2 데이터를 조회할 수 있어요.

SELECT * FROM read_parquet('r2://⟨r2-bucket-name⟩/⟨file⟩');

더 알아보기 (Learn more)

• S3 호환 스토리지라면 httpfs 확장 하나로 R2·S3·MinIO 등 다양한 객체 스토리지를 같은 방식으로 다룰 수 있어요.
• 쓰기 작업이나 버킷 전역 글롭(glob) 패턴도 S3와 동일한 문법을 따릅니다.