Client Turso et libSQL
Connectez-vous à une base Turso avec son URL et son token, ou ouvrez un fichier libSQL, et interrogez-la avec la syntaxe de SQLite.
En bref
- Langage de requête
- SQL
- Pilote
- Téléchargé à la première utilisationPartagé avec libSQL
- Connexion via
- L’API du service
Connectez-vous à Turso
Choisissez Distant (Turso) (Remote (Turso)) dans Mode de connexion (Connection Mode), puis collez l’URL HTTPS de la base et un Jeton API (API Token), stocké dans le trousseau macOS. Vous les trouverez tous deux dans le tableau de bord ou la CLI Turso.
Une URL libsql:// importée devient une connexion distante HTTPS, et chaque URL désigne une seule base. Les URL HTTP simples ne sont pas chiffrées, et les tunnels SSH ne sont pas disponibles.
Interrogez et modifiez
libSQL parle la syntaxe de SQLite ; navigation, diagrammes EXPLAIN QUERY PLAN et export fonctionnent donc comme sur SQLite.
Une connexion distante n’exécute pas de transaction : chaque instruction est sa propre requête HTTP et est validée séparément, et BEGIN échoue avec « Les transactions ne sont pas prises en charge dans ce mode ». Les transactions nécessitent un fichier local, ouvert comme libSQL. Le mode distant ne charge pas d’extensions SQLite, car une base Turso exécute celles compilées dans son serveur, et l’erreur d’une requête limitée indique combien de secondes attendre.
Tables, index et déclencheurs
L’onglet Structure crée des tables, ajoute et supprime colonnes et index, crée, modifie et supprime des déclencheurs. Les tables, pas les vues, se renomment dans la barre latérale.
Réordonner les colonnes ou changer une clé étrangère sur une base distante produit un script de reconstruction que vous vérifiez et exécutez, car TablePro ne peut pas regrouper des requêtes HTTP distinctes dans une seule transaction.
Cette page présente ce qui est propre à Turso. Safe Mode, l’assistant IA, le serveur MCP et le reste de TablePro sont décrits dans les pages des fonctionnalités.
libSQL
Choisissez libSQL pour un serveur sqld auto-hébergé, atteint via son endpoint Hrana v2 pipeline, ou pour un fichier sur ce Mac en mode Fichier local (Local File). Un fichier local exécute les transactions, charge les extensions SQLite et exécute les scripts de reconstruction après votre confirmation, et Backup Dump et Restore Dump y exécutent sqlite3.
N’ouvrez jamais un fichier qu’une app en cours d’exécution synchronise comme réplique embarquée Turso : un accès simultané par deux programmes peut le corrompre.
- Limites
- Backup Dump fonctionne uniquement pour un fichier libSQL local, pas une base distante.
Et aussi
Déplacer les données
Exportez une table ou un résultat de requête en CSV, JSON, SQL, XLSX, Markdown, HTML et XML. Pour charger des données, utilisez la CLI Turso ou un import sur votre serveur sqld.
Limites
- Chaque connexion correspond à une base. Le changement de base et les branches ne sont pas pris en charge.
- Les réplicas embarqués ne sont pas pris en charge : un fichier local s’ouvre seul et ne se synchronise pas.
Dois-je choisir Distant ou Fichier local ?
Distant pour Turso ou sqld par URL. Fichier local pour libSQL sur ce Mac, avec transactions, extensions SQLite et sauvegardes.
Dois-je installer Turso CLI ?
Non. Le tableau de bord Turso affiche aussi l’URL de la base et crée les jetons. La CLI sert à charger des données depuis le terminal.
Obtenez TablePro
Tout ce qui figure sur cette page est gratuit.