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.

Importazione dei dati

Importare dati da CSV, JSON o Excel

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.

Parole chiave: importare, csv, json, excel, xlsx, dati, caricare, wizard, assistente, file, righe, tabella, insert

Mappare le colonne nell'importazione

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.

Parole chiave: mappatura, colonne, assegnazione, ignorare, intestazione, origine, destinazione, importazione, csv, json, xlsx

Modalità di importazione: cosa fare con i duplicati

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