Turso 및 libSQL 클라이언트
URL과 토큰으로 Turso 데이터베이스에 연결하거나 libSQL 파일을 열고, SQLite 문법으로 조회하세요.
한눈에 보기
- 쿼리 언어
- SQL
- 드라이버
- 처음 사용할 때 다운로드공유 대상: libSQL
- 연결 방식
- 서비스 API
Turso에 연결
연결 모드 (Connection Mode)에서 원격(Turso) (Remote (Turso))를 선택한 뒤 데이터베이스의 HTTPS URL과 API 토큰 (API Token)을 붙여 넣으세요. 토큰은 macOS Keychain에 저장됩니다. 둘 다 Turso 대시보드나 CLI에서 얻을 수 있습니다.
가져온 libsql:// URL은 HTTPS 원격 연결이 되며, 각 URL은 하나의 데이터베이스를 지정합니다. 일반 HTTP URL은 암호화되지 않으며, SSH 터널은 사용할 수 없습니다.
쿼리 및 편집
libSQL은 SQLite 문법을 사용하므로 탐색, EXPLAIN QUERY PLAN 다이어그램, 내보내기가 SQLite와 동일하게 작동합니다.
원격 연결은 트랜잭션을 실행하지 않습니다. 각 명령문이 별도 HTTP 요청으로 각각 커밋되며, BEGIN은 “Transactions are not supported in this mode” 오류로 실패합니다. 트랜잭션에는 libSQL로 연 로컬 파일이 필요합니다. Turso 데이터베이스는 서버에 포함된 확장을 실행하므로 원격 모드는 SQLite 확장을 로드하지 않으며, 요청이 제한되면 오류에 대기할 초 수가 표시됩니다.
테이블, 인덱스 및 트리거
Structure 탭은 테이블을 만들고, 열과 인덱스를 추가하고 삭제하며, 트리거를 만들고 편집하고 삭제합니다. 사이드바에서 테이블 이름은 바꿀 수 있지만 뷰는 바꿀 수 없습니다.
원격 연결에서 열 순서나 외래 키를 바꾸면 검토하고 실행할 재구축 스크립트가 만들어집니다. TablePro는 별도의 HTTP 요청들을 하나의 트랜잭션으로 묶을 수 없기 때문입니다.
이 페이지는 Turso에만 해당하는 내용을 다룹니다. Safe Mode, AI 도우미, MCP 서버 등 TablePro의 나머지 기능은 기능 페이지에서 볼 수 있습니다.
libSQL
Hrana v2 pipeline 엔드포인트로 접근하는 자체 호스팅 sqld 서버나, 로컬 파일 (Local File) 모드로 여는 이 Mac의 파일에는 libSQL을 선택하세요. 로컬 파일은 트랜잭션을 실행하고, SQLite 확장을 로드하며, 확인한 재구축 스크립트를 실행합니다. Backup Dump와 Restore Dump는 로컬 파일에 sqlite3를 실행합니다.
실행 중인 앱이 Turso 내장 복제본으로 동기화하는 파일은 절대 열지 마세요. 두 프로그램이 동시에 접근하면 파일이 손상될 수 있습니다.
- 제한 사항
- Backup Dump는 로컬 libSQL 파일에만 작동하며 원격 데이터베이스에는 작동하지 않습니다.
그 밖에
데이터 이동
테이블이나 쿼리 결과를 CSV, JSON, SQL, XLSX, Markdown, HTML 및 XML로 내보내세요. 데이터를 넣으려면 Turso CLI나 sqld 서버의 가져오기를 사용하세요.
제한 사항
- 연결 하나는 데이터베이스 하나입니다. 데이터베이스 전환과 브랜치는 지원하지 않습니다.
- 임베디드 복제본은 지원하지 않습니다. 로컬 파일은 독립적으로 열리고 동기화되지 않습니다.
Remote와 Local File 중 무엇을 선택하나요?
URL로 접근하는 Turso 데이터베이스나 sqld 서버는 Remote를 선택하세요. 이 Mac의 libSQL 파일은 Local File을 선택하며, 트랜잭션, SQLite 확장, 백업도 사용할 수 있습니다.
Turso CLI를 설치해야 하나요?
아니요. Turso 대시보드에서도 데이터베이스 URL을 확인하고 토큰을 만들 수 있습니다. CLI는 터미널에서 데이터를 넣을 때 유용합니다.