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.
Carica dati da un file CSV, JSON o Excel (.xlsx) direttamente in una tabella usando l'assistente di importazione in tre passaggi.
Dove si trova: Albero dello schema › clic destro › Importa dati…
L'assistente di Importazione dati inserisce righe in una tabella a partire da un file, senza scrivere SQL.
Come aprirlo: nell'albero dello schema, apri il menu contestuale di una tabella e scegli Importa dati…. Quella tabella diventa la destinazione.
Passo 1 — Il file
- Premi Scegli file e scegli un .csv, .json o .xlsx.
- CSV — separato da virgole, con le virgolette della RFC 4180: un campo tra virgolette può contenere virgole e a capo. La prima riga contiene i nomi delle colonne.
- JSON — un array di oggetti ([{"col": valore}, …]); le chiavi sono i nomi delle colonne.
- Excel (.xlsx) — si legge il primo foglio, e la sua prima riga contiene i nomi delle colonne.
Passo 2 — Colonne: ogni colonna del file si assegna a una colonna della tabella, o si ignora (vedi Mappare le colonne nell'importazione). Se la prima riga di un CSV o di un foglio non contiene nomi, disattiva La prima riga è l'intestazione: le colonne vengono numerate e quella riga si importa con le altre.
Passo 3 — Importare
- Se il server ammette più di un modo di trattare i duplicati, scegli la modalità (vedi Modalità di importazione). Se ne ammette uno solo, non c'è niente da scegliere e il selettore non compare.
- Scegli la dimensione del lotto: 100, 500 —quella di fabbrica— o 1000 righe per istruzione.
- Premi Importa. Una barra mostra l'avanzamento lotto per lotto, e alla fine vedi quante righe sono entrate e gli errori, se ce ne sono.
Disponibile su macOS, iPad, iPhone e Apple Vision Pro.
Come assegnare le colonne del file di origine alle colonne della tabella di destinazione nel passo 2 dell'assistente di importazione.
Dove si trova: Albero dello schema › clic destro › Importa dati…
Il passo 2 dell'assistente decide in quale colonna della tabella va ogni colonna del file.
- Ogni riga rappresenta una colonna del file; il selettore a destra offre le colonne della tabella di destinazione.
- Le colonne che si chiamano esattamente come una della tabella —maiuscole comprese— arrivano già assegnate. Le altre partono da Ignora: assegnale a mano se serve.
- Ignora lascia fuori quella colonna. Utile quando il file ha più colonne della tabella, o per non importare un identificativo che il server genera da sé.
Prima di importare, controlla che ogni colonna NOT NULL senza valore predefinito abbia una colonna del file assegnata: altrimenti il server rifiuta quelle righe.
Quando una riga urta una chiave primaria o univoca: fallire, saltarla o sostituire quella che c'era. Ciò che si offre dipende dal server.
Dove si trova: Albero dello schema › clic destro › Importa dati…
Nel passo 3 dell'assistente scegli cosa succede quando una riga del file urta una chiave primaria o univoca già esistente. L'assistente offre solo le modalità che il server sa rispettare.
Inserisci (su tutti i server; dove è offerto Salta i duplicati, l'assistente parte da quello): l'istruzione del lotto che urta fallisce, e l'importazione lo dice. Usala quando non dovrebbero esserci duplicati e vuoi saperlo se ce ne sono.
Salta i duplicati: la riga in conflitto si scarta e il resto prosegue. Utile per caricare un file in parte già presente nella tabella.
Sostituisci i duplicati: la riga esistente si elimina ed entra quella del file. Tieni conto che fa scattare i trigger di eliminazione e che le colonne che il file non porta tornano al loro valore predefinito.
MySQLMariaDBAurora
Si offrono tutte e tre.
PostgreSQL
Si offrono Inserisci e Salta i duplicati: non c'è sostituzione.
SQL ServerOracleClickHouse
Solo Inserisci, quindi il selettore non compare.
Disponibile su macOS, iPad, iPhone e Apple Vision Pro.
Parole chiave: insert, insert ignore, replace, duplicati, conflitto, chiave primaria, chiave unica, modalità, importazione, replace into