Mac용 Cloudflare D1 클라이언트

D1 연결은 데이터베이스 이름이나 UUID, Cloudflare 계정 ID와 API 토큰 세 값이 필요합니다. 토큰은 API Token 필드에 넣고 macOS 키체인에 보관합니다. 모든 요청이 HTTPS로 Cloudflare API에 전달되므로 호스트, 포트, SSL 설정이나 SSH 터널은 없습니다.

Custom token 템플릿에서 Account > D1 > Edit 권한으로 토큰을 만들고 한 번만 표시되므로 그때 복사하세요. 이 토큰은 연결한 하나뿐 아니라 계정의 모든 D1 데이터베이스에 접근합니다.

d1://account-id/database-name URL을 가져오면 계정과 데이터베이스가 채워집니다. 토큰은 URL에 포함되지 않으므로 나중에 붙여넣으세요.

도구 막대의 전환기는 계정의 D1 데이터베이스를 나열하고 재연결 없이 전환하며 생성·삭제도 합니다. 각 탭은 열었던 데이터베이스에 남습니다.

쿼리는 SQLite 문법을 사용합니다. EXPLAIN QUERY PLAN은 다이어그램으로 표시되고 행 편집은 저장까지 그리드에서 대기하며 Preview SQL이 구문을 먼저 보여 줍니다.

각 구문은 독립적으로 작성하세요. 한 구문의 PRAGMA 설정이나 임시 테이블은 다음 구문에서 사라지고 모든 구문이 실행 시 커밋되어 롤백할 수 없습니다. Cloudflare가 요청 속도를 제한하면 오류에 재시도 전 대기 시간이 표시됩니다.

Structure 탭은 테이블 생성·삭제, 열 추가·삭제와 인덱스 생성·삭제를 지원하며 WHERE 조건의 부분 인덱스도 포함합니다. Preview SQL은 저장 전에 DDL을 보여 줍니다. Triggers 탭은 트리거를 생성·편집·삭제하며 테이블 이름은 사이드바에서 바꿉니다.

열 순서나 외래 키 변경은 테이블 재구성이 필요합니다. D1에서는 구문마다 별도 요청이어서 재구성을 하나의 트랜잭션으로 묶을 수 없으므로 TablePro가 스크립트를 작성하고 실행은 사용자에게 맡깁니다.

TablePro는 D1 가져오기를 제공하지 않습니다. wrangler d1 execute의 --file 옵션으로 SQL 파일을 넣고 여기서 결과를 탐색하세요. 내보내기는 D1 테이블이나 쿼리 결과를 CSV, JSON, SQL, XLSX, Markdown, HTML 및 XML로 기록합니다.

iPhone과 iPad 앱에는 Cloudflare D1 드라이버가 없습니다. Mac에서 동기화한 Cloudflare D1 연결은 목록에 표시되지만 열리지 않습니다.