libSQL 연결 문자열 생성기
TypeScript, Python, Go 및 환경 변수를 위해 Turso 또는 libSQL 데이터베이스 URL을 인증 토큰과 함께 생성하거나, 하나를 붙여넣어 호스트, TLS 사용 여부, 토큰 만료 시간을 확인할 수 있습니다. 모든 처리는 브라우저에서 이뤄집니다: 입력한 내용은 어디로도 전송되지 않습니다.
이 연결을 SQLly에서 열기
설계 단계부터 프라이버시를 지킵니다. 빌더와 디코더는 이 탭에서 돌아가는 순수 JavaScript입니다. 입력한 내용으로 요청을 하나도 보내지 않고, 아무것도 저장하지 않으며(브라우저에도 저장하지 않음), 한 번 로드되면 오프라인에서도 계속 작동합니다. SQLly에서 열기 링크는 브라우저에서 컴퓨터의 앱으로 바로 이어집니다.
libSQL 연결 문자열 형식
Turso 데이터베이스의 주소는 libsql://<database>-<organization>.turso.io URL과 인증 토큰(JWT)입니다. libsql:// 는 TLS를 의미합니다; 자체 호스팅한 sqld는 보통 평문으로 수신합니다 http://127.0.0.1:8080.
디코더는 만료 시점과 읽기 전용 여부를 표시하기 위해 브라우저에서 바로 토큰의 페이로드를 읽습니다. 서명을 검증하지 않으며, 토큰을 어디로도 보내지 않습니다.
데이터베이스 URL Turso CLI, 모든 libSQL SDK
libsql://mydb-myorg.turso.io
인증 토큰이 포함된 URL Go database/sql, @libsql/client, SQLly
libsql://mydb-myorg.turso.io?authToken=your_auth_token
로컬 sqld 셀프호스팅 libSQL 서버
http://127.0.0.1:8080
다음과 같은 플레이스홀더 your_password 말 그대로 그 이상도 이하도 아닙니다. 위 양식으로 연결 문자열을 직접 만드세요. SQLly를 libSQL에 연결하는 방법 더 알아보기: libSQL용 SQLly.
libSQL URL 스킴 및 옵션
@libsql/client 소스와 Turso의 SDK 참고 자료에서.
| 키워드 | 동의어 | 기본값 | 기능 |
|---|---|---|---|
libsql:// |
- | - | TLS; 클라이언트가 HTTPS 또는 보안 WebSockets를 선택합니다. |
https:// / wss:// |
- | - | 특정 전송 위의 TLS. |
http:// / ws:// |
- | - | 로컬 sqld용 일반 텍스트. |
file: |
- | - | 로컬 libSQL/SQLite 파일(내장형). |
authToken |
- | - | 인증 토큰을 담는 쿼리 매개변수이거나, 전달할 헤더는 authToken / auth_token 클라이언트 옵션에서. |
tls |
- | 1 | ?tls=0 의 TLS를 끕니다 libsql://; 명시적인 포트가 필요합니다. |
TURSO_DATABASE_URL / TURSO_AUTH_TOKEN |
- | - | Turso의 퀵스타트에서 사용하는 환경 변수 이름. |
일반적인 libSQL 연결 오류
401 Unauthorized
이유: 인증 토큰이 없거나, 만료되었거나, 취소되었거나, 다른 데이터베이스 또는 조직에 속해 있습니다.
해결: 다음 명령으로 새 토큰을 생성합니다 turso db tokens create <database> 그리고 이를 디코더에 붙여 넣어 만료 시각을 확인하세요.
Connection refused on 127.0.0.1:8080
이유: 로컬 sqld가 실행되고 있지 않거나, 다른 포트에서 대기 중입니다.
해결: sqld를 시작하세요(예를 들어 turso dev 로컬 개발 서버용) 출력되는 URL을 쓰면 됩니다.
libSQL 연결 문자열 FAQ
Turso 데이터베이스 URL이란 무엇인가요?
libsql://<database>-<organization>.turso.io, 다음에 의해 표시됩니다 turso db show <database>. 다음에서 발급받은 인증 토큰과 함께 사용하세요 turso db tokens create <database>.
인증 토큰을 URL에 넣는 것이 안전한가요?
작동하긴 합니다 (?authToken=), 하지만 그 URL은 로그와 셸 기록에 남는 비밀이 됩니다. 토큰은 별도로 전달하는 편이 좋습니다. 예를 들어 TURSO_AUTH_TOKEN 환경 변수.
이 도구가 내 토큰을 확인하나요?
이 도구는 브라우저에서 토큰의 페이로드를 디코딩하여 만료 날짜와 읽기 전용 여부를 보여줍니다. 서명은 확인하지 않으며, 토큰을 어디에도 전송하지 않습니다.
한 번 연결하세요. 그 뒤는 그냥 SQL만 쓰면 됩니다.
SQLly는 macOS, Windows, Linux용 네이티브 SQL 워크벤치입니다. 연결 편집기에 연결 문자열을 붙여넣고, 비밀번호는 시스템 키체인에 보관하고, libSQL 등에서 스키마 인식 IntelliSense를 사용할 수 있습니다.