Mac용 Turso·libSQL 클라이언트

연결 유형에서 Turso를 선택하고 Connection Mode를 Remote (Turso)로 유지합니다. .turso.io로 끝나는 HTTPS URL을 붙여넣고 API Token에 토큰을 넣으면 macOS 키체인에 보관됩니다. Turso 대시보드나 turso db show my-db --url, turso db tokens create my-db로 둘 다 얻을 수 있습니다.

libsql:// URL은 HTTPS로 변환되며 가져오면 원격 연결을 만듭니다. URL이 하나의 데이터베이스를 지정하므로 호스트, 포트나 데이터베이스 필드는 없습니다. 평문 HTTP 대신 HTTPS URL을 쓰면 암호화되며 SSH 터널은 없습니다.

libSQL은 SQLite 문법을 사용하므로 탐색, EXPLAIN QUERY PLAN 다이어그램, Preview SQL을 통한 편집 임시 저장과 내보내기가 SQLite와 동일하게 작동합니다.

원격 연결은 트랜잭션을 실행하지 않습니다. 각 구문이 별도 HTTP 요청으로 커밋되며 BEGIN은 “Transactions are not supported in this mode” 오류로 실패합니다. 트랜잭션은 libSQL 절의 로컬 libSQL 파일이 필요합니다.

원격 모드는 SQLite 확장을 로드하지 않으며 Turso 데이터베이스는 서버에 포함된 확장을 실행합니다. Turso가 연결을 제한하면 오류에 재시도 전 대기 초가 표시됩니다.

Structure 탭은 테이블 생성, 열·인덱스 추가·삭제와 트리거 생성·편집·삭제를 지원합니다. 사이드바에서 테이블 이름은 바꿀 수 있지만 뷰는 바꿀 수 없습니다.

원격 데이터베이스의 열 순서나 외래 키를 변경하면 TablePro가 재구성 스크립트를 작성해 직접 검토하고 실행하게 합니다. 별도 HTTP 요청에 걸친 하나의 트랜잭션이 필요하므로 앱이 대신 실행할 수 없습니다.

TablePro는 Turso·libSQL 가져오기를 제공하지 않습니다. Turso CLI나 sqld 서버에서 가져오세요. 데이터를 꺼내려면 테이블이나 쿼리 결과를 CSV, JSON, SQL, XLSX, Markdown, HTML 및 XML로 내보냅니다.

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

처음 사용할 때 다운로드iPhone과 iPad: 열리지 않음

자체 sqld 서버나 이 Mac의 파일은 libSQL을 선택합니다. Remote 모드는 Hrana v2 pipeline 엔드포인트를 제공하는 모든 sqld에 연결하며 이 Mac의 기본 포트 8080 서버도 지원합니다. --auth-jwt-key-file 없이 시작한 서버는 토큰을 비우고 그 외에는 서버 키와 맞는 JWT를 입력합니다.

Local File 모드는 드라이버에 포함된 SQLite로 libSQL 파일을 열고 아직 없는 경로는 폴더까지 만듭니다. 로컬 파일은 트랜잭션, 연결의 Extensions 목록에서 SQLite 확장 로드와 확인 후 열 순서·외래 키 재구성을 지원합니다.

ALTER TABLE … ALTER COLUMN처럼 libSQL만 이해하는 구문은 SQLite 엔진이 받기 때문에 로컬 파일에서 실패합니다. 암호화된 libSQL 파일은 열리지 않습니다. 실행 중인 앱이 Turso 내장 복제본으로 동기화하는 파일은 두 프로그램의 동시 접근으로 손상될 수 있으므로 절대로 열지 마세요.

Backup Dump와 Restore Dump는 로컬 libSQL 파일에 sqlite3을 실행합니다.

libSQL 설정 가이드 (영어)↗