Diese Seite beschreibt Calíope 1.8, die Version, die ich gerade baue. Die 1.7 ist im App Store für Mac, iPad, iPhone, Apple Watch, Apple TV und Apple Vision Pro. Das Changelog sagt, in welcher Version jede Funktion kam.
Fügt jedem Thema einen Button „In Calíope öffnen“ hinzu. Funktioniert nur mit installierter App.
Öffne und befrage lokale dateibasierte DuckDB-Datenbanken, ohne Server.
Wo es zu finden ist: Workspace › Werkzeuge › DuckDB-Editor
Der DuckDB-Editor ist ein eigenständiges Werkzeug für lokale .duckdb-Dateien, mit demselben Aufbau wie der SQLite-Editor: Struktur, Daten, SQL ausführen, ER-Diagramm – nur bei geöffneter Datei –, Query Builder und Einstellungen, und er funktioniert ohne Verbindung zu einem Server.
Er kann auch eine Datenbank im Arbeitsspeicher öffnen — ohne Datei — über Datendatei abfragen…, um mit einer CSV-, JSON- oder Parquet-Datei zu arbeiten, ohne etwas auf der Festplatte anzulegen.
Was Calíope mit DuckDB nicht tut. Es lädt keine Erweiterungen herunter — INSTALL, LOAD, UPDATE EXTENSIONS und Erweiterungs-Repositorys (CREATE und DROP EXTENSION REPOSITORY) werden abgelehnt, bevor sie die Engine erreichen —, nur die vier mitgelieferten sind vorhanden. Aus demselben Grund gibt es keine Secrets für Fernzugriff (CREATE SECRET), und ein ATTACH einer SQLite- oder Postgres-Datei ist nicht möglich, da dafür eine nicht eingebundene Erweiterung nötig wäre. Die Konfiguration der Engine wird beim Öffnen festgeschrieben: Ein SET einer Engine-Einstellung wird abgelehnt —auch threads und memory_limit, die sich nur in den Einstellungen ändern lassen; SET VARIABLE nicht, denn eine Variable ist keine Konfiguration— und verwirft wie jeder Fehler bei der Ausführung die ungespeicherten Änderungen. Die beiden SET, die die Meldungen von DuckDB 2.0 vorschlagen, sind die Ausnahme: Calíope hält sie vorher an, und sie verwerfen nichts. Was dagegen funktioniert, ist das Verschieben der ganzen Datenbank: Ganze Datenbank und Sichern unter… laufen außerhalb der offenen Transaktion.
Öffne eine vorhandene .duckdb-Datei oder erstelle eine neue.
Wo es zu finden ist: Workspace › Werkzeuge › DuckDB-Editor
Verwende Öffnen…, um eine vorhandene .duckdb-Datei auszuwählen, oder Neue Datenbank…, um eine leere zu erstellen. Zuletzt verwendete Dateien erscheinen auf dem Startbildschirm. Ein Schreibgeschützt-Zeichen erscheint, wenn eine Datei nicht geändert werden kann.
Liegt die Datei außerhalb des eigenen Ordners von Calíope, wird beim ersten Öffnen um Zugriff auf ihren Ordner gebeten: DuckDB muss eine .wal-Datei neben der .duckdb-Datei anlegen, und die Sandbox der App erlaubt das nur innerhalb eines vom Nutzer gewählten Ordners. Beim nächsten Öffnen einer Datei aus demselben Ordner wird das gemerkt. Keine DuckDB-Datei zur Hand? Im leeren Zustand öffnet Beispieldatenbank laden die Seite der Website mit dem öffentlichen Beispiel — ein kleiner Shop mit 50.000 Bestellungen, mit Calíope erstellt. Die App lädt nichts herunter: Sie öffnet die Seite, entscheiden tust du.
Du kannst die Datei auch von außerhalb von Calíope öffnen. Auf dem Mac im Finder mit Öffnen mit › Calíope oder per Doppelklick, wenn Calíope die Standard-App für diesen Dateityp ist. Auf iPad und iPhone, indem du sie in der Dateien-App teilst und Calíope wählst. Eine so geöffnete Parquet-Datei landet ebenfalls hier, in einer Datenbank im Arbeitsspeicher (siehe Datendatei abfragen…). Bietet die Sitzung vor dir dieses Werkzeug nicht an, öffnet sich die Datei in Ohne Verbindung öffnen.
Das Dateiformat. Eine neue Datenbank – die von Neue Datenbank… und die, die Sichern unter… aus einer Datenbank im Arbeitsspeicher anlegt – wird im Format von DuckDB 2.0 erstellt. Dieses Format öffnen DuckDB 2.0 und neuere Versionen; Calíope 1.7 und jedes Werkzeug mit DuckDB 1.5 oder älter können es nicht öffnen. Eine Datei, die es schon gab, behält ihr Format: Calíope öffnet und ändert sie, ohne sie umzuwandeln, sodass das Werkzeug, das sie erstellt hat, sie weiterhin öffnet. Das Format lässt sich beim Erstellen nicht wählen, und eine vorhandene Datei wird nicht umgewandelt. Das Format der geöffneten Datei steht unter Struktur: Unter der Leiste zeigt Dateiformat bei einer neuen Datenbank DuckDB 2.0 oder neuer und zum Beispiel DuckDB 1.0 oder neuer bei einer, die mit DuckDB 1.5 erstellt wurde.
Stichwörter: öffnen, erstellen, neu, zuletzt verwendet, datei, ordner, wal, format, version
Durchsuche Tabellen, Views und Indizes und erstelle sie.
Der Bereich Struktur zeigt den Schemabaum mit den Spalten und dem DDL jedes Objekts. DuckDB hat keine Trigger, daher zeigt der Baum Tabellen, Views, Indizes, Sequenzen, Typen, Makros und Tabellenmakros. Sequenzen, Typen und Makros werden über SQL ausführen angelegt —CREATE SEQUENCE, CREATE TYPE, CREATE MACRO, CREATE MACRO … AS TABLE—; hier siehst und löschst du sie. Hat die Datei mehrere Schemas, steht vor jeder Gruppe der Name ihres Schemas, und der Kommentar eines Objekts (COMMENT ON) erscheint beim Darüberfahren. Verwende Neu, um Tabellen, Indizes oder Views zu erstellen, Spalte hinzufügen oder Tabelle umbenennen für die ausgewählte Tabelle, und Löschen, um ein Objekt zu entfernen. Unter der Leiste zeigt Dateiformat, welche DuckDB-Versionen die Datei öffnen: Eine neue Datenbank braucht DuckDB 2.0 oder neuer, und eine, die es schon gab, behält ihr Format.
Von Datendatei abfragen… erstellte Views tragen ein anderes Symbol — eine Büroklammer — und ihr Tooltip zeigt den Pfad der Quelldatei.
Datenbank anhängen… öffnet eine weitere DuckDB-Datenbank neben der aktuellen; ihr Inhalt erscheint im Baum mit dem Datenbanknamen davor und wird als datenbank.schema.tabelle abgefragt. Sie wird immer nur lesend angehängt —Schreiben hieße, ihre .wal-Datei daneben anzulegen, was die Sandbox nicht erlaubt— und Trennen entfernt sie. Eine SQLite-Datei lässt sich hier nicht anhängen: Das sind zwei verschiedene Engines, und dafür gibt es den SQLite-Editor.
iPad und Apple Vision Pro: Auch der Detailbereich zeigt die Quelldatei.
Zeilen anzeigen, filtern, sortieren und bearbeiten.
Der Bereich Daten zeigt die Zeilen einer Tabelle seitenweise, mit der Anzahl und den Pfeilen rechts in der Leiste. Wie viele Zeilen auf eine Seite passen, wird unter Einstellungen › Texteditor › Ergebnisse › Zeilen pro Seite festgelegt — Einstellungen, auf dem iPad. Sortiere durch Antippen einer Spaltenüberschrift, grenze spaltenweise mit Filtern ein, oder tippe in das Suchfeld, um alle auf einmal zu durchsuchen.
Eine Zelle bearbeiten
macOS: Doppelklick darauf. iPad: ein einzelnes Tippen. Eingabe bestätigt; Esc bricht ab.
Zeilen hinzufügen und löschen
Zeile hinzufügen öffnet ein Formular mit einer Zeile pro Spalte. Anders als SQLite weist DuckDB den Primärschlüssel nicht automatisch zu: Jede Pflichtspalte braucht ihren eigenen Wert, auch der Schlüssel. Zum Löschen die Zeile über ihre Nummer auswählen und Zeile löschen verwenden.
Nichts davon ändert die Datei, bis du Änderungen speichern drückst: Bearbeitungen bleiben in einer ausstehenden Transaktion, die Änderungen verwerfen vollständig rückgängig macht.
Syntaxhervorhebung und Autovervollständigung, mit Zeilenlimit und Stopp-Taste.
Der Bereich SQL ausführen verwendet dasselbe Textfeld und dasselbe Ergebnisraster wie der SQL-Editor für Server, über der geöffneten Datei und ohne jede Verbindung.
Der Text wird hervorgehoben. Drücke Ausführen oder ⌘↩, um das ganze Skript auszuführen; gezeichnet wird das Ergebnis der letzten Anweisung, die Zeilen zurückgab. Ein großes SELECT wird nicht vollständig geladen: Es wird bei Einstellungen › Texteditor › Ergebnisse › Zeilenlimit abgeschnitten — demselben Limit, das der SQL-Editor verwendet —, und das Raster zeigt, wie viele von wie vielen geladen wurden.
Während eine Abfrage läuft, unterbricht die Taste Stoppen sie wirklich: Die Engine bricht mittendrin ab, statt auf das Ende zu warten.
Schlägt eine Anweisung fehl, hält das Skript dort an, und der Fehler erscheint an der Stelle der Ergebnisse. Ein Syntaxfehler oder ein Name, den es nicht gibt, lässt das Ausstehende, wie es war; ein Fehler bei der Ausführung verwirft die ungespeicherten Änderungen, und Calíope sagt es (Thema Änderungen speichern und verwerfen). Gibt es ein Thema, das den Fehler erklärt — das SQL, das DuckDB 2.0 nicht mehr akzeptiert, steht in Was sich mit DuckDB 2.0 ändert —, öffnet Lösung anzeigen es direkt am Fehler.
INSTALL und LOAD werden abgelehnt: Calíope lädt keine DuckDB-Erweiterungen herunter, also läuft eine Abfrage, die eine braucht, nicht — mit dem Grund in der Meldung.
Was du in die Datei schreibst, bleibt ausstehend, genau wie eine Bearbeitung in Daten: Es ändert die Datei erst bei Änderungen speichern.
Visual EXPLAIN
Die Schaltfläche Visual EXPLAIN neben Ausführen zeichnet den Plan, dem DuckDB folgen würde – EXPLAIN (FORMAT JSON) –, ohne etwas auszuführen, im selben Tab wie der SQL-Editor, mit den geschätzten Zeilen. Sie analysiert die Auswahl und ohne Auswahl die letzte Anweisung des Textes. Eine Tabelle kann trotz Index vollständig gelesen erscheinen: DuckDB speichert Minima und Maxima je Block und liest oft lieber alles, wobei es Blöcke überspringt.
Funktionseinträge
Fährst du auf macOS mit dem Zeiger über eine Funktion oder setzt du auf dem iPad den Textcursor darauf, erscheint ihr Eintrag, der von DuckDB: Syntax, Rückgabe, Parameter und ein Beispiel. Das Thema Kontexthilfe für SQL-Funktionen erklärt es.
Apple Vision Pro: wie auf dem iPad, und die Funktionskarte hängt über der Kopfzeile, unter dem Fenster.
Das SQL aus DuckDB 1.5, das 2.0 ablehnt oder anders beantwortet, mit seiner neuen Form.
DuckDB 2.0 antwortet auf etwas SQL anders, das mit DuckDB 1.5 funktioniert hat, und Calíope enthält DuckDB 2.0 seit Version 1.8. Ein älteres Skript kann jetzt einen Fehler liefern oder in einem Fall ohne Warnung ein anderes Ergebnis. Schlägt eine Abfrage wegen einer dieser Änderungen fehl, öffnet Lösung anzeigen neben dem Fehler dieses Thema.
Die Lösung ist immer, die Abfrage umzuschreiben. Die Meldungen der Engine schlagen ein SET vor, um zum alten Verhalten zurückzukehren; in Calíope hilft das nicht: Die Konfiguration von DuckDB ist gesperrt, solange eine Datei geöffnet ist (Thema Einstellungen und Wartung). Calíope hält dieses SET an, bevor es die Engine erreicht, und sagt es: Es wird nicht ausgeführt, und die ungespeicherten Änderungen bleiben erhalten.
Lambdas: lambda x: statt x ->
Eine mit Pfeil geschriebene Lambda-Funktion wird nicht mehr akzeptiert.
Vorher:
SELECT list_transform([1, 2, 3], x -> x + 1);
Jetzt:
SELECT list_transform([1, 2, 3], lambda x: x + 1);
Auf die alte Form antwortet die Engine:
Binder Error: Deprecated lambda arrow (->) detected. Please transition to the new lambda syntax, i.e.., lambda x, i: x + i, before DuckDB's next release.
// und % durch null sind Fehler
Die Ganzzahldivision //, der Rest % und die Funktionen divide und mod lieferten NULL, wenn der Divisor null war. Jetzt schlägt die Abfrage fehl, und weil es ein Fehler bei der Ausführung ist, verwirft er die ungespeicherten Änderungen. / ändert sich nicht: Es liefert weiterhin inf.
Vorher (lieferte NULL):
SELECT 7 // 0;
Jetzt, um weiterhin NULL zu erhalten:
SELECT TRY(7 // 0);
SELECT 7 // NULLIF(0, 0);
Die Engine antwortet:
Invalid Input Error: Division by zero in expression (7 // 0). Use TRY(...) to return NULL for this expression, or SET error_on_division_by_zero=false to return NULL for all divisions by zero.
~ passt auf einen Teil des Textes, nicht auf den ganzen Text
Diese Änderung liefert keinen Fehler, sondern ein anderes Ergebnis. Text ~ Muster war nur wahr, wenn der reguläre Ausdruck auf den ganzen Text passte; jetzt genügt es, dass er auf einen Teil passt, wie in PostgreSQL. !~ ändert sich genauso.
In CREATE TABLE … AS bekam eine Spalte, die aus einem bloßen NULL entsteht, den Typ INTEGER. Jetzt bekommt sie den Typ "NULL" und nimmt keinen anderen Wert an. Bereits angelegte Tabellen behalten ihren Typ.
Vorher:
CREATE TABLE notas AS SELECT 1 AS id, NULL AS nota;
INSERT INTO notas VALUES (2, 5);
Jetzt, mit ausgeschriebenem Typ:
CREATE TABLE notas AS SELECT 1 AS id, NULL::INTEGER AS nota;
INSERT INTO notas VALUES (2, 5);
Mit der alten Form schlägt das INSERT fehl:
Conversion Error: Unimplemented type for cast (INTEGER -> "NULL")
Eine Tabelle, die so entstanden ist, reparierst du, indem du den Typ der Spalte änderst:
ALTER TABLE notas ALTER COLUMN nota TYPE INTEGER;
Welche Fehler die ungespeicherten Änderungen verwerfen
Von sich aus bricht DuckDB 2.0 die offene Transaktion bei jedem Fehler ab, auch bei einem Syntaxfehler, und die nächste Anweisung antwortet:
TransactionContext Error: Current transaction is aborted (please ROLLBACK)
Calíope verwendet diese Voreinstellung nicht: Es öffnet jede Datei mit der Regel von DuckDB 1.5. Ein Syntaxfehler oder der Name einer Tabelle, Spalte oder Funktion, die es nicht gibt, lässt deine ungespeicherten Änderungen unberührt. Fehler, die bei der Ausführung auftreten, verwerfen sie wie bisher — eine verletzte Einschränkung, ein Wert, der sich nicht umwandeln lässt —, und jetzt auch die Division durch null, die vorher kein Fehler war. Calíope sagt es neben dem Fehler und führt das ROLLBACK für dich aus. Das Thema Änderungen speichern und verwerfen erklärt es.
Außerdem anders
EXPLAIN als Text wird anders gezeichnet: Kästen mit runden Ecken und ausgeschriebene Operatornamen. Visual EXPLAIN ändert sich nicht.
ALTER TABLE … ADD COLUMN akzeptiert jetzt Einschränkungen, etwa NOT NULL mit einem DEFAULT; DuckDB 1.5 lehnte sie ab.
Eine neue Datei wird im Format von DuckDB 2.0 angelegt, das ältere Versionen nicht öffnen. Das Thema Datenbank öffnen oder erstellen erklärt es.
Die Tabellen der Datei und ihre Fremdschlüssel, ohne Server gezeichnet.
Der Bereich ER-Diagramm zeichnet die Tabellen der geöffneten Datei mit ihren Spalten und den Fremdschlüsseln, die sie deklarieren, ohne Verbindung zu einem Server. Er erscheint nur, wenn eine Datei geöffnet ist: Eine Datenbank im Speicher bietet ihn nicht an, weil es keine Datei gibt, in der das Layout bleiben könnte.
Die Auswahl oben listet die Datenbank der Datei – sie heißt wie die Datei – und die angehängten; hat eine Datenbank Tabellen in mehr als einem Schema, ist jedes Schema ein Eintrag (tienda.main, tienda.ventas). + DB holt eine zweite daneben.
Er funktioniert wie das ER-Diagramm einer Verbindung: Zoom, Automatisches Layout, Export als PNG oder PDF, Drucken auf dem Mac und das CREATE TABLE einer Tabelle aus ihrem Menü. Nach einer Strukturänderung, einem ATTACH oder einem DETACH liest das Diagramm von selbst neu.
Er liest nur. Er bietet weder Neue FK-Beziehung… noch das Ziehen mit ⌃ an: DuckDB fügt einer bestehenden Tabelle keinen Fremdschlüssel hinzu (es lehnt ALTER TABLE … ADD CONSTRAINT … FOREIGN KEY ab). Um zwei Tabellen zu verknüpfen, wird der Fremdschlüssel beim Anlegen der Tabelle deklariert (REFERENCES in SQL ausführen).
Layout speichern speichert, wo du jede Tabelle gelassen hast, pro Datei und nur auf diesem Gerät: Es geht nicht über iCloud und nicht in die Sicherung der Einstellungen, weil der Pfad der Datei auf jedem Gerät ein anderer ist. Die Layouts der zuletzt benutzten Dateien bleiben erhalten, ältere werden von selbst gelöscht. Ändert das System den Pfad der Datei, geht ihr Layout verloren, genau wie ihr Eintrag in den zuletzt benutzten Dateien.
Lässt sich die Datei nicht lesen, sagt ein Hinweis über dem Diagramm, warum, mit dem Text der Engine.
Auf der Apple Vision Pro breitet Im Raum öffnen das Diagramm der Datei im Zimmer aus, ebenfalls nur zum Lesen; es schließt sich, wenn du die Datei schließt.
Stichwörter: diagramm, er, beziehungen, fremdschlüssel, duckdb, datei, layout, attach
Stell ein SELECT aus den Tabellen der Datenbank zusammen und bring es zu SQL ausführen.
Der Bereich Query Builder ist der Query Builder einer Verbindung, für die geöffnete Datenbank und ohne Server; er funktioniert auch mit einer Datenbank im Speicher. Die Liste links enthält die Tabellen der Datenbank, mit einem Filter nach Namen; drück auf eine, auf ihr +, oder zieh sie auf das Canvas. Der JOIN kommt aus den Fremdschlüsseln, die die Datenbank deklariert, und wo es keinen gibt, gibst du in Beziehungen an, welche Spalten zusammengehören. Bedingungen, JOIN-Typ, Aliasse, Canvas leeren und das Kopieren des SQL funktionieren wie bei einer Verbindung.
Mit angehängten Datenbanken wählt das Menü oben, welche; die der Datei heißt wie die Datei. Sobald es mehr als eine Datenbank oder ein Schema gibt, wird jede Tabelle mit ihrem vollen Namen geschrieben ("tienda"."main"."clientes"), weil zwei gleich heißen können. Nimmt ein DETACH die gewählte Datenbank weg, wechselt das Canvas zur Hauptdatenbank.
In Editor einfügen fügt die Abfrage am Ende dessen an, was du in SQL ausführen geschrieben hast, nach einer Leerzeile, und wechselt in diesen Bereich. Es ersetzt nie, was dort stand.
Das Canvas bleibt, wenn du den Bereich oder den Tab wechselst, und wird verworfen, wenn du die Datenbank schließt. Auf dem iPhone und auf dem iPad in geteilter Ansicht füllt die Liste den Bildschirm, und eine Tabelle hinzuzufügen bringt dich zum Canvas.
Änderungen bleiben ausstehend, bis du sie speicherst.
Bearbeitungen werden zu einer ausstehenden Transaktion zusammengefasst, genau wie im SQLite-Editor. Ein bernsteinfarbener Punkt zeigt ungespeicherte Änderungen an. Verwende Änderungen speichern, um sie zu übernehmen, oder Änderungen verwerfen, um sie zu verwerfen. Beim Schließen der Datei oder beim Öffnen oder Anlegen einer anderen fragt Calíope bei ausstehenden Änderungen zuerst, ob sie gespeichert oder verworfen werden sollen.
Wenn eine Anweisung fehlschlägt
Es kommt darauf an, was fehlschlägt. Ein Syntaxfehler oder der Name einer Tabelle, Spalte oder Funktion, die es nicht gibt, lässt das Ausstehende unberührt: Du korrigierst die Abfrage und machst weiter. Dasselbe gilt für Visual EXPLAIN bei einer falsch geschriebenen Abfrage.
Ein Fehler, der bei der Ausführung auftritt, lässt DuckDB die ganze Transaktion abbrechen, und mit ihr alle ungespeicherten Änderungen, nicht nur das, was die fehlgeschlagene Anweisung tun wollte: eine Zelle oder eine neue Zeile, die eine Einschränkung verletzt, ein Wert, der sich nicht umwandeln lässt, eine Ganzzahldivision durch null, ein SET einer Engine-Einstellung — die Konfiguration ist gesperrt; die beiden, die die Meldungen der Engine vorschlagen, hält Calíope vorher an, und sie verwerfen nichts — oder eine Abfrage, die du mit Stoppen anhältst. Calíope sagt es neben dem Fehler, der bernsteinfarbene Punkt verschwindet, und das Raster zeigt wieder, was gespeichert ist. Von Hand rückgängig zu machen gibt es nichts: Was du als Nächstes tust, läuft in einer neuen Transaktion. Speichere, was du nicht verlieren willst, bevor du Abfragen ausprobierst.
Für ein Skript gilt dasselbe: Schlägt es bei der Ausführung fehl, geht mit der Transaktion verloren, was seine früheren Anweisungen geschrieben haben; scheitert es an der Syntax oder an einem Namen, bleibt das Geschriebene ausstehend.
Von sich aus würde DuckDB 2.0 die Transaktion bei jedem Fehler abbrechen; Calíope öffnet jede Datei mit der Regel von DuckDB 1.5, der oben beschriebenen. Das Thema Was sich mit DuckDB 2.0 ändert erklärt es.
DuckDB schreibt zuerst in eine .wal-Datei neben der .duckdb-Datei; das Übertragen in die Hauptdatei (CHECKPOINT) geschieht asynchron, sodass die .wal-Datei nach dem Speichern und Schließen noch einige Sekunden bestehen bleiben kann — die Daten sind bereits sicher, auch wenn diese Nebendatei noch einen Moment da ist.
Gib DuckDB Threads und Speicher, und führe einen Checkpoint aus oder verdichte die Datei.
Der Bereich Einstellungen ist im DuckDB-Editor, was im SQLite-Editor der Bereich Pragmas ist. Unter Bearbeitbar werden Threads und Speicherlimit (MB) mit Anwenden wirksam: Die Konfiguration von DuckDB ist gesperrt, solange eine Datei geöffnet ist —ein SET threads oder SET memory_limit ändert sie nicht: Die Engine lehnt es ab, und das verwirft wie jeder Fehler bei der Ausführung die ungespeicherten Änderungen—, also merkt sich Calíope den Wert und öffnet die Datei damit neu. Sie gehören zu diesem Gerät —ein Mac und ein iPad haben weder dieselben Kerne noch denselben Speicher— und reisen nicht mit deinen übrigen Einstellungen. Bei einer Datenbank im Arbeitsspeicher gibt es keine Datei zum Neuöffnen, und sie greifen nicht.
Wartung führt Checkpoint aus —das die .wal in die Datei überträgt—, Checkpoint erzwingen, Vacuum und Analysieren, und die Antwort der Engine erscheint unter den Schaltflächen. Wie die Einstellungen sind die Schaltflächen gesperrt, solange es ungespeicherte Änderungen gibt: erst speichern oder verwerfen. Die übrigen Einstellungen der Engine stehen unter Schreibgeschützt mit ihrem aktuellen Wert.
CSV importieren und als CSV, JSON oder SQL exportieren.
Über Importieren / Exportieren kannst du eine CSV-Datei in eine neue Tabelle mit Textspalten importieren, eine Tabelle als CSV oder JSON exportieren, oder die gesamte Datenbank als SQL-Dump (Schema und Daten) exportieren.
Das unterscheidet sich von Datendatei abfragen…: Hier wird die CSV-Datei als neue Tabelle in die .duckdb-Datei kopiert; dort bleibt die Datei, wo sie ist, und wird nur über eine View abgefragt.
Bei DuckDB liest die Engine die CSV selbst (COPY … AUTO_DETECT), jede Spalte kommt also mit ihrem Typ an und nicht als Text. Und Ganze Datenbank schreibt die komplette Datenbank in einen Ordner deiner Wahl —als CSV oder Parquet, mit dem Schema daneben— oder liest in die offene Datenbank, was ein anderer Export hinterlassen hat. Liegt die Datenbank im Arbeitsspeicher, schreibt Sichern unter… sie ganz in eine .duckdb-Datei und arbeitet dann damit weiter.
Das Exportieren und Importieren der ganzen Datenbank verlangen, dass nichts ungesichert ist: Calíope führt beides außerhalb der offenen Transaktion aus, weil ein Fehler mittendrin – eine Tabelle, die es schon gibt, ein Ordner ohne Zugriffsrecht – sie mit allem Ungesicherten abbrechen würde. Sichern unter… verlangt das nicht: Es schreibt zuerst fest, was offen ist, und das berührt bei einer Datenbank im Arbeitsspeicher keine Datei.
Befrage eine CSV-, JSON- oder Parquet-Datei wie eine Tabelle, ohne sie zu kopieren.
Die Taste Datendatei abfragen… erstellt für jede gewählte Datei eine View darauf — je nach Endung read_csv_auto, read_json_auto oder read_parquet: Die Datei bleibt, wo sie ist, und wird bei jeder Abfrage der View neu eingelesen, ohne ihre Daten in die Datenbank zu kopieren.
Der Name der View stammt vom Dateinamen ohne Endung; würden zwei Dateien denselben Namen ergeben, erhält die zweite _2, die dritte _3 und so weiter. In Struktur tragen diese Views ein anderes Symbol — eine Büroklammer — und ihr Tooltip zeigt den Pfad der Quelldatei.
Ist keine Datenbank geöffnet, öffnet die Taste zuerst eine Datenbank im Arbeitsspeicher: Es gibt keine .duckdb-Datei auf der Festplatte, daher ist Sichern unter… der Weg, die Arbeit beim Schließen nicht zu verlieren: Es schreibt sie ganz in eine .duckdb-Datei, und der Editor arbeitet damit weiter.
Eine Parquet-Datei, die von außerhalb von Calíope geöffnet wird — im Finder mit Öffnen mit › Calíope oder aus der Dateien-App geteilt —, landet ebenfalls hier: Sie öffnet eine Datenbank im Arbeitsspeicher mit der View auf diese Datei und lässt SELECT * FROM read_parquet(…) LIMIT 100; in SQL ausführen stehen, ohne es auszuführen.
iPad und Apple Vision Pro: Auch der Detailbereich zeigt die Quelldatei.
Die Schaltfläche Zusammenfassung in Daten schreibt SUMMARIZE über die offene Tabelle und führt es aus: eine Zeile pro Spalte mit Typ, Bereich, verschiedenen Werten, Nullwerten und Quartilen.
Wo es zu finden ist: Workspace › Werkzeuge › DuckDB-Editor
In Daten, mit gewählter Tabelle, schreibt die Schaltfläche ZusammenfassungSUMMARIZE <schema>.<tabelle>; in den Editor, wechselt zu SQL ausführen und führt es aus. Das Ergebnis hat eine Zeile pro Spalte, mit Typ, Minimum, Maximum, ungefährer Anzahl verschiedener Werte, Anteil der Nullwerte, Mittelwert und Quartilen.
Es ist eine Funktion von DuckDB: Der SQLite-Editor zeichnet die Schaltfläche nicht.