Constructor de cadenas de conexión de libSQL
Construye una URL de base de datos Turso o libSQL con su token de autenticación para TypeScript, Python, Go y variables de entorno, o pega una para ver el host, si TLS está activado y cuándo expira el token. Todo se ejecuta en tu navegador: nada de lo que escribas se envía a ningún lugar.
Abrir esta conexión en SQLly
Abre el editor de conexiones de SQLly con los datos ya rellenados.
Abrir esta conexión en SQLly
Privado por diseño. El constructor y el decodificador son JavaScript puro que se ejecuta en esta pestaña. La página no envía ninguna solicitud con lo que escribes, no almacena nada (ni siquiera en tu navegador) y sigue funcionando sin conexión una vez cargada. El enlace Abrir en SQLly va directamente desde tu navegador a la aplicación en tu computadora.
Formatos de cadena de conexión de libSQL
Se accede a una base de datos Turso mediante un libsql://<database>-<organization>.turso.io URL más un token de autenticación (un JWT). libsql:// significa TLS; un sqld autoalojado en tu propia máquina suele escuchar en texto plano http://127.0.0.1:8080.
El decodificador lee la carga útil del token aquí mismo, en tu navegador, para mostrarte cuándo caduca y si es de solo lectura. No verifica la firma ni envía el token a ninguna parte.
URL de la base de datos Turso CLI, todos los SDK de libSQL
libsql://mydb-myorg.turso.io
URL con token de autenticación Go database/sql, @libsql/client, SQLly
libsql://mydb-myorg.turso.io?authToken=your_auth_token
sqld local servidor libSQL autoalojado
http://127.0.0.1:8080
Los marcadores de posición como your_password son eso mismo: construye tu propia cadena con el formulario de arriba. Más sobre cómo conectar SQLly a libSQL: SQLly para libSQL.
Esquemas y opciones de URL de libSQL
Del código fuente de @libsql/client y la referencia del SDK de Turso.
| Palabra clave | Sinónimos | Predeterminado | Lo que hace |
|---|---|---|---|
libsql:// |
- | - | TLS; el cliente elige HTTPS o WebSockets seguros. |
https:// / wss:// |
- | - | TLS sobre un transporte específico. |
http:// / ws:// |
- | - | Texto sin formato, para un sqld local. |
file: |
- | - | Un archivo local de libSQL/SQLite (embebido). |
authToken |
- | - | Parámetro de consulta que lleva el token de autenticación; o pasa authToken / auth_token en las opciones del cliente. |
tls |
- | 1 | ?tls=0 desactiva TLS para libsql://; necesita un puerto explícito. |
TURSO_DATABASE_URL / TURSO_AUTH_TOKEN |
- | - | Nombres de variables de entorno que usan las guías de inicio rápido de Turso. |
Errores comunes de conexión a libSQL
401 Unauthorized
Por qué: Falta el token de autenticación, ha caducado, está revocado o pertenece a otra base de datos u organización.
Solución: Crea un token nuevo con turso db tokens create <database> y pégalo en el decodificador para comprobar su caducidad.
Connection refused on 127.0.0.1:8080
Por qué: No se está ejecutando ningún sqld local, o escucha en otro puerto.
Solución: Inicia sqld (por ejemplo turso dev para un servidor de desarrollo local) y usa la URL que imprime.
Preguntas frecuentes sobre la cadena de conexión de libSQL
¿Qué es una URL de base de datos Turso?
libsql://<database>-<organization>.turso.io, mostrado por turso db show <database>. Combínala con un token de autenticación de turso db tokens create <database>.
¿Es seguro poner el token de autenticación en la URL?
Funciona (?authToken=), pero entonces la URL se convierte en un secreto que acaba en los registros y en el historial del shell. Es mejor pasar el token aparte, por ejemplo en la TURSO_AUTH_TOKEN variable de entorno.
¿Esta herramienta verifica mi token?
Decodifica la carga útil del token en tu navegador para mostrar la fecha de caducidad y si es de solo lectura. No verifica la firma y nunca envía el token a ningún lugar.
Otros motores
- Cadenas de conexión de SQL Server
- Cadenas de conexión de PostgreSQL
- Cadenas de conexión de MySQL
- Cadenas de conexión de MariaDB
- Cadenas de conexión de SQLite
- Cadenas de conexión de Oracle
- Cadenas de conexión de Redis
- Cadenas de conexión de ClickHouse
- Cadenas de conexión de DuckDB
- Todos los motores y formatos
- Formateador SQL
- Todas las herramientas gratuitas
Conéctate una vez. Luego solo escribe SQL.
SQLly es un entorno de trabajo SQL nativo para macOS, Windows y Linux. Pega una cadena de conexión en su editor de conexiones, guarda las contraseñas en el llavero del sistema y obtén IntelliSense que entiende el esquema en libSQL, entre otros.