Zum Inhalt springen

TablePro täglich nutzen? Eine Lizenz ergänzt Bezahlfunktionen und finanziert die nächste Version. Lizenz kaufenLizenz kaufen, TablePro fördern

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

Die Mac-App kannst du kostenlos herunterladen und nutzen. Ein Starter- oder Team-Tarif ergänzt optionale Funktionen.
Für Mac herunterladen

Erfordert macOS 13 Ventura oder neuer