Cloudflare D1 클라이언트
Cloudflare 계정의 D1 데이터베이스를 탐색하고 Cloudflare API로 SQLite 쿼리를 실행하세요.
한눈에 보기
- 쿼리 언어
- SQL
- 드라이버
- 처음 사용할 때 다운로드
- 연결 방식
- 서비스 API
API 토큰으로 연결
D1 데이터베이스 이름 또는 UUID, Cloudflare 계정 ID, API 토큰 (API Token)을 입력하세요. 토큰은 macOS Keychain에 보관됩니다. 요청은 HTTPS를 사용하므로 호스트, 포트, TLS 설정, SSH 터널이 없습니다.
Account > D1 > Edit 권한으로 토큰을 만들고 표시될 때 복사하세요. 이 토큰은 선택한 데이터베이스뿐 아니라 계정의 모든 D1 데이터베이스에 접근할 수 있습니다. d1://account-id/database-name URL을 가져오면 계정과 데이터베이스가 채워집니다. 토큰은 URL에 포함되지 않으므로 나중에 붙여 넣으세요.
데이터베이스 전환 및 쿼리
재연결 없이 계정의 D1 데이터베이스 사이를 전환하세요. 전환 메뉴에서 데이터베이스를 만들거나 삭제할 수도 있으며, 열린 탭은 시작한 데이터베이스를 유지합니다. 쿼리는 SQLite 문법을 사용하며, EXPLAIN QUERY PLAN은 다이어그램으로 그려집니다.
각 명령문은 독립적으로 동작하도록 작성하세요. 한 명령문의 PRAGMA 설정이나 임시 테이블은 다음 명령문에서 사라지며, 모든 명령문은 실행 시 커밋되어 롤백할 수 없습니다. Cloudflare가 요청 속도를 제한하면 오류에 재시도 전 대기 시간이 표시됩니다.
테이블, 인덱스 및 트리거
Structure 탭은 테이블을 만들고 삭제하며, 열을 추가하고 삭제하고, WHERE 조건이 있는 부분 인덱스를 포함해 인덱스를 만들고 삭제합니다. Triggers 탭은 트리거를 만들고 편집하고 삭제하며, 테이블 이름은 사이드바에서 바꿀 수 있습니다.
열 순서나 외래 키를 바꾸려면 테이블을 재구성해야 합니다. 명령문마다 별도 요청이라 재구성을 하나의 트랜잭션으로 묶을 수 없으므로, TablePro가 재구성 스크립트를 작성하고 실행은 사용자에게 맡깁니다.
이 페이지는 Cloudflare D1에만 해당하는 내용을 다룹니다. Safe Mode, AI 도우미, MCP 서버 등 TablePro의 나머지 기능은 기능 페이지에서 볼 수 있습니다.
그 밖에
데이터 이동
D1 테이블이나 쿼리 결과를 CSV, JSON, SQL, XLSX, Markdown, HTML 및 XML로 내보내세요. SQL 파일을 넣으려면
wrangler d1 execute를--file옵션과 함께 실행한 뒤 여기서 결과를 탐색하세요.제한 사항
- 각 명령문은 별도의 HTTP 요청이며 세션 상태가 이어지지 않고 트랜잭션도 지원하지 않습니다.
D1 Sessions API를 사용하나요?
아니요. 각 명령문은 세션이나 북마크 없는 별도 요청으로 전송되므로, 같은 탭이든 다른 탭이든 명령문 사이에 아무것도 이어지지 않습니다.
Wrangler를 설치해야 하나요?
탐색, 쿼리, 편집에는 필요 없습니다. TablePro가 Cloudflare API와 직접 통신합니다. Wrangler는 SQL 파일을 넣을 때만 필요합니다.