Log delle query

Cronologia completa delle query eseguite con tempo e stato.

Dove si trova: Workspace › Strumenti › Log SQL

Apri il Log delle query dalla barra di navigazione del workspace. Mostra tutte le query della sessione corrente e quelle storiche con il loro ID di sessione, timestamp, tempo di esecuzione e stato (OK/Errore).

Parole chiave: log, cronologia, query, registro, query log

Mostra solo le query di una sessione specifica.

Dove si trova: Log delle query › Selettore di sessione

Il selettore Sessione nella barra del Log permette di filtrare per sessione di connessione. Ogni volta che ti connetti al server viene generato un ID di sessione univoco. Scegli Tutte le sessioni per vedere la cronologia completa o seleziona una sessione specifica.

Parole chiave: sessione, filtrare, session, ID, filtro

Filtra le voci del log per testo della query.

Dove si trova: Log delle query › Ricerca

Digita almeno 2 caratteri nel campo di ricerca della barra del Log. Il filtro è cumulativo con il filtro di sessione: applica entrambi simultaneamente.

Parole chiave: cercare, search, filtrare, testo, query

Mostra solo le query di un profilo di connessione specifico.

Dove si trova: Log delle query › Selettore di connessione

Il secondo selettore nella barra del Log filtra le voci per profilo di connessione. Scegli il nome del server o profilo nel menu a discesa per vedere solo le query eseguite in quel contesto. Seleziona Tutte le connessioni per vedere la cronologia completa.

Parole chiave: connessione, filtrare, profilo, server, filtro connessione

Mostra solo le query riuscite o solo quelle che hanno generato un errore.

Dove si trova: Log delle query › Selettore OK / Errore

Il terzo selettore nella barra del Log filtra per stato di esecuzione: Tutti, OK (solo query riuscite) o Errore (solo quelle non riuscite). Combinalo con il filtro di sessione e con la ricerca testuale per restringere rapidamente le voci rilevanti.

Parole chiave: errore, ok, stato, filtrare risultato, successo, fallimento

Ricarica le voci del log dall'archivio locale.

Dove si trova: Log delle query › Pulsante di ricarica

Premi il pulsante di ricarica (icona a forma di freccia circolare) nella barra del Log per forzare un aggiornamento manuale. Utile quando il log non riflette query eseguite in un altro tab o in un'altra sessione recente.

Parole chiave: aggiornare, ricaricare, refresh, log, manuale

Copia il risultato di una query registrata negli appunti.

Dove si trova: Log delle query › clic destro › Copia risultato

Apri il menu contestuale di una qualsiasi voce del Log delle query — clic destro su macOS, tocca e tieni premuto su iPad — e seleziona Copia risultato. Il risultato (testo della risposta o messaggio di errore) viene copiato negli appunti senza dover rieseguire la query.

Parole chiave: copiare, risultato, appunti, clipboard, log

Elimina permanentemente tutte le voci del log SQLite.

Dove si trova: Log delle query › Elimina / Svuota

Il log persistente è memorizzato in un database SQLite locale (query_log.db) nella directory di supporto dell'applicazione. Per eliminarlo tutto, usa una di queste due vie:

- Pulsante rosso "Svuota" nella barra dei filtri superiore.
- Pulsante "Elimina" nella barra di informazioni del file, nella parte inferiore della vista.

In entrambi i casi Calíope mostra una finestra di conferma prima di cancellare. L'operazione elimina tutte le righe della tabella executedqueries; non riguarda la cronologia di sessione (che è in memoria) né il log di audit DDL.

Questa azione non può essere annullata.

Parole chiave: svuotare, eliminare, cancellare, rimuovere, clear, purge, log, sqlite

Consulta la posizione del file query_log.db e quanto spazio occupa.

Dove si trova: Log delle query › Barra del file (piè di pagina)

La barra inferiore del Log persistente mostra, in ogni momento:

- Percorso completo del file query_log.db (directory di supporto dell'app).
- Dimensione in B, KB, MB o GB a seconda del caso, aggiornata ogni volta che il log viene ricaricato.

Su macOS — premi Mostra nel Finder per aprire il Finder con il file selezionato. Da lì puoi fare una copia di sicurezza manuale o spostarlo.

Su iPad — premi Copia percorso per copiare il percorso negli appunti.

Il percorso abituale su macOS è:
~/Library/Application Support/Caliope/query_log.db

Parole chiave: percorso, path, dimensione, size, finder, query_log.db, file, posizione, mb, gb

Condividi la cronologia delle query tra Mac, iPad e iPhone tramite iCloud.

Dove si trova: Log delle query › Pulsante di sincronizzazione iCloud

L'icona a forma di nuvola nell'angolo in alto a destra del Log delle query controlla la sincronizzazione con iCloud CloudKit. La funzione è disattivata per impostazione predefinita ed è del tutto opzionale.

Attivare la sincronizzazione

Premi l'icona a forma di nuvola (contorno grigio) per attivarla. Calíope ti chiederà:
- Carica la cronologia esistente — carica su iCloud tutte le voci locali attuali.
- Solo nuove voci — inizia a sincronizzare da adesso senza caricare la cronologia precedente.

Da quel momento, ogni query eseguita viene salvata simultaneamente nel database locale e su iCloud. Il campo del risultato viene memorizzato con un massimo di 500 caratteri.

Disattivare la sincronizzazione

Premi l'icona a forma di nuvola piena (blu) per disattivarla. Calíope ti chiederà:
- Scarica la cronologia da iCloud — scarica tutte le voci da iCloud sul dispositivo corrente.
- No, solo disattiva — disattiva il sync senza toccare i dati locali.

Indicatori di stato

Conservazione

La stessa politica di conservazione configurata per il log locale (90 giorni per impostazione predefinita) si applica automaticamente ai record su iCloud una volta al giorno. Così entrambi gli archivi mantengono lo stesso orizzonte temporale.

Privacy

I dati vengono salvati nel tuo account iCloud personale (database privato di CloudKit), invisibile ad altri utenti e ad Apple.

Parole chiave: icloud, sync, sincronizzare, cloudkit, nuvola, cronologia, condividere, ipad, mac

Cosa fare quando l'icona della nuvola appare in rosso.

Dove si trova: Log delle query › Pulsante nuvola rosso

Quando l'icona di sincronizzazione appare barrata in rosso, premi su di essa per vedere il dettaglio dell'errore e le opzioni disponibili:

- Riprova — prova di nuovo la sincronizzazione. Usalo se l'errore è stato temporaneo (rete assente, iCloud non raggiungibile).
- Disattiva sync — disattiva la sincronizzazione senza scaricare dati. La cronologia locale non viene modificata.

Cause frequenti e soluzioni:

Nota: Lo stato dell'account iCloud viene verificato automaticamente all'apertura dell'app. Se il problema si risolve (ad es. ti connetti a internet), l'icona torna blu dopo l'esecuzione della query successiva.

Parole chiave: errore, icloud, sync, rosso, riprovare, non disponibile, account, risolvere

Calíope invia una notifica quando la sincronizzazione iCloud del log fallisce silenziosamente.

Dove si trova: Calíope › Preferenze › Notifiche

Se la sincronizzazione iCloud della cronologia delle query fallisce (rete assente, quota piena, account non disponibile), Calíope può avvisarti con una notifica locale in modo che tu non perda record senza saperlo.

Scenari coperti:
- Nessuna connessione a Internet al momento della sincronizzazione.
- Quota di iCloud esaurita — la notifica usa un messaggio specifico che indica che l'archivio è pieno.
- Account iCloud temporaneamente non disponibile.

Attivare o disattivare:
Vai in Preferenze › Notifiche e usa il toggle Errore di sincronizzazione iCloud. Questo toggle appare solo se la sincronizzazione iCloud del log è abilitata in Preferenze.

Il cooldown tra le notifiche è di 15 minuti per evitare spam (il sync viene verificato a ogni query eseguita).

Parole chiave: notifica, icloud, sync, errore, quota, rete assente, avviso