Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
logiciel:sql:sqlite:start [2021/04/05 10:08] – [Commandes SQLite] admin | logiciel:sql:sqlite:start [2022/08/13 21:57] (Version actuelle) – modification externe 127.0.0.1 |
---|
===== Installation ===== | ===== Installation ===== |
| |
- Installez le paquet **[[apt>sqlite3]]** ou en ligne de commande :<cli prompt='$ '>...@...:~$ sudo apt install sqlite3</cli> | * Installez le paquet **[[apt>sqlite3]]** ou en ligne de commande :<cli prompt='$ '>...@...:~$ sudo apt install sqlite3</cli> |
| |
===== Configuration ===== | ===== Configuration ===== |
<cli prompt='> '>sqlite> </cli></cli>Le prompt change et signale que vous êtes dans le **terminal SQlite** : | <cli prompt='> '>sqlite> </cli></cli>Le prompt change et signale que vous êtes dans le **terminal SQlite** : |
| |
=== Commandes SQLite === | === Lister les commandes === |
| |
<subnumberlist> | * **.help** : Lister les commandes :<cli prompt='> '>sqlite> .help |
- **.help** : Lister les commandes :<cli prompt='> '>sqlite> .help | |
.archive ... Manage SQL archives | .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 | |
.explain ?on|off|auto? Change the EXPLAIN formatting mode. Default: auto | |
.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 | |
.session ?NAME? CMD ... Create or control sessions | |
.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 | |
</cli> | </cli> |
- **.exit** ou **.quit** : Quitter le programme sqlite | |
- **.mode MODE ?TABLE?** : Mode de sortie, MODE est à choisir parmi : | === Quitter sqlite === |
- **csv** : valeurs séparées par des virgules | |
- **column** : colonnes alignées à gauche (voir .width) | * **.exit** : Quitter le programme sqlite |
- **html** : <table> (code HTML)<cli prompt='> '>sqlite> .mode html</cli>affichera :{{materiel:internet:serveur:sqlite-affichage-4.png|}} | * **.quit** : Quitter le programme sqlite |
- **insert** : commande SQL **insert** pour la table TABLE | |
- **line** : Une valeur par ligne | === Modifier le format de sortie === |
- **[__list__]** : Valeurs délimitées par la chaîne de séparation .separator | |
- **tabs** : valeurs séparées par des tabulations | * **.mode MODE ?TABLE?** : Mode de sortie, MODE est à choisir parmi : |
- **tcl** : Liste TCL des éléments | * **csv** : valeurs séparées par des virgules |
- Afficher le nom des colonnes / Changer l'aspect des colonnes (.mode column) : | * **column** : colonnes alignées à gauche (voir .width) |
- **.header(s) on|[__off__]** : Affiche (ou non) les titres. Par exemple, <cli prompt='> '>sqlite> .header on | * **html** : <table> (code HTML)<cli prompt='> '>sqlite> .mode html</cli>affichera :{{materiel:internet:serveur:sqlite-affichage-4.png|}} |
| * **insert** : commande SQL **insert** pour la table TABLE |
| * **line** : Une valeur par ligne |
| * **[__list__]** : Valeurs délimitées par la chaîne de séparation .separator |
| * **tabs** : valeurs séparées par des tabulations |
| * **tcl** : Liste TCL des éléments |
| |
| === Afficher le nom des colonnes / Changer l'aspect des colonnes (.mode column) === |
| |
| * **.header(s) on|[__off__]** : Affiche (ou non) les titres. Par exemple, <cli prompt='> '>sqlite> .header on |
sqlite> .mode column</cli>affichera les résultats comme ceci :{{materiel:internet:serveur:sqlite-affichage_tableau.png|}}L'affichage par défaut <cli prompt='> '>sqlite> .header off | sqlite> .mode column</cli>affichera les résultats comme ceci :{{materiel:internet:serveur:sqlite-affichage_tableau.png|}}L'affichage par défaut <cli prompt='> '>sqlite> .header off |
sqlite> .mode list</cli>affiche comme ceci :{{materiel:internet:serveur:sqlite-affichage-2.png|}} | sqlite> .mode list</cli>affiche comme ceci :{{materiel:internet:serveur:sqlite-affichage-2.png|}} |
- **.width NUM1 NUM2 ...** : largeur des colonnes pour le mode **column** [par défaut, 10 caractères]. Par exemple,<cli prompt='> '>sqlite> .width 2 15 10 20 3</cli>affichera:{{materiel:internet:serveur:sqlite-affichage-3.png|}} | * **.width NUM1 NUM2 ...** : largeur des colonnes [par défaut, 10 caractères]. Par exemple,<cli prompt='> '>sqlite> .width 2 15 10 20 3</cli>affichera:{{materiel:internet:serveur:sqlite-affichage-3.png|}} |
- **.separator STRING** : change le séparateur utilisé par le mode de sortie et par .import. En mode liste,<cli prompt='> '>sqlite> .separator ", "</cli>affichera :{{materiel:internet:serveur:sqlite-affichage-2.png|}} | * **.separator STRING** : change le séparateur utilisé par le mode de sortie et par .import. En mode liste,<cli prompt='> '>sqlite> .separator ", "</cli>affichera :{{materiel:internet:serveur:sqlite-affichage-2.png|}} |
- **.show** Affiche les valeurs actuelles des différents paramètres :<cli prompt='> '>sqlite> .show | |
| === Rappel des paramètres === |
| |
| * **.show** Affiche les valeurs actuelles des différents paramètres :<cli prompt='> '>sqlite> .show |
echo: off | echo: off |
eqp: off | eqp: off |
width: | width: |
filename: :memory:</cli> | filename: :memory:</cli> |
- **Gestion des bases** : | |
- **Lister les bases** : | === Gestion des bases === |
- **.databases** : Liste les noms et les fichiers des bases de données associées | |
- **.tables ?TABLE?** : Liste les noms des tables dans la base courante. Si TABLE est spécifié, ne liste que les tables correspondant au motif TABLE. | * **.databases** : Liste les noms et les fichiers des bases de données associées |
- **Importer les données d'une table** : | * **.tables ?TABLE?** : Liste les noms des tables dans la base courante. Si TABLE est spécifié, ne liste que les tables correspondant au motif TABLE. |
- **.import FILE TABLE** : Importer les données de FILE dans TABLE | * **.import FILE TABLE** : Importer les données de FILE dans TABLE |
- **.indices ?TABLE?** : Afficher les noms de tous les indices ; si TABLE est spécifiée, n'affiche que les indices correspondant au motif TABLE | * **.indices ?TABLE?** : Afficher les noms de tous les indices ; si TABLE est spécifiée, n'affiche que les indices correspondant au motif TABLE |
- **Écrire la sortie des résultats dans un fichier** | * **.output FILENAME** : Envoyer la sortie vers FILENAME<cli prompt='> '>sqlite> .output bd.txt |
- **.output FILENAME** : Envoyer la sortie vers FILENAME | |
- **.output stdout** : Envoyer la sortie vers l'écran<WRAP center round info 60%> | |
<cli prompt='> '>sqlite> .output bd.txt | |
sqlite> select * from bd; | sqlite> select * from bd; |
- **Dumper une table** depuis SQLite en format SQL pour sauvegarder la structure et les données sur un disque : | sqlite> cat bd.txt |
- Pour visualiser dans le terminal le fichier créé :<cli prompt='$ '>...@...:~ $ cat bd.txt</cli> | |
sqlite> .quit</cli> | sqlite> .quit</cli> |
</WRAP> | * **.output stdout** : Envoyer la sortie vers l'écran |
- **.dump ?TABLE? ...** : Dump de la base de données dans un format texte SQL. Si TABLE est spécifié, ne dumpe que les tables correspondant au motif TABLE | |
</subnumberlist><WRAP center round info 60%> | |
Voir le résultat de la commande .dump<cli prompt='> '>sqlite> .dump bd</cli>{{materiel:internet:serveur:sqlite-10.png|}} | |
Rediriger la sortie vers un fichier puis dumper la table depuis SQLite<cli prompt='> '>sqlite> .output bd.sql | |
sqlite> .dump bd</cli> | |
| |
Le résultat n'est plus affiché dans le terminal, mais redirigé vers le fichier bd.sql. Pour le vérifier il suffit d'afficher le contenu du fichier:<cli prompt='> '>sqlite> .quit | === Dumper une table depuis SQLite en format SQL pour sauvegarder la structure et les données sur un disque === |
<cli prompt='$ '>...@...:~ $ cat bd.sql</cli></cli> | |
| |
Lire directement un fichier dumpé depuis sqlite : | * **.dump ?TABLE? ...** : Dump de la base de données dans un format texte SQL. Si TABLE est spécifié, ne dumpe que les tables correspondant au motif TABLE<cli prompt='> '>sqlite> .dump bd</cli>{{materiel:internet:serveur:sqlite-10.png|}} |
- Tout d'abord effacez la table de la base:<cli prompt='> '>sqlite> drop table bd;</cli> | * Rediriger la sortie vers un fichier puis dumper la table depuis SQLite<cli prompt='> '>sqlite> .output bd.sql |
- Puis lisez le fichier sauvegardé:<cli prompt='> '>sqlite> .read bd.sql | sqlite> .dump bd</cli>Le résultat n'est plus affiché dans le terminal, mais redirigé vers le fichier bd.sql. Pour le vérifier il suffit d'afficher le contenu du fichier:<cli prompt='> '>sqlite> .quit |
| <cli prompt='$ '>...@...:~ $ cat bd.sql</cli></cli> |
| * Lire directement un fichier dumpé depuis sqlite : |
| * Effacez la table de la base:<cli prompt='> '>sqlite> drop table bd;</cli> |
| * Puis lisez le fichier sauvegardé:<cli prompt='> '>sqlite> .read bd.sql |
sqlite> select * from bd;</cli>Affichera:{{materiel:internet:serveur:sqlite-11.png|}} | sqlite> select * from bd;</cli>Affichera:{{materiel:internet:serveur:sqlite-11.png|}} |
- Dumper une base en format SQL pour sauvegarder sa structure, ses tables et ses données | * Dumper une base en format SQL pour sauvegarder sa structure, ses tables et ses données :<cli prompt='$ '>...:...$ sqlite3 livres.db .dump > livres.sql</cli> |
- Dumper la base :<cli prompt='> '>sqlite3 livres.db .dump > livres.sql</cli> | * Récupérer un fichier dumpé pour recréer la base : |
- Récupérer un fichier dumpé pour recréer la base : | * Effacez la base originale :<cli prompt='$ '>...@...:~ $ rm -r livres.db</cli> |
- Effacez le fichier original avant de procéder à la récupération de la base : | * Récupérez la base depuis le fichier de svg :<cli prompt='$ '>...@...:~ $ sqlite3 livres.db < livres.sql</cli> |
- Effacer la base originale :<cli prompt='$ '>...@...:~ $ rm -r livres.db</cli> | * Connectez-vous à la base< :<cli prompt='$ '>...@...:~ $ sqlite3 livres.db</cli> |
- Récuperer la base depuis le fichier de svg :<cli prompt='$ '>...@...:~ $ sqlite3 livres.db < livres.sql</cli> | * Faites un requête pour vérification :<cli prompt='$ '>sqlite> select * from bd;</cli>Affichera:{{materiel:internet:serveur:sqlite-12.png|}} |
- Se connecter à la base< :<cli prompt='$ '>...@...:~ $ sqlite3 livres.db</cli> | |
- Faire un requête pour vérification :<cli prompt='$ '>sqlite> select * from bd;</cli>Affichera:{{materiel:internet:serveur:sqlite-12.png|}} | === Manipuler une base === |
</WRAP> | |
| * **Créer une base - ouvrir une base** : Lancez sqlite3 avec le nom de la base :<cli prompt='$ '>...@...:~ $ sqlite3 livres.db</cli>Si la base n'existe pas, elle sera créée. Toutes les commandes qui suivront concerneront cette base. |
| * **Détruire une base** : Il suffit d'effacer son fichier .db :<cli prompt='$ '>...@...:~ $ rm livres.db</cli> |
| * **Créer une table** : Dans sqlite, dans une base existante, lancer la commande :<cli prompt='> '>sqlite> CREATE TABLE bandedessinée (id integer primary key, titre VARCHAR(30), auteur VARCHAR(30), resume TEXT, num double, date_creation date);</cli>Si le prompt apparaît après avoir tapé la commande, c'est qu'il manque le ";" à la fin de la requête. Ajoutez-le juste après le prompt validez.\\ Les types de données SQLite3 sont : NULL, INTEGER, REAL, TEXT et BLOB. Ce qui donne par exemple :<cli prompt='> '>sqlite> CREATE TABLE bandedessinée (id integer primary key, titre TEXT, auteur TEXT, resume TEXT, num REAL, date_creation INTEGER);</cli> |
| * **Insérer des valeurs dans la table** : Un exemple :<cli prompt='> '>sqlite> INSERT INTO "bandedessinée" VALUES(1, 'tintin au congo', 'hergé', 'Tintin est au congo.', 5.0, NULL); |
| sqlite> INSERT INTO "bandedessinée" VALUES(2, 'le nid des marsupilamis', 'franquin', 'Un reportage incroyable', 6.0, date('now')); |
| sqlite> INSERT INTO "bandedessinée" VALUES(3, 'la déesse', 'moebius', 'une aventure géniale', 7.0, strftime("%Y-%m-%d %H:%M:%S",'now','localtime'));</cli> |
| * **Simple requête pour visualiser le contenu de la table** : <cli prompt='> '>sqlite> select * from bandedessinée;</cli>affichera :{{materiel:internet:serveur:sqlite-affichage-6.png|}} |
| * **Requête de visualisation d'une table formatée en sortie COMME une insertion de valeur** : <cli prompt='> '>sqlite> .mode insert bandedessinée |
| sqlite> select * from bandedessinée;</cli>Affichera :{{materiel:internet:serveur:sqlite-7.png|}}Quelques exemples de requêtes : |
| * **Limiter une requête par nombre d'éléments** : <cli prompt='> '>sqlite> select * from bandedessinée limit 2;</cli>affiche :{{ materiel:internet:serveur:sqlite-8.png }} |
| * **Sélectionner les titres de la table bandedessinée enregistrés depuis février** : <cli prompt='> '>sqlite> select titre from bandedessinée where strftime('%m', date_creation)='02';</cli>affiche :{{materiel:internet:serveur:sqlite-9.png|}} |
| * **Effacer une valeur dans la table** : <cli prompt='> '>sqlite> DELETE FROM "bandedessinée" WHERE id = 3;</cli> |
| * **Ajouter une colonne à la table** : <cli prompt='> '>sqlite> ALTER TABLE "bandedessinée" add column "éditeur";</cli> |
| * **Mettre à jour une valeur de la table** : <cli prompt='> '>sqlite> UPDATE "bandedessinée" SET éditeur ='casterman' WHERE id = 1;</cli> |
| * **Modifier le nom d'une table** : <cli prompt='> '>sqlite> alter table 'bandedessinée' rename to 'bd';</cli> |
| |
| === Autres commandes === |
| |
| * **.backup ?DB? FILE** : Sauvegarde DB (par défaut "main") vers FILE |
| * **.bail ON|[__OFF__]** : Stop après une erreur |
| * **.echo ON|OFF** : Bascule la commande d'écho ON/OFF |
| * **.explain ?ON|OFF?** : Bascule le mode de sortie approprié pour EXPLIQUER on or off\\ Sans argument, on |
| * **.load FILE ?ENTRY?** : Charger une bibliothèque d'extension |
| * **.log FILE|off** : Activer ou désactiver la journalisation. FILE peut être stderr/stdout |
| * **.nullvalue STRING** : Imprime STRING à la place des valeurs NULL |
| * **.prompt MAIN CONTINUE** : Remplace les prompts standards |
| * **.read FILENAME** : Exécuter SQL dans FILENAME |
| * **.restore ?DB? FILE** : Restaurer le contenu de la DB (par défaut "main") à partir de FILE |
| * **.schema ?TABLE?** : Afficher les déclarations CREATE. Si TABLE est spécifié, ne montrer que les tables correspondant au motif TABLE |
| * **.stats ON|OFF** : Active ou désactive les stats |
| * **.timeout MS** : Essayer d'ouvrir les tables verrouillées durant MS millisecondes |
| * **.trace FILE|off** : afficher chaque instruction SQL au moment de son exécution |
| * **.vfsname ?AUX?** : afficher le nom de la pile VFS |
| * **.timer ON|OFF** : activer ou désactiver la minuterie du CPU |
| |
===== Désinstallation ===== | ===== Désinstallation ===== |