// herramienta gratuita

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.

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 claveSinónimosPredeterminadoLo 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.

// olvídate de las cadenas por completo

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.