Client für Turso und libSQL auf Mac
Verbinde Turso mit URL und Token, frage in SQLite-Syntax ab und ändere Tabellen, Indizes und Trigger. Derselbe Treiber öffnet eigene sqld-Server und libSQL-Dateien auf deinem Mac.
Funktioniert auf MacDer Treiber wird heruntergeladen, wenn du Turso erstmals auswählst
Auf einen Blick
- Abfragesprache
- SQL
- Treiber
- Download bei der ersten NutzungGemeinsam genutzt mit libSQL
- Verbinden über
- Die API des Dienstes
- iPhone und iPad
- Lässt sich nicht öffnen
Mit Turso verbinden
Wähle Turso als Verbindungstyp und lasse Verbindungsmodus auf Remote (Turso). Füge die HTTPS-Datenbank-URL mit Endung .turso.io und einen Token unter API-Token ein, der im macOS-Schlüsselbund bleibt. Turso zeigt beides im Dashboard, ebenso turso db show my-db --url und turso db tokens create my-db.
Eine libsql://-URL wird auf HTTPS umgeschrieben; ihr Import erstellt eine Remote-Verbindung. Host-, Port- und Datenbankfelder fehlen, weil die URL eine Datenbank nennt. Verschlüsselt ist die Verbindung bei HTTPS statt Klartext-HTTP; es gibt keinen SSH-Tunnel.
Abfragen und bearbeiten
libSQL spricht SQLite-Syntax; Durchsuchen, EXPLAIN QUERY PLAN-Diagramme, vorgemerkte Änderungen mit SQL-Vorschau und Export funktionieren wie bei SQLite.
Eine Remote-Verbindung führt keine Transaktionen aus. Jede Anweisung ist eine eigene HTTP-Anfrage mit eigenem Commit; BEGIN meldet „Transaktionen werden in diesem Modus nicht unterstützt“. Transaktionen brauchen eine lokale libSQL-Datei, beschrieben im libSQL-Abschnitt.
Remote-Modus lädt keine SQLite-Erweiterungen: Turso führt die mit seinem Server gebauten aus. Drosselt Turso eine Verbindung, nennt der Fehler die Wartezeit in Sekunden vor dem Wiederholen.
Tabellen, Indizes und Trigger
Der Struktur-Tab erstellt Tabellen, fügt Spalten und Indizes hinzu und entfernt sie und erstellt, bearbeitet und löscht Trigger. Tabellen, nicht Sichten, lassen sich in der Seitenleiste umbenennen.
Zum Umordnen von Spalten oder Ändern eines Fremdschlüssels in einer Remote-Datenbank schreibt TablePro das Neuaufbauskript zum Lesen und eigenen Ausführen. Es kann es nicht selbst ausführen, weil eine Transaktion über getrennte HTTP-Anfragen nötig wäre.
Daten übertragen
TablePro bietet keinen Import für Turso oder libSQL; lade Daten mit der Turso-CLI oder einem Import deines sqld-Servers. Exportiere Tabellen oder Ergebnisse als CSV, JSON, SQL, XLSX, Markdown, HTML und XML.
iPhone und iPad
Die App für iPhone und iPad hat keinen Turso-Treiber. Vom Mac synchronisierte Turso-Verbindungen erscheinen in ihrer Liste, lassen sich aber nicht öffnen.
Grenzen
- Jede Verbindung entspricht einer Datenbank. Datenbankwechsel und Branches werden nicht unterstützt.
- Eingebettete Replikate werden nicht unterstützt: Eine lokale Datei öffnet sich eigenständig und synchronisiert nicht.
libSQL
Download bei der ersten NutzungiPhone und iPad: Lässt sich nicht öffnen
Wähle libSQL für eigene sqld-Server oder eine Datei auf diesem Mac. Remote erreicht jeden sqld mit Hrana-v2-Pipeline-Endpunkt, auch einen lokalen mit Standardport 8080. Lasse den Token bei einem Server ohne --auth-jwt-key-file leer oder gib einen JWT passend zu seinem Schlüssel an.
Lokale Datei öffnet libSQL mit der SQLite-Engine des Treibers; ein fehlender Pfad wird samt Ordnern erstellt. Lokale Dateien führen Transaktionen aus, laden SQLite-Erweiterungen aus der Erweiterungsliste und führen Spaltenumordnung oder Fremdschlüsselneuaufbau nach Bestätigung aus.
Nur libSQL bekannte Anweisungen wie ALTER TABLE … ALTER COLUMN scheitern lokal, weil SQLite sie erhält. Verschlüsselte libSQL-Dateien öffnen nicht. Öffne nie eine Datei, die eine laufende App als eingebettete Turso-Replik synchronisiert: Gleichzeitiger Zugriff zweier Programme kann sie beschädigen.
Backup-Dump und Dump wiederherstellen führen sqlite3 auf einer lokalen libSQL-Datei aus.
Grenzen von libSQL
- Backup-Dump funktioniert nur für eine lokale libSQL-Datei, nicht für eine Remote-Datenbank.
Fragen zu Turso
Soll ich Remote oder Lokale Datei wählen?
Remote für Turso oder sqld per URL. Lokale Datei für libSQL auf diesem Mac, mit Transaktionen, SQLite-Erweiterungen und Backups.
Muss die Turso-CLI installiert sein?
Nein. Das Turso-Dashboard zeigt die URL und erstellt Tokens. Die CLI hilft beim Laden von Daten im Terminal, da TablePro keinen Turso-Import bietet.
TablePro herunterladen
Erfordert macOS 13 Ventura oder neuer