Questa pagina descrive Calíope 1.5, la versione che stiamo costruendo adesso. La 1.4 è finita ed è in revisione sull'App Store, e il negozio serve oggi la 1.3 sul Mac e la 1.2 su iPad. 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.

Editor SQLite

Editor SQLite

Apri e modifica file SQLite locali senza server.

Dove si trova: Workspace › Strumenti › Editor SQLite

L'Editor SQLite è uno strumento autonomo per file locali .sqlite/.db, in stile DB Browser for SQLite. Ha quattro sezioni: Struttura, Dati, Esegui SQL e Pragmas, e funziona anche senza connessione a un server.

Calíope apre database SQLite non cifrati (SQLCipher non è supportato).

Parole chiave: sqlite, db, locale, database, file

Aprire o creare un database

Apri un file SQLite esistente o creane uno nuovo.

Dove si trova: Archivo

Usa Apri… per scegliere un file .sqlite/.db esistente, o Nuovo database… per crearne uno vuoto. I file recenti appaiono nella schermata iniziale. Un contrassegno Sola lettura appare quando un file non può essere modificato.

Parole chiave: aprire, creare, nuovo, recenti, file

Esplorare e progettare la struttura

Sfoglia tabelle, viste, indici e trigger e creali.

La sezione Struttura mostra l'albero dello schema con le colonne e il DDL di ogni oggetto. Usa Nuovo per creare tabelle, indici o viste, Aggiungi colonna o Rinomina tabella sulla tabella selezionata, ed Elimina per eliminare un oggetto.

Parole chiave: struttura, tabella, indice, vista, trigger, creare, ddl, schema

Sfogliare e modificare i dati

Visualizza, filtra, ordina e modifica le righe.

La sezione Dati mostra le righe di una tabella pagina per pagina, con il contatore e le frecce a destra nella barra. Ordina premendo l'intestazione di una colonna —premila di nuovo per invertire l'ordine—, restringi colonna per colonna con Filtri, oppure scrivi nel campo di ricerca per cercare in tutte insieme; in entrambi i casi il filtro si applica premendo Invio. Il selettore Tabella elenca le tabelle del file, e non tutte si modificano: su una tabella WITHOUT ROWID, o su una qualsiasi se il file è stato aperto in sola lettura, la barra dice che l'oggetto non può essere modificato invece di offrire i pulsanti.

Modificare una cella

macOS: doppio clic su di essa. iPad: un solo tocco.

Il valore si scrive nella griglia stessa. Invio conferma, e uscire dalla cella —toccarne un'altra, o perdere il focus— conferma anch'esso; Esc annulla e lascia il valore precedente (su iPad, con una tastiera collegata).

L'editor avanzato

Ciò che non sta in una riga si scrive in un foglio a parte. Si apre con il pulsante della cella —macOS: al passaggio del puntatore; iPad: nelle celle della riga selezionata, che si marca toccandone il numero— oppure con Editor avanzato… nel menu contestuale (clic destro su macOS, tenere premuto su iPad). Lì lo stesso valore si scrive come testo, come JSON —con un pulsante che lo formatta, e senza lasciar applicare un JSON non valido—, in esadecimale, o si vede come immagine quando i byte lo sono —e quell'immagine si avvicina, dal 100 % all'800 %, con il pizzico, con la rotella o con i pulsanti in basso—; e quei byte si importano da un file e si esportano in un altro. Una cella che contiene già dati binari apre direttamente questo foglio, senza passare dal campo della griglia.

Lasciare una cella a NULL

Nel menu contestuale della cella, Imposta a NULL, senza aprire altro; dentro l'editor avanzato c'è anche come interruttore. Una cella senza valore si disegna come NULL in corsivo. Attenzione: cancellare il contenuto nella griglia e confermare scrive la stringa vuota, che non è la stessa cosa di NULL.

Aggiungere ed eliminare righe

Aggiungi riga apre un modulo con una riga per colonna, il suo tipo e se è obbligatoria. Le colonne che la tabella sa riempire da sola —quelle che dichiarano un valore predefinito e la chiave primaria INTEGER— nascono spuntate perché le scriva il motore: togli la spunta se preferisci mettere il valore tu. Un campo lasciato vuoto viene salvato come NULL, e Inserisci resta disattivato finché una colonna obbligatoria non ha valore —l'avviso accanto dice quale—. Alla conferma viene emessa una sola istruzione INSERT, che nomina solo le colonne con valore. Per eliminare, seleziona la riga dal suo numero e usa Elimina riga, o il menu contestuale di una qualsiasi delle sue celle.

Niente di tutto questo tocca il file finché non premi Salva modifiche: ciò che modifichi resta in una transazione in sospeso che Ripristina modifiche annulla per intero.

Parole chiave: dati, righe, modificare, filtrare, ordinare, cercare, cella, blob, null, inserire, nuova riga, eliminare, json, hex, immagine

Salvare e ripristinare le modifiche

Le modifiche restano in sospeso finché non le salvi.

Le modifiche sono raggruppate in una transazione in sospeso. Un punto ambra indica modifiche non salvate. Usa Salva modifiche per confermare o Ripristina modifiche per annullarle. La chiusura con modifiche in sospeso richiede conferma.

Parole chiave: salvare, ripristinare, confermare, transazione, modifiche

Importare ed esportare

Importa CSV ed esporta in CSV, JSON o SQL.

Da Importa / Esporta puoi importare un file CSV in una nuova tabella, esportare una tabella in CSV o JSON, o esportare l'intero database in un dump SQL (schema e dati).

Parole chiave: importare, esportare, csv, json, sql, dump, backup