Client Turso et libSQL pour Mac
Connectez Turso par URL et jeton, interrogez en syntaxe SQLite et changez tables, index et déclencheurs. Le même pilote ouvre vos serveurs sqld et fichiers libSQL sur Mac.
Fonctionne sur MacLe pilote se télécharge la première fois que vous choisissez Turso
En bref
- Langage de requête
- SQL
- Pilote
- Téléchargé à la première utilisationPartagé avec libSQL
- Connexion via
- L’API du service
- iPhone et iPad
- Ne s’ouvre pas
Connectez-vous à Turso
Choisissez Turso comme type et laissez Mode de connexion sur Distant (Turso). Collez l’URL HTTPS de la base terminant par .turso.io et un jeton dans Jeton API, conservé dans le Trousseau macOS. Le tableau Turso montre les deux, ainsi que turso db show my-db --url et turso db tokens create my-db.
Une URL libsql:// est réécrite en HTTPS et son import crée une connexion distante. Il n’y a ni hôte, port ni base à saisir, car l’URL nomme une base. La connexion est chiffrée si elle utilise HTTPS plutôt que HTTP clair ; il n’y a pas de tunnel SSH.
Interrogez et modifiez
libSQL parle SQLite ; navigation, diagrammes EXPLAIN QUERY PLAN, modifications en attente avec Aperçu SQL et export fonctionnent comme sur SQLite.
Une connexion distante n’exécute pas de transactions. Chaque instruction est une requête HTTP validée séparément et BEGIN échoue avec « Les transactions ne sont pas prises en charge dans ce mode ». Utilisez un fichier libSQL local, décrit dans la section libSQL, pour les transactions.
Le mode distant ne charge pas d’extensions SQLite : Turso exécute celles compilées dans son serveur. S’il limite une connexion, l’erreur indique combien de secondes attendre avant de réessayer.
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.
Pour réordonner des colonnes ou changer une clé étrangère distante, TablePro écrit le script de reconstruction à lire et exécuter vous-même. Il ne peut le lancer, car la reconstruction nécessite une transaction entre requêtes HTTP distinctes.
Transférez des données
TablePro n’importe pas vers Turso ou libSQL ; chargez les données par Turso CLI ou l’import de votre serveur sqld. Pour les extraire, exportez tables ou résultats en CSV, JSON, SQL, XLSX, Markdown, HTML et XML.
iPhone et iPad
L’app iPhone et iPad n’a pas de pilote Turso. Les connexions Turso synchronisées depuis un Mac apparaissent dans sa liste, mais ne s’ouvrent pas.
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.
libSQL
Téléchargé à la première utilisationiPhone et iPad: Ne s’ouvre pas
Choisissez libSQL pour votre serveur sqld ou un fichier local. En Distant, il atteint tout sqld offrant Hrana v2 pipeline, même local avec port 8080 par défaut. Laissez le jeton vide sans --auth-jwt-key-file, ou fournissez un JWT correspondant à la clé serveur.
Fichier local ouvre libSQL avec le moteur SQLite du pilote ; un chemin inexistant est créé, dossiers compris. Le fichier local exécute les transactions, charge les extensions de la liste Extensions et reconstruit pour réordonner les colonnes ou clés étrangères après confirmation.
Les instructions propres à libSQL comme ALTER TABLE … ALTER COLUMN échouent localement, car SQLite les reçoit. Les fichiers libSQL chiffrés ne s’ouvrent pas. N’ouvrez jamais un fichier qu’une app synchronise comme réplique embarquée Turso : deux programmes simultanés peuvent le corrompre.
Dump de sauvegarde et Restaurer un dump exécutent sqlite3 sur un fichier libSQL local.
Limites de libSQL
- Sauvegarder un dump fonctionne uniquement pour un fichier libSQL local, pas une base distante.
Questions sur Turso
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 Turso montre l’URL et crée les jetons. La CLI sert à charger depuis le terminal, car TablePro n’importe pas vers Turso.
Obtenir TablePro
Nécessite macOS 13 Ventura ou version ultérieure