Connessioni

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, il tipo di server (MySQL, MariaDB, Aurora, PostgreSQL o MongoDB), l'host, la porta, l'utente e la 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

Modifica i dati di un profilo salvato.

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. Le modifiche si salvano automaticamente quando ti connetti o selezioni un altro profilo.

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.

Parole chiave: eliminare connessione, cancellare profilo, rimuovere server, annullare, cestino, password, portachiavi, scorrere

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

Verifica i dati del server prima di connetterti.

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

Stabilisce la connessione e apre il workspace.

Dove si trova: Gestore connessioni › Connetti

Una volta completati i dati del profilo, premi il pulsante Connetti (con icona a forma di fulmine). Calíope apre il pool di connessioni MySQL/MariaDB tramite MySQLKit 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 contesto di database della sessione dall'Editor SQL.

Dove si trova: Editor SQL › Selettore di database

Usa il selettore di database nella barra dell'Editor SQL per cambiare il contesto attivo senza riconnetterti. Il cambio equivale a eseguire USE nome_db e 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 MySQL contemporaneamente senza perdere il contesto.

Dove si trova: Workspace › Menu server

Calíope supporta l'apertura di più connessioni a server MySQL 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 (angolo in alto a sinistra su macOS, barra dei tab su iPad).
2. Premi Aggiungi server.
3. Si apre il Gestore connessioni come un pannello fluttuante.
4. Seleziona un profilo esistente o creane uno nuovo e premi Connetti.
5. Il pannello si chiude automaticamente 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 MySQL 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.

Su iPad: usa il selettore di file del sistema per scegliere i file di certificato dal tuo archivio locale o da iCloud Drive.

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 un server.

Dove si trova: Pannello laterale › Modulo del profilo › Richiedi biometria

Calíope può proteggere un profilo di connessione con l'autenticazione biometrica. Quando è attiva, l'app richiede Touch ID (macOS / iPad) o Face ID (iPad con Face ID) prima di consentire la connessione.

Attivare su macOS:
- Nel modulo del profilo, attiva Richiedi biometria nella sezione Opzioni del server.
- Puoi anche attivarlo globalmente da Preferenze › Connessioni › Biometria.

Attivare su iPad:
- Nel modulo del profilo, attiva Richiedi biometria nella sezione Opzioni.
- Disponibile anche a livello globale in Preferenze › Generale › Richiedi biometria.

Se il dispositivo non dispone della biometria o i permessi sono revocati, l'autenticazione non riesce e la connessione non procede. Controlla i permessi in Impostazioni di Sistema › Sicurezza e privacy › Touch ID (macOS) 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

Come usare Calíope con cluster Amazon Aurora (edizione compatibile con MySQL) e quali funzioni sono disponibili.

Dove si trova: Pannello laterale › Gestore connessioni

Amazon Aurora (edizione compatibile con MySQL) usa lo stesso protocollo di MySQL, quindi Calíope si connette con lo stesso motore, senza configurazioni particolari.

Creare il profilo
1. In Tipo, scegli Aurora.
2. In Host, incolla l'endpoint del tuo cluster (ad esempio mio-cluster.cluster-xxxx.us-east-1.rds.amazonaws.com): usa l'endpoint di scrittura per il lavoro normale o uno di lettura se devi solo interrogare.
3. Lascia la Porta su 3306.
4. Inserisci utente e password come per qualsiasi server MySQL.

Cosa ottieni
Con Aurora, Calíope offre le stesse funzioni di MySQL: editor SQL, esplora schema, diagrammi ER, backup e monitoraggio. Un avviso nel modulo ricorda che le funzioni disponibili sono quelle compatibili con MySQL; puoi nasconderlo con Non mostrare più.

Sicurezza
Aurora richiede di solito TLS: attiva SSL/TLS nel profilo e, se la tua rete lo richiede, combinalo con un tunnel SSH verso un host all'interno della VPC.

Nota
Le funzioni specifiche di Aurora (autenticazione IAM, endpoint di cluster distinti, metriche aurora_%) non sono gestite in modo speciale: Calíope tratta il cluster come un server MySQL standard.

Parole chiave: aurora, amazon aurora, aws, rds, mysql, compatibile, endpoint, cluster, motore, tipo di server, protocollo mysql

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