SQLite3 - Réglages avancés
Petite pause sur notre série sur SQL, pour se replonger dans les entrailles de SQLite3. Lors du lancement de l'application, avez vous remarqué, cette petite annotation
Enter ".help" for usage hints.
Avez vous pris le temps de tester ? Si non, je vais le faire pour vous.
.auth ON|OFF Show authorizer callbacks
.backup ?DB? FILE Backup DB (default "main") to FILE
Add "--append" to open using appendvfs.
.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? ... Dump the database in an SQL text format
If TABLE specified, only dump tables matching
LIKE pattern TABLE.
.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 a spreadsheet
.exit Exit this program
.expert EXPERIMENTAL. Suggest indexes for specified queries
.fullschema ?--indent? Show schema and the content of sqlite_stat tables
.headers on|off Turn display of headers on or off
.help Show this message
.import FILE TABLE Import data from FILE into TABLE
.imposter INDEX TABLE Create imposter table TABLE on index INDEX
.indexes ?TABLE? Show names of all indexes
If TABLE specified, only show indexes for tables
matching LIKE pattern TABLE.
.limit ?LIMIT? ?VAL? Display or change the value of an SQLITE_LIMIT
.lint OPTIONS Report potential schema issues. Options:
fkey-indexes Find missing foreign key indexes
.log FILE|off Turn logging on or off. FILE can be stderr/stdout
.mode MODE ?TABLE? Set output mode where MODE is one of:
ascii Columns/rows delimited by 0x1F and 0x1E
csv Comma-separated values
column Left-aligned columns. (See .width)
html HTML table code
insert SQL insert statements for TABLE
line One value per line
list Values delimited by "|"
quote Escape answers as for SQL
tabs Tab-separated values
tcl TCL list elements
.nullvalue STRING Use STRING in place of NULL values
.once (-e|-x|FILE) Output for the next SQL command only to FILE
or invoke system text editor (-e) or spreadsheet (-x)
on the output.
.open ?OPTIONS? ?FILE? Close existing database and reopen FILE
The --new option starts with an empty file
Other options: --readonly --append --zip
.output ?FILE? Send output to FILE or stdout
.print STRING... Print literal STRING
.prompt MAIN CONTINUE Replace the standard prompts
.quit Exit this program
.read FILENAME Execute SQL in FILENAME
.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
Add --indent for pretty-printing
.selftest ?--init? Run tests defined in the SELFTEST table
.separator COL ?ROW? Change the column separator and optionally the row
separator for both the output mode and .import
.session CMD ... Create or control sessions
.sha3sum ?OPTIONS...? 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
If TABLE specified, only list tables matching
LIKE pattern TABLE.
.testcase NAME Begin redirecting output to 'testcase-out.txt'
.timeout MS Try opening locked tables for MS milliseconds
.timer on|off Turn SQL timer on or off
.trace FILE|off 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
Negative values right-justify
Dans toute cette liste, nous retrouver quelques commandes que nous avons déjà vu, telles que .tables, .open ou .exit.
D'autres permettent de faire un peu de configuration de notre environnement SQLite3 afin d'améliorer son confort de travail.
Je vous invite à commencer par la commande .show qui devrait vous renvoyer quelque chose comme ceci
echo: off
eqp: off
explain: auto
headers: off
mode: list
nullvalue: ""
output: stdout
colseparator: "|"
rowseparator: "n"
stats: off
width:
filename: /Users/sky/Documents/test.db
En changeant ces valeurs, nous allons pouvoir personnaliser l'affichage des données d'un SELECT. Vous pouvez ainsi changer le séparateur de colonne
.separator ";"
Lors d'un SELECT sur nos données tel que
SELECT * FROM contacts;
Le résultat se voit directement
1;Tony;Stark;ironman@avengers.assembly;Inconnu;Chalet;;30213;Fairburn
2;Pepper;Pots;pepper@avengers.assembly;Inconnu;Chalet;;30213;Fairburn
3;Scott;Lang;antman@avengers.assembly;Inconnu;;;10471;New York City
4;Hope;van Dyne;wasp@@avengers.assembly;Inconnu;;;10470;New York City
5;Howard;Stark;;;;;;New York City
6;James;Rhodes;warmachine@avengers.assembly;;Base militaire;;93523;Edwards
Maintenant, ajoutons un des en-têtes à nos résultats
.headers on
relançons la commande SELECT, et voici le résultat
id;prenom;nom;email;telephone;adresse_voie;adresse_complement;adresse_code;adresse_ville
1;Tony;Stark;ironman@avengers.assembly;Inconnu;Chalet;;30213;Fairburn
2;Pepper;Pots;pepper@avengers.assembly;Inconnu;Chalet;;30213;Fairburn
3;Scott;Lang;antman@avengers.assembly;Inconnu;;;10471;New York City
4;Hope;van Dyne;wasp@@avengers.assembly;Inconnu;;;10470;New York City
5;Howard;Stark;;;;;;New York City
6;James;Rhodes;warmachine@avengers.assembly;;Base militaire;;93523;Edwards
Comme vous pouvez le voir, le nom des colonnes est désormais affiché, ce qui peut être utile dans certains cas.
Pour rendre le résultat encore plus lisible, il est possible de modifier l'affichage, en passant, par exemple, en colonne fixe
.mode column
et hop
id prenom nom email telephone adresse_voie adresse_complement adresse_code adresse_ville
---------- ---------- ---------- ------------------------- ---------- ------------ ------------------ ------------ -------------
1 Tony Stark ironman@avengers.assembly Inconnu Chalet 30213 Fairburn
2 Pepper Pots pepper@avengers.assembly Inconnu Chalet 30213 Fairburn
3 Scott Lang antman@avengers.assembly Inconnu 10471 New York City
4 Hope van Dyne wasp@@avengers.assembly Inconnu 10470 New York City
5 Howard Stark New York City
6 James Rhodes warmachine@avengers.assem Base militai 93523 Edwards
Le résultat devient très lisible, par contre, certaines données peuvent être tronquées, si elle dépasse la longueur de la colonne. Pour résoudre ce problème, si vous avez besoin d'afficher des valeurs plus longues, vous pouvez encore personnaliser l'affichage dans ce sens
.width 4 16 16 40 12 20
Ici nous demandons à ce que la première colonne s'affiche sur 4 caractères, la seconde 16, la troisième aussi, et ainsi de suite.
id prenom nom email telephone adresse_voie adresse_complement adresse_code adresse_ville
---- ---------------- ---------------- ---------------------------------------- ------------ -------------------- ------------------ ------------ -------------
1 Tony Stark ironman@avengers.assembly Inconnu Chalet 30213 Fairburn
2 Pepper Pots pepper@avengers.assembly Inconnu Chalet 30213 Fairburn
3 Scott Lang antman@avengers.assembly Inconnu 10471 New York City
4 Hope van Dyne wasp@@avengers.assembly Inconnu 10470 New York City
5 Howard Stark New York City
6 James Rhodes warmachine@avengers.assembly Base militaire 93523 Edwards
D'autres modes d'affichage sont disponibles, vous en avez la liste dans la commande .help, et vous pouvez vous amuser à les tester.
Pour retrouver un comportement proche de MySQL/MariaDb, qui indique le temps d'exécution des commandes, vous pouvez l'activer sur SQLite3
.timer on
Et voila, vous pouvez désormais formater vos résultats de manière optimale, pour vos besoins.
