Erste Schritte

Überblick über die App und ihren Arbeitsablauf.

Calíope ist ein nativer Client für MySQL, MariaDB, Amazon Aurora und PostgreSQL, verfügbar auf macOS, iPad und iPhone. Der Haupt-Arbeitsablauf besteht aus zwei Bildschirmen: dem Verbindungsmanager, in dem die Server-Profile verwaltet werden, und dem Workspace, der sich nach dem Verbindungsaufbau öffnet.

Der Workspace enthält eine Seitenleiste mit dem Schema-Baum, eine Tab-Leiste zum gleichzeitigen Öffnen mehrerer Tools und eine Schnellzugriffsleiste für alle Tools.

Stichwörter: start, overview, überblick, was ist, einführung

Eine Datei startet zwölf Testserver auf Ihrem Mac, samt Beispieldaten.

Wenn Sie keinen Server zur Hand haben oder sehen möchten, was Calíope kann, bevor Sie es auf einen eigenen richten, können Sie genau die Testumgebung auf Ihrem Mac starten, gegen die die App entwickelt wird. Es ist eine einzige Datei, und sie braucht nichts außer Docker.

→ caliope-testbed.command herunterladen

Was Sie brauchen. macOS 12 oder neuer, Docker Desktop — für privaten Gebrauch kostenlos, auf docker.com — und etwa 2 GB freien Speicher auf Platte und im RAM.

So starten Sie sie. Am saubersten sind diese vier Zeilen im Terminal:

cd ~/Downloads
curl -fLO https://caliope.org/caliope-testbed.command
chmod +x caliope-testbed.command
./caliope-testbed.command

Wenn Sie die Datei lieber mit dem Browser laden: dann sind zwei Schritte mehr nötig, und in dieser Reihenfolge. Erst ausführbar machen (chmod +x auf die geladene Datei), dann beim ersten Mal mit Rechtsklick › Öffnen statt per Doppelklick starten, denn macOS stellt alles unter Quarantäne, was ein Browser herunterlädt. Mit curl entfällt beides.

Beim ersten Lauf dauert es einige Minuten, bis die Images geladen sind; währenddessen sagt sie, woran sie arbeitet. Am Ende schreibt sie einen Bericht mit den Adressen, den Ports und den Zugangsdaten.

Was gestartet wird. Zwölf Server, so gewählt, dass kein Werkzeug von Calíope ohne Inhalt bleibt:

Dazu ein SSH-Bastion und dauerhafte Lastgeneratoren: so haben das Dashboard, das Protokoll langsamer Abfragen, die Prozessliste und der Replikationsmonitor echten Verkehr zu zeigen.

Die Profile tippen Sie nicht ab. Jeder Lauf legt neben dem Starter eine Datei caliope-testbed-connections.json ab, mit den zwölf Knoten als einer Gruppe. In Calíope: Einstellungen › Verbindungen › Importieren. Der Import führt zusammen, es wird also nichts gelöscht, was Sie schon haben. Benutzer ist caliope, das Passwort caliopepass. Die zwei Profile über den Tunnel fragen beim ersten Mal nach ihrem SSH-Passwort (tunnel123), denn SSH-Geheimnisse leben ausschließlich im Schlüsselbund.

Vom iPad und iPhone aus ebenso. Jedes Profil trägt die Netzadresse des Macs als Ausweichadresse, dieselbe Datei funktioniert also auf allen drei Geräten, ohne etwas zu ändern — solange der Mac läuft, die Testumgebung an ist und beide im selben Netz sind.

Die vier Befehle.

Vorsicht mit --fresh: es ist destruktiv und reicht über Calíope hinaus. Es stoppt alle Docker-Container auf Ihrem Mac und löscht Images, Volumes und Caches, die niemand benutzt — auch die Ihrer anderen Projekte. Es sagt das und fragt vorher nach einer Bestätigung. Dafür ist es der einzige Lauf, der die drei Beispieldatensätze zum Download anbietet, einen pro Engine: Sakila für MySQL und MariaDB, Pagila für PostgreSQL und die Atlas-Stichprobe für MongoDB. Jeder wird einzeln gefragt.

Dies ist kein Server zum Arbeiten. Die Passwörter sind öffentlich und stehen in der Datei selbst, nichts ist verschlüsselt, und alles lauscht auf Ihrer Maschine. Es ist eine Testumgebung: zum Lernen, um ein Werkzeug auszuprobieren, bevor Sie es auf eigene Daten anwenden, und damit ein Fehlerbericht nachvollziehbar wird.

Stichwörter: docker, test, testumgebung, beispiel, ohne server, demo, üben, sakila

Erstell ein Profil und stell deine erste Verbindung zu einem Server her.

Wo es zu finden ist: Verbindungsmanager › Button +

Tipp im Verbindungsmanager auf den Button + in der Seitenleiste, um ein neues Profil zu erstellen. Füll Host, Port (standardmäßig 3306), Benutzer und Passwort aus. Tipp auf Verbindung testen, um die Daten vor dem Speichern zu prüfen.

Nach erfolgreicher Prüfung tipp auf Verbinden, um den Workspace zu öffnen. Das Profil wird gespeichert und steht in der Liste für künftige Verbindungen bereit.

Stichwörter: erstes mal, neue verbindung, profil, host, port

Seitenleiste **Werkzeuge**, Tabs, Serverauswahl und Statusleiste im Griff.

Der Workspace besteht aus drei Zonen: der Seitenleiste Werkzeuge links, der Tab-Leiste mit den geöffneten Werkzeugen und der Statusleiste unten.

Zum Öffnen eines Werkzeugs klick auf seine Zeile in der Seitenleiste. Jedes öffnet sich in einem eigenen Tab; du kannst mehrere offen halten und mit ⌘] und ⌘[ wechseln. Die Zeilen sind thematisch gruppiert; Reihenfolge und Gruppen stellst du über den Button ⋮≡ in der Seitenleiste selbst ein (siehe Die Hauptleiste anpassen). Jede Gruppe klappt sich mit einem Klick auf ihre Überschrift ein, und das Feld oben in der Seitenleiste filtert die Tools nach Namen (siehe Die Seitenleiste filtern und einklappen).

Serverauswahl: das Menü mit dem Namen des aktiven Servers liegt oben links (macOS) bzw. links neben der Tab-Leiste (iPad). Dort wechselst du die Sitzung, fügst einen weiteren Server hinzu oder trennst die Verbindung. Calíope erlaubt mehrere aktive Verbindungen gleichzeitig.

Seitenleiste ausblenden: der Button in der Titelleiste klappt sie ein und gibt dem aktiven Werkzeug die volle Breite.

Der Schemabaum ist nicht hier: er sitzt im SQL-Editor, dem einzigen Ort, an dem er nützt.

Ohne Verbindung: der Workspace ohne Server zeigt eine Schnellzugriffsleiste mit allem, was keine Verbindung braucht — SQL-Editor, Snippets, SQLite-Editor, Dateivorschau, Fehler und Berichte. Der Chevron an ihrem rechten Ende klappt sie ein.

Auf dem iPhone und im schmalen Fenster: die Werkzeuge stehen in einer unteren Leiste mit den ersten vier deiner Reihenfolge und einer Taste Mehr für den Rest. Welche vier das sind, entscheidest du, indem du die Seitenleiste umsortierst.

Stichwörter: workspace, seitenleiste, werkzeuge, tabs, navigation, serverauswahl, statusleiste, offline

Welche Tools erscheinen, entscheidet die Verbindung — keine Einstellung, die du geändert hast.

Der Tool-Navigator zeigt nicht immer dieselbe Liste: er zeigt, was diese Sitzung kann. Beim Verbinden ermittelt Calíope, was diese Verbindung beherrscht, und blendet den Rest aus. Was du nicht siehst, ist weder kaputt noch abgeschaltet: es wird nicht angeboten.

Das Ausblenden ist Absicht. Ein Tool, das nur aufgeht, um „hier nicht“ zu sagen, hat den Weg schon gekostet, und eine ausgegraute Zeile lädt dazu ein, nach dem Schalter zu suchen, der sie einschaltet — und den gibt es nicht.

Wegen der Art der Datenbank. Ein relationaler und ein dokumentenorientierter Server ähneln sich nicht: eine Dokumentensitzung hat weder SQL-Editor noch ER-Diagramm, und eine relationale hat keinen Collection-Browser. Das ändert sich nie, und es ist bei keinem von beiden ein Mangel.

Wegen dessen, was diese Verbindung kann. Auch zwei relationale Server bieten nicht exakt dasselbe. Mal kennt die Engine das Konzept gar nicht, dann wird das Tool bei diesem Server nie erscheinen, weil es nichts zu zeigen gäbe; mal hat Calíope es für diese Engine noch nicht geschrieben, dann erscheint es in einer späteren Version. Beide Abwesenheiten sehen absichtlich gleich aus: Du musst jetzt wissen, ob das Tool taugt, nicht warum nicht.

Ohne Verbindung zeigt der Navigator nur, was ohne Server funktioniert: den SQL-Editor, die Snippets, den SQLite-Editor, die Dateivorschau, die Fehler und die Berichte — Letztere nur halb, denn ohne Server lassen sie sich ansehen, bearbeiten und exportieren, aber nicht ausführen.

Wo es dir sonst auffällt. Der Button Los in dieser Hilfe kann auf ein Tool zeigen, das deine Sitzung nicht anbietet: dann öffnet sich nichts und die Statusleiste sagt es beim Namen. Das ist eine Antwort, kein Fehler.

Und diese Hilfe enthält sie alle. Das Inhaltsverzeichnis ändert sich nicht mit dem Server, mit dem du verbunden bist — du findest hier also Themen zu Tools, die deine jetzige Sitzung nicht zeigt. Fehlt dir eines, öffne eine Sitzung zu einem anderen Server: die Liste wird bei jeder Verbindung neu berechnet.

Stichwörter: Tools, fehlen, nicht sichtbar, Navigator, Verfügbarkeit, Engine, Sitzung, ausgeblendet, Los

Klapp die Gruppen ein, die du nicht brauchst, und tipp ins Feld oben, um ein Tool über seinen Namen zu finden.

Die Seitenleiste Tools verteilt die gut zwanzig Tools von Calíope auf Themen. Zwei Dinge machen sie kürzer.

Eine Gruppe einklappen: klick auf ihre Überschrift. Der Chevron dreht sich und die Zeilen der Gruppe verschwinden; neben dem Namen bleibt die Anzahl der versteckten Tools stehen, damit keines spurlos verloren geht. Ein weiterer Klick klappt sie wieder aus. Was du einklappst, bleibt beim Beenden der App erhalten und wandert zu deinem anderen Mac, iPad oder iPhone, wenn die iCloud-Synchronisierung aktiv ist.

Filtern: das Feld oben lässt nur die Tools stehen, die zu deiner Eingabe passen. Gesucht wird im Namen des Tools, in seinem vollständigen Katalognamen und in dem Satz, der sagt, was es tut, und außerdem im Namen seiner Gruppe — wer den Namen einer Gruppe tippt, sieht sie also vollständig. Akzente spielen keine Rolle: replicacion findet Replicación.

Während du filterst, wird jede Gruppe mit Treffern offen gezeichnet, auch die eingeklappten. Nichts, was du findest, kann in einer geschlossenen Gruppe versteckt bleiben. Deine eingeklappten Gruppen werden dabei nicht angerührt: leer das Feld, und alles ist wieder genau wie vorher.

Mit Esc oder dem × leerst du das Feld. Der Filter wird beim Beenden der App nicht gemerkt — eine Seitenleiste, die aus einem Grund halb leer startet, an den du dich nicht erinnerst, ist schlimmer, als drei Buchstaben noch einmal zu tippen.

Stichwörter: Seitenleiste, Tools, filtern, suchen, Gruppen, einklappen, ausklappen

Was ohne Serververbindung funktioniert — und was nicht.

Calíope enthält einen Offline-Workspace, der auch dann verfügbar ist, wenn kein Server verbunden ist. Praktisch, um Queries zu schreiben und deine Snippets zu organisieren, ohne eine Verbindung zu brauchen.

So öffnest du ihn:

Aus dem Verbindungsmanager, ohne dich mit einem Server zu verbinden. Wo der Button sitzt, hängt vom Platz ab: auf einem breiten Bildschirm — Mac und iPad — steht er im Willkommensbildschirm neben „Profil erstellen“; auf einem schmalen — dem iPhone, und dem iPad im geteilten Fenster — wird dieser Bildschirm gar nicht gezeichnet, also sitzt er in der unteren Leiste, mit dem Terminal-Symbol.

Im Offline-Modus verfügbare Tools:
- SQL-Editor — schreib und speichere SQL, nutz den Verlauf und die Snippets. Queries können nicht gegen einen Server ausgeführt werden.
- Snippets — erstell, bearbeite und kopiere deine Code-Snippets.
- SQLite-Editor — öffne eine .sqlite-Datei von der Platte und arbeite komplett damit: kein Server nötig, denn die Datei ist die Datenbank.
- Dateivorschau — sieh dir CSV, JSON, Markdown und den Rest an, ohne die App zu verlassen.
- Fehler — das Protokoll ist lokal, und du musst es genau dann lesen können, wenn keine Verbindung möglich ist.
- Berichte — bereits vorhandene Ergebnisse lassen sich ansehen, bearbeiten und exportieren; einen Bericht auszuführen braucht sehr wohl einen Server, und die Ansicht sagt das.

Offline-Banner: Ein goldener Streifen am oberen Rand des Workspace zeigt an, dass du im Offline-Modus bist.

Um dich aus dem Offline-Workspace mit einem Server zu verbinden, tipp auf den Button Mit Server verbinden in der Toolbar oder im oberen Banner. Der Verbindungsmanager öffnet sich als schwebendes Panel, ohne dass der Editor-Inhalt verloren geht.

Stichwörter: offline, ohne verbindung, offline-modus, ohne server, offline-editor, offline-workspace, editor ohne verbindung, snippets

Zeigt Ergebnis, Zeit und Fortschritt der laufenden Operationen an.

Die Statusleiste erscheint am unteren Rand des Workspace und des SQL-Editors. Sie spiegelt den Status der zuletzt ausgeführten Operation wider.

Angezeigte Informationen:
- Ergebnismeldung — beschreibender Text zur letzten Operation (betroffene Zeilen, Ausführungszeit, Fehler).
- Fortschritt — Fortschrittsbalken oder Ladeanimation, während eine Query oder Aufgabe läuft.
- Prozentwert — bei langen Operationen (wie Backups oder Wiederherstellungen) wird der numerische Fortschritt angezeigt.

Meldung kopieren:

macOS: Ein Doppelklick auf den Textbereich der Statusleiste kopiert die komplette Meldung in die Zwischenablage. Praktisch, um Fehlermeldungen zu kopieren, ohne sie manuell markieren zu müssen.

iPad: Dieselbe Doppeltipp-Geste kopiert die Meldung.

Die Statusleiste ist immer sichtbar und kann nicht ausgeblendet werden.

Stichwörter: statusleiste, status bar, fortschritt, meldung, meldung kopieren, fehler, ausführungszeit, doppelklick

Ordne die Schaltflächen der Editor- und der Ergebnisleiste neu an oder blende sie aus.

Wo es zu finden ist: SQL-Editor › Leiste anpassen

Der SQL-Editor hat zwei eigene Leisten, die getrennt angepasst werden:

- Editor-Leiste — über dem Textbereich: ausführen, formatieren, kommentieren, Verlauf, Schema-Panel…
- Ergebnisleiste — über dem Raster: exportieren, Diagramm, Spalten-Profiler, Filter…

Den Anpasser öffnen
Klick auf den Button ⋮≡ (Symbol slider.horizontal.3) am Anfang der gewünschten Leiste.

Was möglich ist
- Neu ordnen — zieh jede Schaltfläche an die Stelle, die du willst.
- Ausblenden — hak ab, was du nicht brauchst; die Aktionen bleiben über Menüs und Tastaturkürzel erreichbar.
- Zurücksetzen — stellt die ursprüngliche Anordnung dieser Leiste wieder her.

Beide Leisten scrollen waagerecht, also bleibt keine Schaltfläche unerreichbar, wie schmal das Fenster auch ist.

Für den Werkzeug-Starter des Workspace siehe Die Hauptleiste anpassen.

Stichwörter: editor-leiste, ergebnisleiste, anpassen, neu ordnen, ausblenden, ziehen, sql-editor

Ordne die Buttons der Hauptleiste des Workspace neu, um deine Lieblings-Tools nach vorn zu stellen.

Wo es zu finden ist: Workspace › Hauptleiste anpassen

Die Navigations-Seitenleiste (App-Launcher) ordnet die Direktzugriffe auf alle Workspace-Tools in logische Gruppen für einen optimierten Arbeitsablauf:

1. Entwicklung und Abfragen — SQL-Editor, Query Builder, Snippets, SQL-Log und SQLite-Editor.
2. Design und Struktur — Kataloge, ER-Diagramm, Schema-Diff und Objektmigration.
3. Diagnose und Leistung — Dashboard, Server-Health, SQL-Warnungen, Replikationsüberwachung und Binlog-Viewer.
4. Serververwaltung — Server-Info, Prozesse, Benutzer, Backup und Wartung.
5. Intelligenter Assistent — KI-Assistent.

So öffnest du den Anpasser
- Oben in der Navigations-Seitenleiste findest du den Anpassungs-Button ⋮≡ (Symbol slider.horizontal.3).
- Tipp darauf, um den Anpassungsbildschirm zu öffnen.

Was du tun kannst
Der Anpasser bietet eine hierarchische, vollständig dynamische Steuerung in zwei Tabs:
- Tab "Gruppen neu ordnen" — zieh ganze Abschnitte per Drag-and-drop, um die Reihenfolge der Kategorien zu ändern, sie umzubenennen oder eigene Gruppen hinzuzufügen.
- Tab "Elemente neu ordnen" — zieh einzelne Tools innerhalb einer Gruppe, oder tippe auf Verschieben nach..., um ein Tool dynamisch in einen anderen Abschnitt zu verschieben.
- Zurücksetzen — der Button Zurücksetzen stellt die nativen Standardgruppen und ihre Reihenfolge mit einem Tipp wieder her.

Persistenz und Selbstheilung
Deine Konfiguration wird sicher in UserDefaults gespeichert (unter dem Schlüssel caliope_sidebar_config_macos bzw. caliope_sidebar_config_ipad). Fügt Calíope in einem künftigen Update ein neues Tool hinzu, wird es automatisch in seine Standardgruppe eingefügt, ohne deine bestehende Anpassung zu stören.

Stichwörter: hauptleiste, quick access, nav strip, anpassen, neu ordnen, buttons, ziehen, overflow

Arbeite mit mehreren MySQL-, MariaDB-, Aurora- oder PostgreSQL-Servern gleichzeitig, ohne den Kontext des einzelnen zu verlieren.

Wo es zu finden ist: Server › Session hinzufügen…

Calíope hält für jedes geöffnete Verbindungsprofil unabhängige Sessions. Jede Session hat ihre eigenen Tabs, ihre eigene aktive Datenbank, ihren eigenen Query-Verlauf und ihre eigenen Layout-Einstellungen.

Eine neue Session öffnen
- macOS: Menü Server › Session hinzufügen… oder Kurzbefehl ⌘⌥N. Du kannst auch Neue Session in der Serverauswahl in der oberen linken Ecke wählen.
- iPad: Öffne die Serverauswahl (Symbol links neben der Tab-Leiste) und tipp auf Session hinzufügen.

Zwischen Sessions wechseln
- Nutz die Serverauswahl in der oberen linken Ecke (macOS) oder in der Tab-Leiste (iPad). Jede Session zeigt den Profilnamen, den Host und einen farbigen Punkt für ihren Status.
- macOS: Kurzbefehl ⌘⌥1…9, um direkt zu den ersten neun Sessions zu springen.

Zustand pro Session
- Jede Session merkt sich die aktive Datenbank, die offenen Tabs und den Query-Verlauf im QueryLogger.
- SSH- und SSL-Verbindungen werden nur einmal pro Session aufgebaut; beim Session-Wechsel wird nicht neu verbunden.
- Das angeheftete Widget folgt dem in Einstellungen › Widget als angeheftet markierten Profil, unabhängig davon, welche Session im Vordergrund ist.

Eine Session schließen
- Schließ alle Tabs über das × oder nutz Server › Trennen. Calíope schließt den SSH-Tunnel, falls vorhanden.
- Die Passwörter bleiben im Keychain; beim erneuten Verbinden werden sie nicht erneut abgefragt, außer das Profil verlangt Biometrie.

Stichwörter: sessions, multi-session, mehrere server, gleichzeitig, session wechseln, serverauswahl, session hinzufügen, session manager, ⌘⌥N, trennen

So erreichst du den vollständigen Hilfe-Index auf jeder Plattform.

Wo es zu finden ist: Hilfe › Calíope-Hilfe

Die Hilfe von Calíope steht als Fenster bzw. eigenes Panel mit Index, Suche und Abschnittsnavigation zur Verfügung. Sie öffnet sich je nach Plattform unterschiedlich, zeigt aber denselben Inhalt.

macOS: Menü Hilfe › Calíope-Hilfe oder Kurzbefehl ⌘?. Das Fenster schwebt frei und kann geöffnet bleiben, während du den Rest der App nutzt.

iPad: Menü Hilfe › Calíope-Hilfe oder Kurzbefehl ⌘?, wenn eine externe Tastatur angeschlossen ist. Die Hilfe erscheint als aufschiebbares Panel; schließ es mit dem Button Schließen in der oberen rechten Ecke oder wisch nach unten.

Kontexthilfe (?): Jede Ansicht der App hat einen ?-Button in ihrer oberen Leiste, der direkt das zugehörige Thema öffnet. Das ist der schnellste Weg, wenn du schon weißt, welches Tool dich interessiert.

Im Web: Dieselbe Hilfe ist unter https://caliope.org/help/ veröffentlicht, in den fünf Sprachen. Von dort hat, mit aktiviertem „Ich habe Calíope installiert“, jedes Thema einen Button „In Calíope öffnen“, der es in der App öffnet; der Link eines Themas hat die Form caliope://help/<Kennung>.

Stichwörter: hilfe, help, index, thema suchen, hilfe-menü, ⌘?, dokumentation, cmd?