DuckDB가 만드는 파일

DuckDB가 만드는 파일 (Files Created by DuckDB)

DuckDB는 디스크에 여러 파일과 디렉토리를 만들어요. 이 페이지에서는 **전역(global)**으로 만들어지는 것과 **로컬(local)**로 만들어지는 것을 구분해서 정리할게요.

출처: 공식문서

DuckDB는 사용자 홈 디렉토리(~로 표기)에 다음과 같은 전역 파일·디렉토리를 만들어요.

위치	설명	버전 간 공유	클라이언트 간 공유
`~/.duckdbrc`	DuckDB CLI 클라이언트를 시작할 때 실행되는 내용이 담겨요. 닷 커맨드(dot command)와 SQL 구문이 모두 올 수 있어요. 파일 이름은 `~/.bashrc`, `~/.zshrc`처럼 "run commands" 파일 규칙을 따릅니다.	예	CLI 전용
`~/.duckdb_history`	`~/.bash_history`, `~/.zsh_history`와 비슷한 히스토리 파일이에요. DuckDB CLI 클라이언트가 사용해요.	예	CLI 전용
`~/.duckdb/extensions`	설치된 확장(extension)의 바이너리예요.	아니요	예
`~/.duckdb/stored_secrets`	Secrets manager가 만든 영속 시크릿(persistent secret)이에요.	예	예

DuckDB는 인메모리 연결이면 작업 디렉토리에, 영속 연결이면 데이터베이스 파일 기준으로 다음과 같은 파일·디렉토리를 만들어요.

이름	설명	예시
`⟨database_filename⟩`	데이터베이스 파일. 디스크 모드(on-disk mode)에서만 생성돼요. 확장자는 아무거나 가능하지만 보통 `.duckdb`, `.db`, `.ddb`를 써요.	`weather.duckdb`
`.tmp/`	임시 디렉토리. 인메모리 모드에서만 생성돼요.	`.tmp/`
`⟨database_filename⟩.tmp/`	임시 디렉토리. 디스크 모드에서만 생성돼요.	`weather.tmp/`
`⟨database_filename⟩.wal`	Write-ahead log (WAL) 파일. DuckDB가 정상 종료하면 WAL 파일은 종료 시 삭제돼요. 크래시가 나면 데이터를 복구하는 데 WAL 파일이 필요해요.	`weather.wal`

Git 저장소에서 작업 중이라 이 파일들을 Git이 추적하지 않게 하고 싶다면, DuckDB용 .gitignore 설정 가이드를 참고하세요.