Cloudflare-D1-Client für Mac
Erreiche die D1-Datenbanken deines Cloudflare-Kontos über eine Verbindung, frage sie im SQLite-Dialekt über die Cloudflare-API ab und verwalte Tabellen, Indizes und Trigger im Struktur-Tab.
Funktioniert auf MacDer Treiber wird heruntergeladen, wenn du Cloudflare D1 erstmals auswählst
Auf einen Blick
- Abfragesprache
- SQL
- Treiber
- Download bei der ersten Nutzung
- Verbinden über
- Die API des Dienstes
- iPhone und iPad
- Lässt sich nicht öffnen
Mit einem API-Token verbinden
Eine D1-Verbindung braucht drei Werte: Name oder UUID der Datenbank, deine Cloudflare-Konto-ID und einen API-Token. Der Token kommt in das Feld API-Token und wird im macOS-Schlüsselbund gespeichert. Es gibt keinen Host, Port, keine SSL-Einstellung und keinen SSH-Tunnel, da jede Anfrage über HTTPS an die Cloudflare-API geht.
Erstelle den Token aus der Vorlage für benutzerdefinierte Tokens mit der Berechtigung Konto > D1 > Bearbeiten und kopiere ihn, sobald Cloudflare ihn zeigt, denn er wird nur einmal angezeigt. Der Token erreicht jede D1-Datenbank des Kontos, nicht nur die, mit der du dich verbindest.
Beim Import einer d1://account-id/database-name-URL werden Konto und Datenbank ausgefüllt; der Token reist nie in der URL mit, daher fügst du ihn anschließend ein.
Datenbanken wechseln und abfragen
Der Datenbankumschalter in der Symbolleiste listet die D1-Datenbanken des Kontos und wechselt ohne erneutes Verbinden zwischen ihnen. Er erstellt und löscht auch Datenbanken. Jeder Tab bleibt bei der Datenbank, mit der er geöffnet wurde.
Abfragen nutzen den SQLite-Dialekt. EXPLAIN QUERY PLAN wird als Diagramm gezeichnet; Zeilenänderungen warten im Raster bis zum Speichern, wobei SQL-Vorschau zuerst die Anweisungen zeigt.
Schreibe jede Anweisung unabhängig: Eine PRAGMA-Einstellung oder temporäre Tabelle aus einer Anweisung ist bei der nächsten wieder weg. Jede Anweisung wird bei der Ausführung bestätigt; es gibt nichts zurückzurollen. Wenn Cloudflare eine Anfrage wegen des Ratenlimits begrenzt, enthält der Fehler die von Cloudflare verlangte Wartezeit vor einem erneuten Versuch.
Tabellen, Indizes und Trigger
Der Struktur-Tab erstellt und löscht Tabellen, fügt Spalten hinzu und entfernt sie und erstellt und löscht Indizes, auch partielle mit WHERE-Bedingung. SQL-Vorschau zeigt das DDL vor dem Speichern. Der Trigger-Tab erstellt, bearbeitet und löscht Trigger; Tabellen lassen sich in der Seitenleiste umbenennen.
Das Umordnen von Spalten oder Ändern eines Fremdschlüssels erfordert einen Tabellenneuaufbau. Für D1 schreibt TablePro das Neuaufbauskript und übergibt es dir zur Ausführung, da jede Anweisung eine eigene Anfrage ist und keine Transaktion den gesamten Neuaufbau zusammenhalten kann.
Daten übertragen
TablePro bietet keinen Import für D1. Lade eine SQL-Datei mit wrangler d1 execute und der Option --file und durchsuche das Ergebnis hier. Exportieren schreibt eine D1-Tabelle oder ein Abfrageergebnis als CSV, JSON, SQL, XLSX, Markdown, HTML und XML.
iPhone und iPad
Die App für iPhone und iPad hat keinen Cloudflare D1-Treiber. Vom Mac synchronisierte Cloudflare D1-Verbindungen erscheinen in ihrer Liste, lassen sich aber nicht öffnen.
Grenzen
- Jede Anweisung ist eine eigene HTTP-Anfrage: Sitzungszustand bleibt nicht erhalten, und Transaktionen werden nicht unterstützt.
Fragen zu Cloudflare D1
Nutzt TablePro die Sessions-API von D1?
Nein. Jede Anweisung wird als eigene Anfrage ohne Sitzung und Bookmark gesendet; daher wird nichts zwischen Anweisungen übernommen, weder in einem Tab noch zwischen Tabs.
Muss Wrangler installiert sein?
Nicht zum Durchsuchen, Abfragen oder Bearbeiten: TablePro spricht direkt mit der Cloudflare-API. Wrangler wird nur zum Laden einer SQL-Datei benötigt, da TablePro keinen Import für D1 bietet.
TablePro herunterladen
Erfordert macOS 13 Ventura oder neuer