03. Comandi interattivi

Tramite la shell di SQLite è possibile eseguire comandi interattivi.

Per attivare la shell posizionarsi nella cartella SQLite e richiamare il programma sqlite3.

Come regola generale i comandi che iniziano con punto (".") sono interpretati direttamente dalla shell mentre gli altri comandi sono interpretati come comandi SQL. Questi ultimi possono essere suddivisi su più righe ma devono necessariamente terminare con punto e virgola (";").


Elenco dei comandi interattivi

Tramite il comando .help si ottiene la lista dei comandi interpretati dalla shell, di seguito riportati.

sqlite> .help

.archive ... Manage SQL archives

.auth ON|OFF Show authorizer callbacks

.backup ?DB? FILE Backup DB (default "main") to FILE

.bail on|off Stop after hitting an error. Default OFF

.binary on|off Turn binary output on or off. Default OFF

.cd DIRECTORY Change the working directory to DIRECTORY

.changes on|off Show number of rows changed by SQL

.check GLOB Fail if output since .testcase does not match

.clone NEWDB Clone data into NEWDB from the existing database

.databases List names and files of attached databases

.dbconfig ?op? ?val? List or change sqlite3_db_config() options

.dbinfo ?DB? Show status information about the database

.dump ?TABLE? ... Render all database content as SQL

.echo on|off Turn command echo on or off

.eqp on|off|full|... Enable or disable automatic EXPLAIN QUERY PLAN

.excel Display the output of next command in spreadsheet

.exit ?CODE? Exit this program with return-code CODE

.expert EXPERIMENTAL. Suggest indexes for queries

.filectrl CMD ... Run various sqlite3_file_control() operations

.fullschema ?--indent? Show schema and the content of sqlite_stat tables

.headers on|off Turn display of headers on or off

.help ?-all? ?PATTERN? Show help text for PATTERN

.import FILE TABLE Import data from FILE into TABLE

.imposter INDEX TABLE Create imposter table TABLE on index INDEX

.indexes ?TABLE? Show names of indexes

.limit ?LIMIT? ?VAL? Display or change the value of an SQLITE_LIMIT

.lint OPTIONS Report potential schema issues.

.load FILE ?ENTRY? Load an extension library

.log FILE|off Turn logging on or off. FILE can be stderr/stdout

.mode MODE ?TABLE? Set output mode

.nullvalue STRING Use STRING in place of NULL values

.once (-e|-x|FILE) Output for the next SQL command only to FILE

.open ?OPTIONS? ?FILE? Close existing database and reopen FILE

.output ?FILE? Send output to FILE or stdout if FILE is omitted

.parameter CMD ... Manage SQL parameter bindings

.print STRING... Print literal STRING

.progress N Invoke progress handler after every N opcodes

.prompt MAIN CONTINUE Replace the standard prompts

.quit Exit this program

.read FILE Read input from FILE

.recover Recover as much data as possible from corrupt db.

.restore ?DB? FILE Restore content of DB (default "main") from FILE

.save FILE Write in-memory database into FILE

.scanstats on|off Turn sqlite3_stmt_scanstatus() metrics on or off

.schema ?PATTERN? Show the CREATE statements matching PATTERN

.selftest ?OPTIONS? Run tests defined in the SELFTEST table

.separator COL ?ROW? Change the column and row separators

.sha3sum ... Compute a SHA3 hash of database content

.shell CMD ARGS... Run CMD ARGS... in a system shell

.show Show the current values for various settings

.stats ?on|off? Show stats or turn stats on or off

.system CMD ARGS... Run CMD ARGS... in a system shell

.tables ?TABLE? List names of tables matching LIKE pattern TABLE

.testcase NAME Begin redirecting output to 'testcase-out.txt'

.testctrl CMD ... Run various sqlite3_test_control() operations

.timeout MS Try opening locked tables for MS milliseconds

.timer on|off Turn SQL timer on or off

.trace ?OPTIONS? Output each SQL statement as it is run

.vfsinfo ?AUX? Information about the top-level VFS

.vfslist List all available VFSes

.vfsname ?AUX? Print the name of the VFS stack

.width NUM1 NUM2 ... Set column widths for "column" mode


Connessione al database

Per operare su un database preesistente, è necessario connettersi ad esso tramite il comando .open. Ad esempio per connettersi al database orders.db procedere nel seguente modo:

Utenti Windows

  • Aprire un terminale (prompt dei comandi)

  • Posizionarsi nella cartella C:\SQLite

  • Avviare il tool sqlite3

  • Connettersi al database orders.db tramite il comando riportato in grassetto

sqlite> .open 'db\orders\orders.db'

Utenti macOS

  • Aprire un terminale (prompt dei comandi)

  • Posizionarsi nella cartella SQLite presente nella cartella home

  • Avviare il tool sqlite3

  • Connettersi al database orders.db tramite il comando riportato in grassetto

sqlite> .open 'db/orders/orders.db'


Comandi SQL

Una volta completata la connessione al database è possibile eseguire comandi SQL, come illustra il seguente esempio:

sqlite> SELECT * FROM Customers;

sqlite> INSERT INTO Customers (CustomerName, ContactName, Address, City, PostalCode, Country) VALUES ("Tito Tazio", "Titos", "Via Nuova", "Neaples", "80100", "Italy");

Uno speciale comando SQL, specifico di SQLite, è PRAGMA ed è utilizzato per modificare alcuni comportamenti di SQLite.

In particolare per abilitare il controllo sui vincoli di integrità delle chiavi esterne occorre eseguire preventivamente il comando:

PRAGMA foreign_keys = ON;


Disconnessione

Per terminare la sessione interattiva eseguire il comando riportato in grassetto

sqlite> .exit