Questa pagina descrive Calíope 1.7, la versione che sto costruendo adesso. La 1.6 è 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.

Diagramma ER

Generare il Diagramma ER

Visualizza le relazioni tra le tabelle di un database.

Dove si trova: Workspace › Strumenti › Diagramma ER

Apri il Diagramma ER dalla barra di navigazione del workspace. Seleziona il database nel selettore in alto e Calíope caricherà le tabelle con le loro colonne e le relazioni di chiave esterna esistenti.

Il diagramma mostra le tabelle come nodi con colonne e tipo di dato. Le linee tra le tabelle rappresentano le FK rilevate sul server.

SQL Server

In SQL Server ogni schema è una voce del selettore (demo.dbo, demo.rrhh). Per vedere una chiave esterna che passa da uno schema all'altro, aggiungi l'altro con + DB: la linea tra i due è disegnata in ambra, come tra due database.

Parole chiave: ER, entità-relazione, diagramma, FK, foreign key, relazioni

Navigare il diagramma (zoom e pan)

Ingrandisci, rimpicciolisci e sposta la vista del diagramma.

Dove si trova: Diagramma ER › Canvas

Ingrandire e ridurre — su macOS, la rotella del mouse, un pizzico a due dita sul trackpad o i pulsanti della barra; su iPad, il pizzico o quegli stessi pulsanti. Tra il − e il + della barra c'è la percentuale, che dice a quale scala sei, e le scorciatoie sono ⌘−, ⌘+ e ⌘0. I limiti sono gli stessi ovunque: dal 18 % al 400 %, e il pulsante si spegne quando arrivi al limite.

Spostare il canvas — trascina su una zona vuota, ovunque. Su un nodo, il trascinamento sposta la tabella.

Tornare all'inquadratura — il pulsante Adatta alla finestra (⌘0) inquadra tutte le tabelle. Il diagramma si reinquadra anche da solo all'apertura e quando cambia la dimensione della finestra.

Il pulsante Disposizione automatica riorganizza i nodi per minimizzare le sovrapposizioni.

Apple Vision Pro: come sull'iPad, con i suoi gesti: pizzicare e muovere per scorrere o spostare una tabella, e pizzicare con due mani per lo zoom. I pulsanti e le scorciatoie sono gli stessi.

Parole chiave: zoom, pan, spostare, avvicinare, allontanare, canvas

Creare una relazione FK nel diagramma

Disegna una nuova relazione di chiave esterna tra due tabelle.

Dove si trova: Diagramma ER › clic destro › Crea relazione FK

Apri il menu contestuale di una tabella — clic destro su macOS, tocca e tieni premuto su iPad — e seleziona Nuova relazione FK…. Si apre una finestra di dialogo per scegliere la tabella e la colonna di origine, e la tabella e la colonna di destinazione. Alla conferma, Calíope esegue l'ALTER TABLE … ADD FOREIGN KEY sul server.

Solo su macOS, inoltre: tieni premuto ⌃ (Control) e trascina da una tabella a quella di destinazione; durante il gesto viene disegnata una linea elastica e al rilascio si apre la stessa finestra di dialogo. Su iPad il gesto non esiste, e la chiave esterna si crea dal menu contestuale.

Apple Vision Pro: guarda la tabella e pizzica senza lasciare, dove sull'iPad la terresti premuta; il trascinamento con ⌃ è solo del Mac.

Parole chiave: FK, foreign key, creare relazione, ALTER TABLE, chiave esterna

Salvare il layout del diagramma

Conserva la disposizione che hai dato al diagramma, una per database.

Dove si trova: Diagramma ER › Salva layout

Premi Salva layout nella barra degli strumenti del Diagramma ER. Dove hai trascinato ogni tabella viene salvato per database, così ogni diagramma conserva la sua.

La prossima volta che apri il diagramma di quel database, le tabelle tornano dove le hai lasciate. Una tabella senza posizione salvata — quelle di un secondo database che hai appena aggiunto con + DB, o una creata da allora — viene disposta su una griglia accanto alle altre, mai sopra.

Parole chiave: layout, posizione, salvare, rendere persistente, nodi, disposizione

Esportare il diagramma ER

Salva il diagramma come immagine PNG o come PDF.

Dove si trova: Diagramma ER › Esporta

Nella barra degli strumenti del Diagramma ER, il pulsante Esporta offre due formati: PNG (un'immagine, pronta da incollare in un documento o in una chat) e PDF (pronto per la stampa o la presentazione). Ognuno offre tre dimensioni. Sul Mac scegli dove salvare il file con la finestra di dialogo del sistema; altrove si apre il foglio Condividi, da cui lo salvi in File o lo invii.

Sul Mac gli stessi formati sono anche nel menu contestuale dell'area di lavoro, e il diagramma si può stampare con ⌘P.

Parole chiave: esportare, PNG, PDF, immagine, salvare, stampare, diagramma

Vedere il DDL dal diagramma

Consulta la struttura completa di una tabella direttamente nel diagramma.

Dove si trova: Diagramma ER › clic destro › Modifica struttura della tabella

Apri il menu contestuale di un nodo di tabella nel diagramma — clic destro su macOS, tocca e tieni premuto su iPad — e seleziona Modifica struttura della tabella. Si apre un pannello con il CREATE TABLE completo della tabella selezionata.

Parole chiave: DDL, CREATE TABLE, struttura, vedere tabella, show create

Il diagramma ER con VoiceOver

Il canvas è un disegno: VoiceOver lo legge come un elenco di tabelle con colonne, tipi e chiavi, e di relazioni.

Dove si trova: Workspace › Strumenti › Diagramma ER

Il canvas del diagramma è un disegno che VoiceOver non può leggere, quindi Calíope lo offre come elenco. La sezione Tabelle ha una riga per tabella, con le sue colonne, i loro tipi e se ognuna fa parte della chiave primaria (PK) o di una chiave esterna dichiarata (FK). Se ci sono relazioni, la sezione Relazioni legge ciascuna come «origine → destinazione», con database, tabella e colonna.

Funziona allo stesso modo su tutte le piattaforme.

Parole chiave: VoiceOver, accessibilità, diagramma ER, tabelle, relazioni

ERD multi-database: visualizzare relazioni cross-database

Aggiungi un secondo database al canvas del diagramma ER per visualizzare relazioni tra database.

Dove si trova: Diagramma ER › + DB

Il Diagramma ER può mostrare tabelle di due database contemporaneamente sullo stesso canvas, incluse le chiavi esterne che passano da un database all'altro.

Come aggiungere un secondo database:
1. Con il Diagramma ER aperto, seleziona il DB principale nel selettore a sinistra della barra degli strumenti.
2. Premi il pulsante + DB nella barra degli strumenti per aggiungere un secondo database.
3. Seleziona il secondo DB nel nuovo selettore che appare.
4. Il canvas si aggiorna automaticamente mostrando le tabelle di entrambi i database.

Codifica dei colori:
- Intestazione blu — tabelle del DB principale.
- Intestazione verde acqua (teal) — tabelle del secondo DB.
- Frecce arancioni — relazioni di chiave esterna che passano da un database all'altro.
- Frecce normali — relazioni all'interno dello stesso database.

Requisito per le relazioni cross-database:
Le chiavi esterne devono essere dichiarate sul server: il diagramma le legge dal catalogo del motore. Se le relazioni tra database non appaiono, verifica che le FK esistano formalmente (non siano solo convenzioni di denominazione).

Navigazione ed esportazione:
Tutte le funzioni del diagramma ER normale si applicano al canvas multi-database: zoom, pan, auto-layout, salvare il layout, esportare PNG/PDF e visualizzare il DDL delle tabelle. Consulta gli argomenti Diagramma ER per maggiori dettagli.

Disponibile su macOS, iPad, iPhone e Apple Vision Pro.

Parole chiave: erd, multi, cross-database, relazioni, secondo database, foreign key, diagramma, multi-database, intestazione blu, intestazione teal, frecce arancioni