Wrangler commands (Wrangler 명령)

원문 보기 위키 갱신 2026.10.07

이 문서는 D1 데이터베이스를 만들고, 관리하고, 쿼리하기 위한 Wrangler CLI 명령들을 설명해요.

출처: 문서

본문

D1 Wrangler 명령은 REST API를 사용해 컨트롤 플레인과 상호작용해요. 이 페이지는 D1을 위한 Wrangler 명령들을 나열해요.

`d1 create`

새 D1 데이터베이스를 만들고, 설정 파일에 넣을 바인딩과 UUID를 제공해요

이 명령은 원격(remote) D1 데이터베이스에 대해 동작해요.

npm:

npx wrangler d1 create <NAME>

yarn:

yarn wrangler d1 create <NAME>

pnpm:

pnpm wrangler d1 create <NAME>

<NAME> string 필수

새 D1 데이터베이스의 이름이에요
--location string 새 DB의 primary 위치에 대한 힌트예요. 옵션: weur: 서유럽(Western Europe), eeur: 동유럽(Eastern Europe), apac: 아시아 태평양(Asia Pacific), oc: 오세아니아(Oceania), wnam: 서북미(Western North America), enam: 동북미(Eastern North America)
--jurisdiction string 지역 규정을 준수하기 위해 D1 데이터베이스가 실행되고 데이터를 저장할 위치를 제한하는 위치예요. 관할권(jurisdiction)이 설정되면 위치 힌트는 무시된다는 점에 유의하세요. 옵션: eu: 유럽 연합(European Union), fedramp: FedRAMP 규격 데이터 센터, us: 미국(United States)
--use-remote boolean 새로 생성된 리소스를 설정에 추가할 때 원격 바인딩을 사용해요
--update-config boolean 새로 추가된 리소스로 설정 파일을 자동으로 업데이트해요
--binding string Worker에서 이 리소스의 바인딩 이름이에요

전역 플래그 (Global flags)

--v boolean 별칭: --version

버전 번호 표시
--cwd string현재 작업 디렉터리 대신 지정된 디렉터리에서 Wrangler가 시작된 것처럼 실행해요
--config string 별칭: --c

Wrangler 설정 파일 경로
--env string 별칭: --e

작업에 사용할 환경이며 .env와 .dev.vars 파일 선택에도 사용돼요
--env-file string불러올 .env 파일 경로 — 여러 번 지정할 수 있어요 — 앞선 파일의 값은 이후 파일의 값으로 덮어써져요
--install-skills boolean 기본값: false

명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요
--profile string특정 auth 프로필을 사용해요

`d1 info`

D1 데이터베이스에 대한 정보(현재 데이터베이스 크기와 상태 포함)를 가져와요

이 명령은 원격(remote) D1 데이터베이스에 대해 동작해요.

npm:

npx wrangler d1 info <NAME>

yarn:

yarn wrangler d1 info <NAME>

pnpm:

pnpm wrangler d1 info <NAME>

<NAME> string 필수

DB의 이름이에요
--json boolean 기본값: false

출력을 JSON으로 반환해요

전역 플래그 (Global flags)

--v boolean 별칭: --version

버전 번호 표시
--cwd string현재 작업 디렉터리 대신 지정된 디렉터리에서 Wrangler가 시작된 것처럼 실행해요
--config string 별칭: --c

Wrangler 설정 파일 경로
--env string 별칭: --e

작업에 사용할 환경이며 .env와 .dev.vars 파일 선택에도 사용돼요
--env-file string불러올 .env 파일 경로 — 여러 번 지정할 수 있어요 — 앞선 파일의 값은 이후 파일의 값으로 덮어써져요
--install-skills boolean 기본값: false

명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요
--profile string특정 auth 프로필을 사용해요

`d1 list`

계정의 모든 D1 데이터베이스를 나열해요

이 명령은 원격(remote) D1 데이터베이스에 대해 동작해요.

npm:

npx wrangler d1 list

yarn:

yarn wrangler d1 list

pnpm:

pnpm wrangler d1 list

--json boolean 기본값: false

출력을 JSON으로 반환해요

전역 플래그 (Global flags)

--v boolean 별칭: --version

버전 번호 표시
--cwd string현재 작업 디렉터리 대신 지정된 디렉터리에서 Wrangler가 시작된 것처럼 실행해요
--config string 별칭: --c

Wrangler 설정 파일 경로
--env string 별칭: --e

작업에 사용할 환경이며 .env와 .dev.vars 파일 선택에도 사용돼요
--env-file string불러올 .env 파일 경로 — 여러 번 지정할 수 있어요 — 앞선 파일의 값은 이후 파일의 값으로 덮어써져요
--install-skills boolean 기본값: false

명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요
--profile string특정 auth 프로필을 사용해요

`d1 delete`

D1 데이터베이스를 삭제해요

이 명령은 원격(remote) D1 데이터베이스에 대해 동작해요.

npm:

npx wrangler d1 delete <NAME>

yarn:

yarn wrangler d1 delete <NAME>

pnpm:

pnpm wrangler d1 delete <NAME>

<NAME> string 필수

DB의 이름 또는 바인딩이에요
--skip-confirmation boolean 별칭: --y기본값: false

확인 단계를 건너뛰어요

전역 플래그 (Global flags)

--v boolean 별칭: --version

버전 번호 표시
--cwd string현재 작업 디렉터리 대신 지정된 디렉터리에서 Wrangler가 시작된 것처럼 실행해요
--config string 별칭: --c

Wrangler 설정 파일 경로
--env string 별칭: --e

작업에 사용할 환경이며 .env와 .dev.vars 파일 선택에도 사용돼요
--env-file string불러올 .env 파일 경로 — 여러 번 지정할 수 있어요 — 앞선 파일의 값은 이후 파일의 값으로 덮어써져요
--install-skills boolean 기본값: false

명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요
--profile string특정 auth 프로필을 사용해요

`d1 execute`

명령 또는 SQL 파일을 실행해요

이 명령이 성공적으로 실행되려면 --command 또는 --file 중 하나를 제공해야 해요.

npm:

npx wrangler d1 execute <DATABASE>

yarn:

yarn wrangler d1 execute <DATABASE>

pnpm:

pnpm wrangler d1 execute <DATABASE>

<DATABASE> string 필수

DB의 이름 또는 바인딩이에요
--command string 실행하려는 SQL 쿼리, 또는 ';'로 구분된 여러 쿼리예요
--file string 수집할 .sql 파일이에요
--yes boolean 별칭: --y

모든 프롬프트에 "yes"라고 답해요
--local boolean wrangler dev에서 사용할 로컬 DB에 대해 명령/파일을 실행해요
--remote boolean 원격 바인딩 또는 배포된 Worker에서 사용할 원격 D1 데이터베이스에 대해 명령/파일을 실행해요
--persist-to string 로컬 지속성을 위해 사용할 디렉터리를 지정해요 (--local과 함께 사용)
--json boolean 기본값: false

출력을 JSON으로 반환해요
--preview boolean 기본값: false

미리보기(preview) D1 데이터베이스에 대해 명령/파일을 실행해요

전역 플래그 (Global flags)

--v boolean 별칭: --version

버전 번호 표시
--cwd string현재 작업 디렉터리 대신 지정된 디렉터리에서 Wrangler가 시작된 것처럼 실행해요
--config string 별칭: --c

Wrangler 설정 파일 경로
--env string 별칭: --e

작업에 사용할 환경이며 .env와 .dev.vars 파일 선택에도 사용돼요
--env-file string불러올 .env 파일 경로 — 여러 번 지정할 수 있어요 — 앞선 파일의 값은 이후 파일의 값으로 덮어써져요
--install-skills boolean 기본값: false

명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요
--profile string특정 auth 프로필을 사용해요

`d1 export`

데이터베이스의 내용 또는 스키마를 .sql 파일로 내보내요

npm:

npx wrangler d1 export <NAME>

yarn:

yarn wrangler d1 export <NAME>

pnpm:

pnpm wrangler d1 export <NAME>

<NAME> string 필수

내보낼 D1 데이터베이스의 이름이에요
--local boolean wrangler dev에서 사용하는 로컬 DB에서 내보내요
--remote boolean 원격 D1 데이터베이스에서 내보내요
--skip-confirmation boolean 별칭: --y기본값: false

확인 단계를 건너뛰어요
--output string 필수

내보내기에 대한 SQL 파일 경로예요
--table string 내보내기에 포함할 테이블을 지정해요
--no-schema boolean DB 스키마가 아닌 테이블 내용만 출력해요
--no-data boolean DB 내용이 아닌 테이블 스키마만 출력해요

전역 플래그 (Global flags)

--v boolean 별칭: --version

버전 번호 표시
--cwd string현재 작업 디렉터리 대신 지정된 디렉터리에서 Wrangler가 시작된 것처럼 실행해요
--config string 별칭: --c

Wrangler 설정 파일 경로
--env string 별칭: --e

작업에 사용할 환경이며 .env와 .dev.vars 파일 선택에도 사용돼요
--env-file string불러올 .env 파일 경로 — 여러 번 지정할 수 있어요 — 앞선 파일의 값은 이후 파일의 값으로 덮어써져요
--install-skills boolean 기본값: false

명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요
--profile string특정 auth 프로필을 사용해요

`d1 time-travel info`

Time Travel을 사용해 특정 시점에서 데이터베이스에 대한 정보를 검색해요

이 명령은 원격(remote) D1 데이터베이스에 대해 동작해요.

Time Travel에 대한 자세한 내용은 https://developers.cloudflare.com/d1/reference/time-travel/ 을 참고하세요.

npm:

npx wrangler d1 time-travel info <DATABASE>

yarn:

yarn wrangler d1 time-travel info <DATABASE>

pnpm:

pnpm wrangler d1 time-travel info <DATABASE>

<DATABASE> string 필수

DB의 이름 또는 바인딩이에요
--timestamp string 북마크를 검색할 Unix(epoch로부터의 초) 또는 RFC3339 타임스탬프(예: 2023-07-13T08:46:42.228Z)를 받아요
--json boolean 기본값: false

출력을 JSON으로 반환해요

전역 플래그 (Global flags)

--v boolean 별칭: --version

버전 번호 표시
--cwd string현재 작업 디렉터리 대신 지정된 디렉터리에서 Wrangler가 시작된 것처럼 실행해요
--config string 별칭: --c

Wrangler 설정 파일 경로
--env string 별칭: --e

작업에 사용할 환경이며 .env와 .dev.vars 파일 선택에도 사용돼요
--env-file string불러올 .env 파일 경로 — 여러 번 지정할 수 있어요 — 앞선 파일의 값은 이후 파일의 값으로 덮어써져요
--install-skills boolean 기본값: false

명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요
--profile string특정 auth 프로필을 사용해요

`d1 time-travel restore`

데이터베이스를 특정 시점으로 복원해요

이 명령은 원격(remote) D1 데이터베이스에 대해 동작해요.

Time Travel에 대한 자세한 내용은 https://developers.cloudflare.com/d1/reference/time-travel/ 을 참고하세요.

npm:

npx wrangler d1 time-travel restore <DATABASE>

yarn:

yarn wrangler d1 time-travel restore <DATABASE>

pnpm:

pnpm wrangler d1 time-travel restore <DATABASE>

<DATABASE> string 필수

DB의 이름 또는 바인딩이에요
--bookmark string 시간 여행(time travel)에 사용할 북마크예요
--timestamp string 북마크를 검색할 Unix(epoch로부터의 초) 또는 RFC3339 타임스탬프(예: 2023-07-13T08:46:42.228Z)를 받아요 (지난 30일 이내)
--json boolean 기본값: false

출력을 JSON으로 반환해요

전역 플래그 (Global flags)

--v boolean 별칭: --version

버전 번호 표시
--cwd string현재 작업 디렉터리 대신 지정된 디렉터리에서 Wrangler가 시작된 것처럼 실행해요
--config string 별칭: --c

Wrangler 설정 파일 경로
--env string 별칭: --e

작업에 사용할 환경이며 .env와 .dev.vars 파일 선택에도 사용돼요
--env-file string불러올 .env 파일 경로 — 여러 번 지정할 수 있어요 — 앞선 파일의 값은 이후 파일의 값으로 덮어써져요
--install-skills boolean 기본값: false

명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요
--profile string특정 auth 프로필을 사용해요

`d1 migrations create`

새 마이그레이션을 만들어요

이 명령은 'migrations' 폴더 안에 새 버전 지정(versioned) 파일을 생성해요. 마이그레이션 파일을 변경 내용에 대한 설명으로 이름 지어 주세요. 그러면 'migrations' 폴더에서 마이그레이션을 더 쉽게 찾을 수 있어요. 예시 파일 이름은 다음과 같아요:

0000_create_user_table.sql

파일 이름에는 버전 번호와 지정한 마이그레이션 이름이 포함될 거예요.

npm:

npx wrangler d1 migrations create <DATABASE> <MESSAGE>

yarn:

yarn wrangler d1 migrations create <DATABASE> <MESSAGE>

pnpm:

pnpm wrangler d1 migrations create <DATABASE> <MESSAGE>

<DATABASE> string 필수

DB의 이름 또는 바인딩이에요
<MESSAGE> string 필수

마이그레이션 메시지예요

전역 플래그 (Global flags)

--v boolean 별칭: --version

버전 번호 표시
--cwd string현재 작업 디렉터리 대신 지정된 디렉터리에서 Wrangler가 시작된 것처럼 실행해요
--config string 별칭: --c

Wrangler 설정 파일 경로
--env string 별칭: --e

작업에 사용할 환경이며 .env와 .dev.vars 파일 선택에도 사용돼요
--env-file string불러올 .env 파일 경로 — 여러 번 지정할 수 있어요 — 앞선 파일의 값은 이후 파일의 값으로 덮어써져요
--install-skills boolean 기본값: false

명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요
--profile string특정 auth 프로필을 사용해요

`d1 migrations list`

적용되지 않은 마이그레이션 파일 목록을 봐요

npm:

npx wrangler d1 migrations list <DATABASE>

yarn:

yarn wrangler d1 migrations list <DATABASE>

pnpm:

pnpm wrangler d1 migrations list <DATABASE>

<DATABASE> string 필수

DB의 이름 또는 바인딩이에요
--local boolean wrangler dev에서 사용할 로컬 DB에 대해 마이그레이션을 확인해요
--remote boolean wrangler dev --remote에서 사용할 원격 DB에 대해 마이그레이션을 확인해요
--preview boolean 기본값: false

미리보기(preview) D1 DB에 대해 마이그레이션을 확인해요
--persist-to string 로컬 지속성을 위해 사용할 디렉터리를 지정해요 (이 플래그와 함께 --local을 사용해야 해요)

전역 플래그 (Global flags)

--v boolean 별칭: --version

버전 번호 표시
--cwd string현재 작업 디렉터리 대신 지정된 디렉터리에서 Wrangler가 시작된 것처럼 실행해요
--config string 별칭: --c

Wrangler 설정 파일 경로
--env string 별칭: --e

작업에 사용할 환경이며 .env와 .dev.vars 파일 선택에도 사용돼요
--env-file string불러올 .env 파일 경로 — 여러 번 지정할 수 있어요 — 앞선 파일의 값은 이후 파일의 값으로 덮어써져요
--install-skills boolean 기본값: false

명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요
--profile string특정 auth 프로필을 사용해요

`d1 migrations apply`

적용되지 않은 D1 마이그레이션을 적용해요

이 명령은 적용하려는 마이그레이션을 확인하라고 프롬프트를 띄워요. 계속 진행할지 확인하세요. 적용 후에는 백업이 캡처돼요.

각 마이그레이션의 진행 상황이 콘솔에 출력돼요.

CI/CD 환경이나 다른 비대화형(non-interactive) 명령줄에서 apply 명령을 실행할 때는 확인 단계가 건너뛰어지지만 백업은 여전히 캡처돼요.

마이그레이션을 적용하다가 오류가 발생하면 해당 마이그레이션은 롤백되고, 이전에 성공한 마이그레이션은 계속 적용된 상태로 유지돼요.

npm:

npx wrangler d1 migrations apply <DATABASE>

yarn:

yarn wrangler d1 migrations apply <DATABASE>

pnpm:

pnpm wrangler d1 migrations apply <DATABASE>

<DATABASE> string 필수

DB의 이름 또는 바인딩이에요
--local boolean wrangler dev에서 사용할 로컬 DB에 대해 명령/파일을 실행해요
--remote boolean wrangler dev --remote에서 사용할 원격 DB에 대해 명령/파일을 실행해요
--preview boolean 기본값: false

미리보기(preview) D1 DB에 대해 명령/파일을 실행해요
--persist-to string 로컬 지속성을 위해 사용할 디렉터리를 지정해요 (이 플래그와 함께 --local을 사용해야 해요)

전역 플래그 (Global flags)

--v boolean 별칭: --version

버전 번호 표시
--cwd string현재 작업 디렉터리 대신 지정된 디렉터리에서 Wrangler가 시작된 것처럼 실행해요
--config string 별칭: --c

Wrangler 설정 파일 경로
--env string 별칭: --e

작업에 사용할 환경이며 .env와 .dev.vars 파일 선택에도 사용돼요
--env-file string불러올 .env 파일 경로 — 여러 번 지정할 수 있어요 — 앞선 파일의 값은 이후 파일의 값으로 덮어써져요
--install-skills boolean 기본값: false

명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요
--profile string특정 auth 프로필을 사용해요

`d1 insights`

실험적 (Experimental)

D1 데이터베이스에서 실행된 쿼리에 대한 정보를 가져와요

이 명령은 원격(remote) D1 데이터베이스에 대해 동작해요.

npm:

npx wrangler d1 insights <NAME>

yarn:

yarn wrangler d1 insights <NAME>

pnpm:

pnpm wrangler d1 insights <NAME>

<NAME> string 필수

DB의 이름이에요
--time-period string 기본값: 1d

현재부터 제공된 기간까지의 데이터를 가져와요
--sort-type string 기본값: sum

insights를 정렬할 연산을 선택해요
--sort-by string 기본값: time

insights를 정렬할 필드를 선택해요
--sort-direction string 기본값: DESC

정렬 방향을 선택해요
--limit number 기본값: 5

처음 X개 쿼리에 대한 insights를 가져와요
--json boolean 기본값: false

출력을 JSON으로 반환해요

전역 플래그 (Global flags)

--v boolean 별칭: --version

버전 번호 표시
--cwd string현재 작업 디렉터리 대신 지정된 디렉터리에서 Wrangler가 시작된 것처럼 실행해요
--config string 별칭: --c

Wrangler 설정 파일 경로
--env string 별칭: --e

작업에 사용할 환경이며 .env와 .dev.vars 파일 선택에도 사용돼요
--env-file string불러올 .env 파일 경로 — 여러 번 지정할 수 있어요 — 앞선 파일의 값은 이후 파일의 값으로 덮어써져요
--install-skills boolean 기본값: false

명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요
--profile string특정 auth 프로필을 사용해요