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 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

Sito:  7ecnologie

Sezione: 12. SQL

Capitolo: 06. SQLite

Paragrafo: 03. Comandi interattivi

Indice dei capitoli: 00. Risorse - 01. Generalità - 02. Comandi di DML - 03. Comandi di DDL - 04. Comandi di DCL - 05. Comandi di TCL - 06. SQLite - 07. Tutorial - 98. Esercizi

Indice dei paragrafi: 01. Generalità - 02. Generazione e popolamento di un DB - 03. Comandi interattivi - 04. Transazioni