// outil gratuit

Générateur de chaînes de connexion libSQL

Construisez une URL de base de données Turso ou libSQL avec son jeton d'authentification pour TypeScript, Python, Go et les variables d'environnement, ou collez-en une pour voir l'hôte, si TLS est activé et quand le jeton expire. Tout fonctionne dans votre navigateur : rien de ce que vous tapez n'est envoyé quelque part.

Ouvrir cette connexion dans SQLly

Ouvre l'éditeur de connexion de SQLly, prérempli.

Privé par conception. Le constructeur et le décodeur sont du JavaScript pur fonctionnant dans cet onglet. La page n'envoie aucune requête avec ce que vous tapez, ne stocke rien (pas même dans votre navigateur) et continue de fonctionner hors ligne une fois chargée. Le lien Ouvrir dans SQLly va directement de votre navigateur à l'application sur votre ordinateur.

Formats de chaînes de connexion libSQL

Une base de données Turso est adressée par un libsql://<database>-<organization>.turso.io URL plus un jeton d’authentification (un JWT). libsql:// signifie TLS ; un sqld auto-hébergé sur votre propre machine écoute généralement en clair http://127.0.0.1:8080.

Le décodeur lit la charge utile du jeton directement dans votre navigateur pour afficher sa date d'expiration et déterminer s'il est en lecture seule. Il ne vérifie pas la signature et n'envoie le jeton nulle part.

URL de la base de données Turso CLI, chaque SDK libSQL

libsql://mydb-myorg.turso.io

URL avec jeton d’authentification Go database/sql, @libsql/client, SQLly

libsql://mydb-myorg.turso.io?authToken=your_auth_token

sqld local serveur libSQL auto-hébergé

http://127.0.0.1:8080

Espaces réservés tels que your_password sont exactement cela : construisez votre propre chaîne avec le formulaire ci-dessus. Pour en savoir plus sur la connexion de SQLly à libSQL : SQLly pour libSQL.

Schémas et options d'URL libSQL

Depuis la source de @libsql/client et la référence SDK de Turso.

Mot-cléSynonymesPar défautCe que cela fait
libsql:// - - TLS ; le client choisit HTTPS ou WebSockets sécurisés.
https:// / wss:// - - TLS sur un transport spécifique.
http:// / ws:// - - Texte clair, pour un sqld local.
file: - - Un fichier libSQL/SQLite local (intégré).
authToken - - Paramètre de requête contenant le jeton d'authentification ; ou passez authToken / auth_token dans les options du client.
tls - 1 ?tls=0 désactive TLS pour libsql://; nécessite un port explicite.
TURSO_DATABASE_URL / TURSO_AUTH_TOKEN - - Noms des variables d'environnement utilisées par les guides de démarrage rapide de Turso.

Erreurs de connexion libSQL courantes

401 Unauthorized

Pourquoi : Le jeton d'authentification est manquant, expiré, révoqué, ou appartient à une autre base de données ou organisation.

Correction : Créer un nouveau jeton avec turso db tokens create <database> et collez-le dans le décodeur pour vérifier sa date d'expiration.

Connection refused on 127.0.0.1:8080

Pourquoi : Aucun sqld local n'est en cours d'exécution, ou il écoute sur un autre port.

Correction : Démarrez sqld (par exemple turso dev pour un serveur de développement local) et utilisez l'URL qu'il affiche.

FAQ sur la chaîne de connexion libSQL

Qu'est-ce qu'une URL de base de données Turso ?

libsql://<database>-<organization>.turso.io, affichée par turso db show <database>. Associez-la à un jeton d'authentification provenant de turso db tokens create <database>.

Est-il sûr de mettre le jeton d'authentification dans l'URL ?

Cela fonctionne (?authToken=), mais l'URL devient alors un secret qui se retrouve dans les journaux et l'historique du shell. Il est préférable de passer le jeton séparément, par exemple dans le TURSO_AUTH_TOKEN variable d'environnement.

Cet outil vérifie-t-il mon jeton ?

Il décode la charge utile du jeton dans votre navigateur pour afficher la date d'expiration et s'il est en lecture seule. Il ne vérifie pas la signature et n'envoie jamais le jeton nulle part.

// sans passer par les chaînes de connexion

Connectez-vous une fois. Ensuite, écrivez simplement du SQL.

SQLly est un atelier SQL natif pour macOS, Windows et Linux. Collez une chaîne de connexion dans son éditeur de connexion, gardez les mots de passe dans votre trousseau système et profitez d'un IntelliSense conscient du schéma sur libSQL et plus encore.