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 11:17] – [Manipuler une base] 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 |
</cli> | </cli> |
- **.exit** / **.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 |
- **.header(s) on|[__off__]** : Affiche (ou non) les titres. Par exemple, <cli prompt='> '>sqlite> .header on | * **.quit** : Quitter le programme sqlite |
| |
| === Modifier le format de sortie === |
| |
| * **.mode MODE ?TABLE?** : Mode de sortie, MODE est à choisir parmi : |
| * **csv** : valeurs séparées par des virgules |
| * **column** : colonnes alignées à gauche (voir .width) |
| * **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 [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|}} |
- **html** : <table> (code HTML)<cli prompt='> '>sqlite> .mode html</cli>affichera :{{materiel:internet:serveur:sqlite-affichage-4.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|}} |
- **insert** : commande SQL **insert** pour la table TABLE | |
- **line** : Une valeur par ligne | === Rappel des paramètres === |
- **[__list__]** : Valeurs délimitées par la chaîne de séparation .separator | |
- **tabs** : valeurs séparées par des tabulations | * **.show** Affiche les valeurs actuelles des différents paramètres :<cli prompt='> '>sqlite> .show |
- **tcl** : Liste TCL des éléments | |
- **.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 | |
echo: off | echo: off |
eqp: off | eqp: off |
width: | width: |
filename: :memory:</cli> | filename: :memory:</cli> |
- **.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. | === Gestion des bases === |
- **.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 | * **.databases** : Liste les noms et les fichiers des bases de données associées |
- **.output FILENAME** : Envoyer la sortie vers FILENAME<cli prompt='> '>sqlite> .output bd.txt | * **.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 |
| * **.indices ?TABLE?** : Afficher les noms de tous les indices ; si TABLE est spécifiée, n'affiche que les indices correspondant au motif TABLE |
| * **.output FILENAME** : Envoyer la sortie vers FILENAME<cli prompt='> '>sqlite> .output bd.txt |
sqlite> select * from bd; | sqlite> select * from bd; |
sqlite> cat bd.txt | sqlite> cat bd.txt |
sqlite> .quit</cli> | sqlite> .quit</cli> |
- **.output stdout** : Envoyer la sortie vers l'écran | * **.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<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 | === Dumper une table depuis SQLite en format SQL pour sauvegarder la structure et les données sur un disque === |
| |
| * **.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|}} |
| * 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 | 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> | <cli prompt='$ '>...@...:~ $ cat bd.sql</cli></cli> |
- Lire directement un fichier dumpé depuis sqlite : | * Lire directement un fichier dumpé depuis sqlite : |
- Effacez la table de la base:<cli prompt='> '>sqlite> drop table bd;</cli> | * Effacez la table de la base:<cli prompt='> '>sqlite> drop table bd;</cli> |
- Puis lisez le fichier sauvegardé:<cli prompt='> '>sqlite> .read bd.sql | * 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 :<cli prompt='$ '>...:...$ sqlite3 livres.db .dump > livres.sql</cli> | * 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> |
- 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 la base originale :<cli prompt='$ '>...@...:~ $ rm -r livres.db</cli> |
- Récupérez la base depuis le fichier de svg :<cli prompt='$ '>...@...:~ $ sqlite3 livres.db < livres.sql</cli> | * Récupérez la base depuis le fichier de svg :<cli prompt='$ '>...@...:~ $ sqlite3 livres.db < livres.sql</cli> |
- Connectez-vous à la base< :<cli prompt='$ '>...@...:~ $ sqlite3 livres.db</cli> | * Connectez-vous à la base< :<cli prompt='$ '>...@...:~ $ sqlite3 livres.db</cli> |
- Faites un requête pour vérification :<cli prompt='$ '>sqlite> select * from bd;</cli>Affichera:{{materiel:internet:serveur:sqlite-12.png|}} | * Faites un requête pour vérification :<cli prompt='$ '>sqlite> select * from bd;</cli>Affichera:{{materiel:internet:serveur:sqlite-12.png|}} |
</subnumberlist> | |
| |
=== Manipuler une base === | === Manipuler une base === |
| |
- **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. | * **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> | * **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><WRAP center round tip 60%> | * **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> |
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. | * **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); |
| |
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> | |
</WRAP> | |
- **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(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> | 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|}} | * **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 | * **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|}} | sqlite> select * from bandedessinée;</cli>Affichera :{{materiel:internet:serveur:sqlite-7.png|}}Quelques exemples de requêtes : |
- **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 }} |
- **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|}} |
- **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> |
- **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> |
- **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> |
- **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> |
- **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 ===== |