Query-Log

Vollständiger Verlauf ausgeführter Queries mit Zeit und Status.

Wo es zu finden ist: Workspace › Werkzeuge › SQL-Log

Öffne das Query-Log über die Navigationsleiste des Workspace. Es zeigt alle Queries der aktuellen und vergangenen Sessions mit ihrer Session-ID, ihrem Timestamp, ihrer Ausführungszeit und ihrem Status (OK/Error).

Stichwörter: log, Verlauf, Queries, Protokoll, query log

Zeigt nur die Queries einer bestimmten Session.

Wo es zu finden ist: Query-Log › Session-Auswahl

Das Auswahlfeld Session in der Leiste des Logs erlaubt das Filtern nach Verbindungssession. Jedes Mal, wenn du dich mit dem Server verbindest, wird eine eindeutige Session-ID erzeugt. Wähl Alle Sessions, um den vollständigen Verlauf zu sehen, oder wähl eine bestimmte Session aus.

Stichwörter: Session, filtern, session, ID, Filter

Filtert Log-Einträge nach dem Text der Query.

Wo es zu finden ist: Query-Log › Suche

Gib mindestens 2 Zeichen in das Suchfeld der Log-Leiste ein. Der Filter ist mit dem Session-Filter kumulativ: Beide werden gleichzeitig angewendet.

Stichwörter: suchen, search, filtern, Text, Query

Zeigt nur die Queries eines bestimmten Verbindungsprofils.

Wo es zu finden ist: Query-Log › Verbindungsauswahl

Das zweite Auswahlfeld in der Log-Leiste filtert die Einträge nach Verbindungsprofil. Wähl den Namen des Servers oder Profils im Aufklappmenü, um nur die in diesem Kontext ausgeführten Queries zu sehen. Wähl Alle Verbindungen, um den vollständigen Verlauf zu sehen.

Stichwörter: Verbindung, filtern, Profil, Server, Verbindungsfilter

Zeigt nur erfolgreiche Queries oder nur die, die einen Fehler erzeugt haben.

Wo es zu finden ist: Query-Log › OK- / Error-Auswahl

Das dritte Auswahlfeld in der Log-Leiste filtert nach Ausführungsstatus: Alle, OK (nur erfolgreiche Queries) oder Error (nur die fehlgeschlagenen). Kombiniere es mit dem Session-Filter und der Textsuche, um die relevanten Einträge schnell einzugrenzen.

Stichwörter: error, ok, Status, Ergebnis filtern, Erfolg, Fehler

Lädt die Log-Einträge aus dem lokalen Speicher neu.

Wo es zu finden ist: Query-Log › Neuladen-Schaltfläche

Klick auf die Neuladen-Schaltfläche (Symbol mit kreisförmigem Pfeil) in der Log-Leiste, um eine manuelle Aktualisierung zu erzwingen. Nützlich, wenn das Log Queries nicht widerspiegelt, die in einem anderen Tab oder in einer anderen kürzlichen Session ausgeführt wurden.

Stichwörter: aktualisieren, neu laden, refresh, log, manuell

Kopiert das Ergebnis einer protokollierten Query in die Zwischenablage.

Wo es zu finden ist: Query-Log › Rechtsklick › Ergebnis kopieren

Öffne das Kontextmenü eines beliebigen Eintrags im Query-Log — Rechtsklick unter macOS, gedrückt halten auf dem iPad — und wähl Ergebnis kopieren. Das Ergebnis (Text der Antwort oder Fehlermeldung) wird in die Zwischenablage kopiert, ohne die Query erneut ausführen zu müssen.

Stichwörter: kopieren, Ergebnis, Zwischenablage, clipboard, log

Löscht dauerhaft alle Einträge des SQLite-Logs.

Wo es zu finden ist: Query-Log › Leeren

Das persistente Log wird in einer lokalen SQLite-Datenbank (query_log.db) im Support-Verzeichnis der App gespeichert. Um alles zu löschen, nutz einen dieser beiden Wege:

- Roter Button "Leeren" in der oberen Filterleiste.
- Button "Leeren" in der Dateiinfo-Leiste am unteren Rand der Ansicht.

In beiden Fällen zeigt Calíope vor dem Löschen einen Bestätigungsdialog. Der Vorgang löscht alle Zeilen der Tabelle executedqueries; er betrifft weder den Session-Verlauf (der im Speicher liegt) noch das DDL-Audit-Log.

Diese Aktion kann nicht rückgängig gemacht werden.

Stichwörter: leeren, bereinigen, löschen, entfernen, clear, purge, log, sqlite

Sieh nach, wo die Datei query_log.db liegt und wie viel Platz sie belegt.

Wo es zu finden ist: Query-Log › Dateileiste (Fußzeile)

Die untere Leiste des persistenten Logs zeigt jederzeit:

- Vollständiger Pfad der Datei query_log.db (Support-Verzeichnis der App).
- Größe in B, KB, MB oder GB je nach Bedarf, aktualisiert bei jedem Neuladen des Logs.

Unter macOS — klick auf Im Finder zeigen, um den Finder mit ausgewählter Datei zu öffnen. Von dort kannst du ein manuelles Backup erstellen oder sie verschieben.

Auf dem iPad — tipp auf Pfad kopieren, um den Pfad in die Zwischenablage zu kopieren.

Der übliche Pfad unter macOS ist:
~/Library/Application Support/Caliope/query_log.db

Stichwörter: Pfad, path, Größe, size, finder, query_log.db, Datei, Speicherort, mb, gb

Teilt den Query-Verlauf zwischen Mac, iPad und iPhone über iCloud.

Wo es zu finden ist: Query-Log › iCloud-Synchronisierungs-Schaltfläche

Das Wolkensymbol oben rechts im Query-Log steuert die Synchronisierung mit iCloud CloudKit. Die Funktion ist standardmäßig deaktiviert und völlig optional.

Die Synchronisierung aktivieren

Tipp auf das Wolkensymbol (grauer Umriss), um sie zu aktivieren. Calíope fragt dich:
- Bestehenden Verlauf hochladen — lädt alle aktuellen lokalen Einträge zu iCloud hoch.
- Nur neue Einträge — beginnt ab jetzt zu synchronisieren, ohne den vorherigen Verlauf hochzuladen.

Ab diesem Moment wird jede ausgeführte Query gleichzeitig in der lokalen Datenbank und in iCloud gespeichert. Das Ergebnisfeld wird mit maximal 500 Zeichen gespeichert.

Die Synchronisierung deaktivieren

Tipp auf das gefüllte Wolkensymbol (blau), um sie zu deaktivieren. Calíope fragt dich:
- Verlauf von iCloud herunterladen — lädt alle Einträge aus iCloud auf das aktuelle Gerät herunter.
- Nein, nur deaktivieren — deaktiviert den Sync, ohne die lokalen Daten anzurühren.

Statusanzeigen

Aufbewahrung

Dieselbe für das lokale Log konfigurierte Aufbewahrungsrichtlinie (standardmäßig 90 Tage) wird einmal täglich automatisch auf die Datensätze in iCloud angewendet. So behalten beide Speicher denselben Zeithorizont.

Datenschutz

Die Daten werden in deinem persönlichen iCloud-Account (private CloudKit-Datenbank) gespeichert, unsichtbar für andere Nutzer und für Apple.

Stichwörter: icloud, sync, synchronisieren, cloudkit, Wolke, Verlauf, teilen, ipad, mac

Was zu tun ist, wenn das Wolkensymbol rot erscheint.

Wo es zu finden ist: Query-Log › Rote Wolken-Schaltfläche

Wenn das Synchronisierungssymbol rot durchgestrichen erscheint, tipp darauf, um das Detail des Fehlers und die verfügbaren Optionen zu sehen:

- Erneut versuchen — versucht die Synchronisierung erneut. Nutz es, wenn der Fehler vorübergehend war (kein Netz, iCloud ausgefallen).
- Sync deaktivieren — deaktiviert die Synchronisierung, ohne Daten herunterzuladen. Der lokale Verlauf wird nicht verändert.

Häufige Ursachen und Lösungen:

Hinweis: Der Status des iCloud-Accounts wird beim Öffnen der App automatisch überprüft. Wird das Problem behoben (z. B. du verbindest dich mit dem Internet), wird das Symbol nach dem Ausführen der nächsten Query wieder blau.

Stichwörter: error, icloud, sync, rot, erneut versuchen, nicht verfügbar, Account, beheben

Calíope sendet eine Benachrichtigung, wenn die iCloud-Synchronisierung des Logs stillschweigend fehlschlägt.

Wo es zu finden ist: Calíope › Einstellungen › Benachrichtigungen

Wenn die iCloud-Synchronisierung des Query-Verlaufs fehlschlägt (keine Verbindung, Kontingent voll, Account nicht verfügbar), kann Calíope dich mit einer lokalen Benachrichtigung warnen, damit du nicht unbemerkt Einträge verlierst.

Abgedeckte Szenarien:
- Keine Internetverbindung zum Zeitpunkt der Synchronisierung.
- iCloud-Kontingent erschöpft — die Benachrichtigung verwendet eine spezifische Meldung, die angibt, dass der Speicher voll ist.
- iCloud-Account vorübergehend nicht verfügbar.

Aktivieren oder deaktivieren:
Geh zu Einstellungen › Benachrichtigungen und nutz den Schalter iCloud-Synchronisationsfehler. Dieser Schalter erscheint nur, wenn die iCloud-Synchronisierung des Logs in den Einstellungen aktiviert ist.

Das Cooldown zwischen Benachrichtigungen beträgt 15 Minuten, um Spam zu vermeiden (der Sync wird bei jeder ausgeführten Query geprüft).

Stichwörter: Benachrichtigung, icloud, sync, Fehler, Kontingent, keine Verbindung, Warnung