Questa pagina descrive Calíope 1.8, la versione che sto costruendo adesso. La 1.7 è 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.
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.
Su Apple Vision Pro la barra ha anche Apri nello spazio, che dispone il diagramma nella stanza, intorno a te.
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
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
Disegna una nuova relazione di chiave esterna tra due tabelle.
Dove si trova: Diagramma ER › menu contestuale › 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
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.
Apple Vision Pro: il diagramma nello spazio ha una disposizione propria. Salva layout nel pannello dello spazio salva quella, anch’essa per database e solo su questo dispositivo; il pulsante nella barra degli strumenti salva questa.
Parole chiave: layout, posizione, salvare, rendere persistente, nodi, disposizione
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
Consulta la struttura completa di una tabella direttamente nel diagramma.
Dove si trova: Diagramma ER › menu contestuale › 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 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
Su Apple Vision Pro le tabelle diventano schede intorno a te e le chiavi esterne linee tra loro.
Dove si trova: Diagramma ER › Apri nello spazio
Su Apple Vision Pro, Apri nello spazio nella barra del Diagramma ER dispone il diagramma nella stanza, intorno a te, con la finestra di Calíope sempre visibile. Ogni tabella diventa una scheda con il suo nome, il suo database e le sue colonne, ognuna con la sua chiave e il suo tipo, e ogni chiave esterna una linea dalla sua colonna su una scheda alla sua colonna sull’altra. Finché lo spazio è aperto, lo stesso pulsante dice Chiudi lo spazio.
Livelli — ogni database (ogni schema) ha il suo arco intorno a te, con il nome sopra. Un database aggiunto con + DB è un secondo arco dietro il primo, e la linea tra i due passa dall’uno all’altro.
Con la mano — pizzica una scheda e muovila per farla scorrere lungo il suo arco; le sue linee la seguono. Tocca una scheda per selezionarla: le sue linee diventano ambra, le altre si attenuano, e accanto un pannello elenca le sue relazioni e offre Mostra il DDL, che mostra il suo CREATE TABLE in sola lettura. Chiudi, o toccare di nuovo la scheda, la rilascia.
Senza gesti — il pannello davanti a te, sotto l’altezza degli occhi, fa tutto quello che fa la mano: Chiudi lo spazio; Riordina, che rimette ogni scheda dove la colloca il diagramma nella finestra, chiedendo prima se ci sono spostamenti non salvati; Salva layout; un interruttore per livello in Livelli, che nasconde le sue schede e le loro linee; e l’elenco Tabelle, con un filtro. Toccare una riga equivale a toccare la sua scheda, e il suo menu ha Porta in primo piano, che porta la scheda proprio davanti a te, e Sposta nel livello…, che cambia l’arco su cui sta, non il suo database.
Salvare — Salva layout in quel pannello conserva la disposizione 3D, una per database e solo su questo dispositivo: non si sincronizza. Lo spazio si apre con essa la volta successiva, e una tabella senza posto salvato parte da dove la mette il diagramma nella finestra.
Lo spazio legge soltanto. Niente al suo interno modifica il server: le chiavi esterne si creano sempre nel diagramma della finestra, con Nuova relazione FK….
Lo spazio appartiene alla sua sessione. Se la sessione si disconnette o si chiude, anche lo spazio si chiude e la finestra lo dice. C’è un solo spazio alla volta: aprirlo da un’altra sessione chiude il primo.
Con VoiceOver ogni scheda dice la sua tabella, il suo database, quante colonne e relazioni ha e poi ogni relazione; con una scheda selezionata, quelle collegate a essa lo dicono. Ogni colonna si legge con il suo tipo completo e la sua chiave. Le schede e i pannelli crescono con la dimensione del testo.
Parole chiave: Apple Vision Pro, visionOS, spazio, immersivo, 3D, schede, livelli, diagramma ER, spaziale
Quante tabelle lo spazio mostra con le loro linee, quanto ci mette e quanti database ci stanno.
Dove si trova: Diagramma ER › Apri nello spazio
Linee — oltre 200 tabelle lo spazio si apre con tutte le schede ma senza linee, perché resti leggibile e si costruisca in fretta. Seleziona una scheda, con la mano o nell’elenco del pannello, e compaiono le sue linee. Il pannello lo dice finché vale.
Molte tabelle — le schede di un livello si impilano in file perché nessuna ne copra un’altra, anche con una dimensione del testo grande. Mentre lo spazio si costruisce, la finestra e il pannello dicono quante tabelle si stanno caricando e da quanto.
Quanto ci mette — misurato con 120 tabelle e 160 chiavi esterne: le schede e le linee sono al loro posto in circa tre secondi, e l’app usa circa 150 MB di memoria in più.
Al massimo due database, come nella finestra: il principale e quello aggiunto con + DB, ognuno nel suo livello.
Parole chiave: Apple Vision Pro, spazio, limiti, tabelle, linee, prestazioni, memoria, due 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