Questa pagina descrive Calíope 1.5, la versione che sto costruendo adesso. La 1.4 è sull'App Store per Mac, iPad, iPhone, Apple Watch, Apple TV e Apple Vision Pro. Il changelog dice in quale versione è arrivata ogni funzione.
Aggiunge a ogni argomento un pulsante «Apri in Calíope». Funziona solo con l'app installata.
Salva i dati di un server per connetterti rapidamente.
Dove si trova: Pannello laterale › Pulsante + (nuova connessione)
Nel Gestore connessioni, premi + nella barra laterale sinistra. Inserisci un nome descrittivo, la famiglia del server (il protocollo che parla) e il prodotto al suo interno, poi host, porta, utente e password. Il campo "Database predefinito" è opzionale.
Nella sezione Opzioni del server puoi configurare il charset, la collation e attivare SSL/TLS. Se SSL è attivo appariranno campi per selezionare il certificato e la chiave del client.
Parole chiave: profilo, nuova connessione, salva server, host, configurare
Dove si trova: Pannello laterale › Elenco dei profili
Seleziona il profilo nell'elenco della barra laterale. Il modulo a destra si carica con i suoi dati attuali e puoi modificare qualsiasi campo direttamente. Non c'è un pulsante Salva: ogni modifica si salva appena la fai.
Eliminare un profilo ha un tema tutto suo, perché non è reversibile e si porta via più di quanto sembri: vedi Eliminare una connessione.
Parole chiave: modifica profilo, modificare connessione, eliminare profilo
I tre punti da cui si elimina un profilo, che cosa se ne va con lui e perché non è reversibile.
Dove si trova: Pannello laterale › Pulsante − (elimina connessione)
Eliminare una connessione non cancella solo il suo indirizzo e il suo utente: si porta via tutto quello che Calíope aveva salvato di quel server. Per questo chiede prima, e per questo la domanda dice il nome della connessione — se non è quella che credevi, è il momento di accorgertene.
Da dove
- macOS: seleziona il profilo e premi − nella barra sotto l'elenco, accanto al +. Oppure fai clic destro sulla riga e scegli Elimina.
- iPad: seleziona il profilo e tocca − nella barra inferiore; oppure tieni premuta la riga e scegli Elimina; oppure scorri la riga da destra a sinistra. Lo scorrimento non elimina quando lasci: rivela il pulsante, e la domanda arriva lo stesso. Scorrere nell'altro senso — da sinistra a destra — è Sposta nel gruppo.
Che cosa se ne va con lei
- Il profilo, con tutti i suoi dati.
- La sua password nel portachiavi, e anche quella di SSH e la passphrase della sua chiave privata.
- La sua cronologia delle query, e le sue righe nel registro degli errori e in quello dei messaggi del server.
- L'SQL che aveva salvato nell'editor di quella connessione, e la sua cache dello schema.
Non è reversibile. Non c'è cestino né annulla: la conferma è l'unica occasione per tornare indietro.
Sugli altri dispositivi. Con la sincronizzazione iCloud attiva la cancellazione viaggia, e la connessione sparisce anche lì. Al contrario non succede nulla di strano: un profilo creato sull'altra macchina e che questa non ha ancora visto non viene letto come una cancellazione, quindi non sparisce da solo.
Un gruppo intero. Eliminare un gruppo elimina anche le connessioni che contiene, con la stessa domanda e la stessa portata; è spiegato in Organizzare i profili in gruppi.
Come usare l’host alternativo quando l’indirizzo del server dipende dal dispositivo da cui ti colleghi.
Dove si trova: Pannello laterale › Connessioni › Host alternativo
Il campo «Host alternativo» del profilo serve per un server raggiungibile a due indirizzi diversi. Il caso tipico è una macchina di sviluppo: dal computer stesso risponde su 127.0.0.1, mentre dall’iPad occorre usare il suo indirizzo nella rete locale. Poiché i profili si sincronizzano tra i tuoi dispositivi, un solo campo host non può essere corretto in entrambi i posti.
Alla connessione si prova prima l’host principale. Se non risponde, si prova quello alternativo con la stessa porta, lo stesso utente, la stessa password e le stesse opzioni: cambia solo l’indirizzo. Se ti serve anche un’altra porta, scrivi «indirizzo:porta» (per esempio, 10.0.0.20:3307).
Quando la sessione entra dall’indirizzo alternativo, compare un contrassegno accanto al nome del server e «Prova connessione» indica quale indirizzo ha risposto, così sai sempre su quale macchina stai lavorando.
Con un tunnel SSH il campo viene ignorato, ed è voluto: lì l’indirizzo del server lo risolve la macchina del tunnel, non il tuo dispositivo, quindi non cambia a seconda di dove ti colleghi.
Parole chiave: host alternativo, secondo indirizzo, ip locale, rete locale, failover, 127.0.0.1, ipad, due indirizzi
Quando serve scriverla, quali campi Calíope smette di usare in quel caso e dove finisce la password.
Dove si trova: Pannello laterale › Connessioni › Stringa di connessione
Il campo «Stringa di connessione» compare solo quando il motore del profilo è MongoDB, ed è facoltativo. Se lo lasci vuoto, Calíope costruisce la connessione con i campi qui sopra: indirizzo, porta, utente, password, TLS e database. Per un server normale è sufficiente.
Scrivila quando la connessione non si può descrivere con quei campi. I casi sono tre: un replica set, che richiede più indirizzi e il nome dell'insieme; un database di autenticazione diverso da quello abituale, che si indica con authSource; e un cluster Atlas, il cui indirizzo inizia con mongodb+srv:// e non ha una porta da digitare.
Quando la scrivi ha la precedenza sui campi qui sopra: utente, password, TLS e opzioni vengono da lì. Ci sono due eccezioni. Se il profilo usa un tunnel SSH, l'indirizzo lo mette il tunnel e non la stringa, perché il server che la stringa nomina è quello che vede la macchina del tunnel, non il tuo dispositivo. E se la stringa non nomina alcun database si usa quello del profilo, o admin se non c'è nemmeno quello.
Senza stringa l'autenticazione avviene contro admin. È lì che vivono gli account amministrativi ed è ciò che presumono mongosh e Compass quando qualcuno digita soltanto utente e password; se le tue credenziali sono in un altro database, indicalo con authSource.
Un avviso sulla password: quella del campo qui sopra viene salvata nel Portachiavi, una password scritta dentro la stringa no. La stringa viene salvata insieme al resto del profilo e, con la sincronizzazione iCloud attiva, viaggia con lui. Se la cosa ti interessa, lascia la password nel suo campo e usa la stringa solo per il resto.
Se la stringa è scritta male la connessione fallisce dicendolo: è un errore del modulo, quindi si corregge lì e non riprovando.
Parole chiave: stringa di connessione, mongodb, uri, srv, atlas, replica set, authSource, mongodb+srv
Dove si trova: Gestore connessioni › Testa la connessione
Premi Testa la connessione nel modulo del profilo. Calíope prova ad aprire una connessione reale con i dati inseriti e mostra il risultato in un banner verde (successo) o rosso (errore con descrizione).
La prova è particolarmente utile per convalidare credenziali SSL, firewall o configurazioni di host prima di salvare il profilo.
Parole chiave: test, provare, verificare, check connection
Una volta completati i dati del profilo, premi il pulsante Connetti (con icona a forma di fulmine). Calíope apre il pool di connessioni con il driver del motore e carica l'albero degli schemi.
Se la connessione non riesce appare un messaggio di errore nella barra di stato. Controlla l'host, le credenziali e che il server sia attivo e accessibile dalla tua rete.
Parole chiave: connect, connettere, aprire workspace, pool
Cambia il database della sessione dal pannello dello schema.
Dove si trova: Editor SQL › Pannello dello schema › Usa come database attivo
Nel pannello dello schema dell'Editor SQL, fai clic destro su un database e scegli Usa come database attivo. La sessione passa a quello senza riconnettersi — equivale a eseguire USE nome_db — e il menu server mostra il suo nome accanto a quello del server. Il cambio riguarda solo la sessione corrente.
Parole chiave: use database, cambiare db, selezionare database
Disconnette dal server e torna al Gestore connessioni.
Dove si trova: Workspace › Disconnetti
Premi il pulsante Disconnetti nell'intestazione del workspace. Calíope chiude il pool di connessioni e torna alla schermata del Gestore connessioni con un'animazione.
La disconnessione è automatica alla chiusura della finestra principale dell'applicazione.
Parole chiave: disconnettere, chiudere sessione, disconnect, uscire
Si riconnette automaticamente se il server chiude la sessione.
Dove si trova: Pannello laterale › Modulo del profilo › Riconnessione automatica
Nel modulo del profilo di connessione, attiva l'interruttore Riconnessione automatica. Con questa opzione attiva, Calíope proverà a ristabilire la connessione automaticamente se il server la chiude per inattività o per riavvio.
Utile per sessioni lunghe o per server con un breve tempo di attesa della connessione.
Parole chiave: riconnessione, riconnessione automatica, timeout, inattività, ristabilire
Lavora con più server contemporaneamente senza perdere il contesto.
Dove si trova: Workspace › Menu server
Calíope supporta l'apertura di più connessioni a server attive contemporaneamente. Ogni server ha la propria sessione indipendente con il proprio albero degli schemi, i tab SQL aperti, la cronologia delle query e lo stato dell'assistente IA.
Come funziona:
Ogni volta che premi Connetti nel Gestore connessioni, si apre una nuova sessione senza chiudere le precedenti. Tutte le sessioni coesistono e puoi passare dall'una all'altra senza perdere nulla.
Stato di ogni sessione:
- I tab SQL e il loro contenuto si conservano al cambio di server.
- L'albero degli schemi mostra i database del server attivo.
- L'assistente IA mantiene la cronologia della conversazione per sessione.
Puoi aprire tutte le sessioni di cui hai bisogno, ad esempio per confrontare dati tra ambienti di sviluppo, staging e produzione contemporaneamente.
Parole chiave: multi-server, connessioni multiple, simultaneo, varie connessioni, sessioni, multiserver
Passa da un server connesso all'altro dal menu a discesa del workspace.
Dove si trova: Workspace › Menu server
Il menu selettore di server mostra il nome del server attivo e un indicatore di stato della connessione (punto verde = connesso, rosso = errore). Premendolo si apre un menu con tutte le sessioni aperte.
Su macOS: il selettore appare nella barra degli strumenti della finestra, nell'angolo in alto a sinistra. Mostra il nome del server, il database attivo e la freccia a discesa.
Su iPad: il selettore appare a sinistra della barra dei tab, sempre visibile nella parte superiore del workspace.
Opzioni del menu:
- Tocca o fai clic sul nome di qualsiasi server per attivare quella sessione.
- La sessione attiva appare contrassegnata con un ✓.
- Aggiungi server apre il Gestore connessioni sopra il workspace corrente per connettere un altro server senza perdere le sessioni aperte.
- Disconnetti chiude la sessione del server attivo.
Parole chiave: menu server, selettore, cambiare server, switcher, sessione attiva, indicatore connessione
Connettiti a un server aggiuntivo senza abbandonare il lavoro corrente.
Dove si trova: Workspace › Menu server › Aggiungi server
Per aggiungere una nuova connessione mentre stai già lavorando su un altro server:
1. Apri il menu selettore di server (nella barra della finestra su macOS, nella barra dei tab su iPad).
2. Scegli Aggiungi server.
3. Si apre il Gestore connessioni: in una finestra propria su macOS, come foglio su iPad.
4. Seleziona un profilo esistente o creane uno nuovo e premi Connetti.
5. Il Gestore connessioni si chiude da solo e la nuova sessione è disponibile nel selettore.
Le sessioni precedenti rimangono aperte e intatte durante tutto il processo.
Parole chiave: aggiungere server, nuova sessione, seconda connessione, aggiungi server, connettere un altro
Chiude la sessione di un server senza influire sulle altre connessioni attive.
Dove si trova: Workspace › Disconnetti
Quando hai più sessioni aperte, puoi chiuderne una qualsiasi in modo indipendente:
Server attivo:
- Apri il menu selettore di server e premi Disconnetti, oppure usa il pulsante rosso di disconnessione nella barra degli strumenti.
Qualsiasi sessione (per passarci prima):
1. Apri il menu selettore di server.
2. Seleziona il server che vuoi chiudere per attivarlo.
3. Premi Disconnetti.
Alla chiusura di una sessione, Calíope attiva automaticamente l'ultima sessione disponibile. Se era l'unica sessione aperta, torna al Gestore connessioni.
Parole chiave: disconnettere server, chiudere sessione, chiudere connessione, disconnect, rimuovere server
Cifra la connessione al server con certificati SSL.
Dove si trova: Pannello laterale › Modulo del profilo › SSL
Nel modulo del profilo di connessione, attiva l'interruttore SSL nella sezione Opzioni del server. Appaiono tre campi opzionali per i certificati del client:
- Certificato CA — file del certificato dell'Autorità di certificazione (.pem o .crt). Con questo file Calíope verifica l'identità del server.
- Certificato client — file del certificato del client per l'autenticazione reciproca.
- Chiave client — chiave privata corrispondente al certificato del client.
Se attivi SSL senza specificare il certificato CA, Calíope verifica il certificato del server rispetto alle autorità di certificazione del sistema (comportamento predefinito sicuro). Se il server usa un certificato autofirmato, la connessione non riuscirà a meno che tu non fornisca il CA corrispondente.
Accettare il certificato senza verifica (non sicuro): seleziona questa casella solo se ti connetti a un server di sviluppo con certificato autofirmato e non puoi fornire il CA. La connessione rimarrà cifrata ma sarà vulnerabile agli attacchi man-in-the-middle. Non attivarla per server di produzione.
Dove resta il file: quando scegli un CA, un certificato o una chiave client — o lo incolli, su iPad —, Calíope tiene una propria copia su questo dispositivo, mai in iCloud Drive, e il profilo punta a quella copia. Puoi spostare o eliminare l'originale dopo, e sul Mac continua a essere letto dopo il riavvio. Per rinnovare un certificato, sceglilo di nuovo, anche se ha lo stesso nome. Il file resta sul dispositivo dove l'hai scelto, e la sua posizione anche: un profilo configurato su un altro dispositivo arriva senza. Prima di connetterti, l'elenco delle connessioni mostra Scegli i suoi file su questo dispositivo e il modulo dice «Questo profilo usa un certificato scelto su un altro dispositivo: sceglilo qui.»; sceglilo lì, e da allora quel dispositivo tiene la propria copia.
Se un file non si può leggere, Calíope non si connette senza di esso: si ferma con «Impossibile leggere un file TLS», che nomina il file e quale dei tre è.
La connessione SSL viene testata premendo Testa la connessione; il banner verde confermerà se la cifratura è attiva.
Parole chiave: ssl, tls, certificato, cifratura, ca, client, sicurezza, pem, crt, ssl_mode, mitm, verifica, autofirmato
Richiede Touch ID o Face ID prima di connetterti a qualsiasi server.
Dove si trova: Pannello laterale › Preferenze › Generale › Sicurezza
Calíope può chiedere Touch ID (Mac) o Face ID (iPad e iPhone) prima di aprire qualsiasi connessione. È un unico interruttore per tutta l'app, non un'impostazione di ciascun profilo.
Dove si attiva
- Preferenze › Generale › Sicurezza › Richiedi Touch ID per connettersi (o Richiedi Face ID per connettersi), sul Mac come sull'iPad. Compare solo se il dispositivo dispone della biometria.
Con l'interruttore attivo, Connetti chiede prima, e se l'autenticazione non riesce la connessione non procede. Provare un profilo non chiede nulla. Controlla i permessi in Impostazioni di Sistema › Touch ID e password (Mac) o Impostazioni › Face ID e codice (iPad).
Parole chiave: biometria, touch id, face id, autenticazione, sicurezza, impronta, biometric, richiedi biometria
Come raggruppare le tue connessioni (Produzione, Sviluppo, Cliente X, ecc.) e spostare profili tra gruppi su macOS, iPad e iPhone.
Dove si trova: Gestore connessioni › clic destro › Sposta nel gruppo
Quando l'elenco delle connessioni cresce, puoi raggrupparle per ambiente, cliente o qualsiasi altro criterio. I gruppi sono comprimibili e persistono in connections.json come collezioni ordinabili.
Creare un gruppo
- macOS: fai clic destro su un qualsiasi gruppo esistente (o sull'intestazione della barra laterale) e scegli Nuovo gruppo. Viene creato con il nome predefinito Nuovo gruppo ed entra direttamente in modalità di modifica per rinominarlo.
- iPad: dal Gestore connessioni, tocca il menu ⋯ nella barra superiore e scegli Nuovo gruppo, oppure modifica i gruppi dalla scheda Gestisci gruppi.
Rinominare / eliminare
- macOS: fai clic destro sul nome del gruppo → Rinomina gruppo o Elimina gruppo.
- iPad: per rinominare, tocca la matita della riga nella scheda Gestisci gruppi; per eliminare, scorri quella riga da destra a sinistra. Puoi anche tenere premuta l'intestazione del gruppo nell'elenco.
- Eliminare un gruppo elimina anche le connessioni che contiene, con la loro password salvata, la cronologia delle query e l'SQL che avevano salvato. Prima di eliminare qualcosa, Calíope chiede conferma e ti dice quante connessioni se ne vanno e come si chiamano. Non si può annullare: se vuoi solo disfare il raggruppamento, sposta prima i profili con Sposta nel gruppo ▸ Senza gruppo.
Spostare un profilo
- macOS: fai clic destro sul profilo → Sposta nel gruppo ▸ → scegli il gruppo di destinazione o Senza gruppo per toglierlo da qualsiasi raggruppamento.
- iPad: scorri il profilo da sinistra a destra per rivelare l'azione Sposta (icona a forma di cartella, colore indaco); si apre la scheda di selezione del gruppo.
Riordinare i gruppi (iPad)
- Apri Gestisci gruppi e trascina per la maniglia ☰ per riordinare. L'ordine persiste nel campo sortOrder di ogni gruppo.
Espandere/comprimere
- Ogni gruppo ha un ▸ per comprimere/espandere l'elenco dei profili. Lo stato viene salvato per gruppo.
Persistenza
- I gruppi e la loro assegnazione risiedono nel file connections.json sotto il dispositivo corrente. Se hai attivato la sincronizzazione con iCloud, vengono condivisi tra i tuoi dispositivi.
Filtrare
- Il campo sopra l'elenco lascia solo le connessioni che corrispondono; finché contiene del testo, tutti i gruppi vengono disegnati aperti senza cambiare ciò che hai salvato (vedi Filtrare l'elenco delle connessioni).
Parole chiave: gruppo, gruppi, organizzare, cartella, categoria, produzione, sviluppo, spostare profilo, trascinare, swipe, nuovo gruppo, rinominare, eliminare gruppo, senza gruppo, connections.json
Scrivi nel campo sopra l'elenco per lasciare solo le connessioni che corrispondono, per nome, host o gruppo.
Con trenta o quaranta profili, aprire un gruppo non basta più. Il campo in alto nella barra laterale lascia solo le connessioni che corrispondono a quello che scrivi.
Cosa cerca: il nome del profilo, il suo host e il suo host alternativo, il database predefinito, il nome utente, il nome del motore e il nome del suo gruppo. Scrivere il nome di un gruppo lo mostra per intero — è il modo di dire mostrami produzione. Accenti e maiuscole non contano.
Mentre filtri, i gruppi si aprono da soli, anche quelli che avevi compresso, così niente di corrispondente resta nascosto dentro un gruppo chiuso. Quell'apertura non viene salvata: svuota il campo e ogni gruppo torna esattamente come lo avevi lasciato.
La selezione non si muove. Se il profilo che stavi modificando finisce fuori dal filtro, il modulo di destra continua a mostrarlo: perdere quello che stavi modificando per aver scritto in una ricerca sarebbe peggio del problema che la ricerca risolve.
Premi Esc o la × per svuotare il campo. Il filtro non viene ricordato alla chiusura dell'app.
Parole chiave: filtrare, cercare, connessioni, elenco, gruppo, host, trovare profilo
Che cos'è la famiglia, che cos'è il prodotto e come Calíope propone il prodotto che il server dichiara di essere quando provi la connessione.
Dove si trova: Pannello laterale › Gestore connessioni
Calíope raggruppa i server per famiglia, cioè il protocollo che parlano: MySQL / MariaDB, PostgreSQL, SQL Server e MongoDB. Dentro ogni famiglia scegli il prodotto: il nome preciso di quello che hai davanti.
Famiglie e prodotti
- MySQL / MariaDB: MySQL, MariaDB, Amazon Aurora MySQL e «Altro compatibile con MySQL».
- PostgreSQL: PostgreSQL, Amazon Aurora PostgreSQL e «Altro compatibile con PostgreSQL».
- SQL Server: Microsoft SQL Server.
- MongoDB: MongoDB e «Altro compatibile con MongoDB».
Che cosa decide ciascuno. La famiglia decide con quale motore Calíope si connette e quali strumenti vengono offerti. Il prodotto stabilisce il nome, il prompt del terminale e i frammenti precaricati; Aurora MySQL, per esempio, porta i suoi. Un prodotto che non è il riferimento della sua famiglia mostra un avviso nel modulo per ricordarlo; puoi nasconderlo con Non mostrare più.
Creare il profilo
1. In Server (Tipo su iPad e iPhone), scegli la famiglia.
2. In Prodotto, che sul Mac è il menu accanto, scegli il prodotto. Se il tuo non c'è, scegli «Altro compatibile con…».
3. Compila host, porta, utente e password come sempre. Con Aurora, incolla l'endpoint del cluster e attiva SSL/TLS.
Il server dice chi è. Quando premi Testa la connessione o carichi l'elenco dei database, Calíope chiede al server e, se si identifica come un altro prodotto della stessa famiglia, lo propone sotto il selettore: premi Usa … per correggere il profilo, oppure ignoralo. Non lo cambia mai da solo. A MongoDB non viene chiesto.
Nota
Le funzioni proprie di un prodotto (autenticazione IAM di Aurora, endpoint differenziati, metriche aurora_%) non ricevono un trattamento speciale: Calíope gestisce il server come un membro standard della sua famiglia.
SQL Server si connette alla versione 2022 o successiva, sempre cifrato. Un profilo SQL Server sincronizzato su un dispositivo che ha ancora Calíope 1.4 appare lì come MariaDB, perché quella versione non conosce la famiglia; aprirlo lì non funzionerà finché quel dispositivo non si aggiorna.
Parole chiave: famiglia, prodotto, aurora, amazon aurora, aws, rds, mysql, mariadb, postgresql, mongodb, compatibile, protocollo, rilevare, tipo di server
Calíope avvisa quando il tunnel SSH cade e quando si ripristina automaticamente.
Dove si trova: Calíope › Preferenze › Notifiche
Quando un profilo ha Tunnel SSH attivato, Calíope invia notifiche locali in due momenti:
- Caduta del tunnel — al rilevamento di un errore di connessione prima di tentare la riconnessione.
- Riconnessione riuscita — se la riconnessione automatica (opzione Riconnetti automaticamente del profilo) ripristina il tunnel con successo.
Attivare o disattivare:
Vai su Preferenze › Notifiche e usa il toggle Tunnel SSH caduto / riconnesso.
Se la riconnessione automatica fallisce, la notifica di riconnessione non viene inviata; la caduta è già stata notificata. Il cooldown tra le notifiche dello stesso host è di 60 s.
Parole chiave: notifica, ssh, tunnel, caduta, riconnessione, avviso, automatica