{{tag>Logiciel}}

====== SQLite : une base de données SQL ======

===== Pré-requis =====

===== Installation =====

  * Installez le paquet **[[apt>sqlite3]]** ou en ligne de commande :<cli prompt='$ '>...@...:~$ sudo apt install sqlite3</cli>

===== Configuration =====

===== Utilisation =====

==== Avec un client graphique : SQLiteManager ====

  - **[[logiciel:sql:sqlite:sqlitemanager:start|]]**

==== En ligne de commande ====

  - Lancez dans un terminal :<cli prompt='$ '>...@...:~ $ sqlite3
SQLite version 3.31.1 2020-01-27 19:55:54
Enter ".help" for usage hints.
Connected to a transient in-memory database.
Use ".open FILENAME" to reopen on a persistent database.
<cli prompt='> '>sqlite> </cli></cli>Le prompt change et signale que vous êtes dans le **terminal SQlite** :

=== Lister les commandes ===

  * **.help** : Lister les commandes :<cli prompt='> '>sqlite> .help
.archive ...             Manage SQL archives
</cli>

=== Quitter sqlite ===

  * **.exit** : Quitter le programme sqlite
  * **.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 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|}}
  * **.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|}}

=== Rappel des paramètres ===

  * **.show** Affiche les valeurs actuelles des différents paramètres :<cli prompt='> '>sqlite> .show
        echo: off
         eqp: off
     explain: auto
     headers: off
        mode: html
   nullvalue: ""
      output: stdout
colseparator: "|"
rowseparator: "\n"
       stats: off
       width: 
    filename: :memory:</cli>

=== 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.
  * **.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> cat bd.txt
sqlite> .quit</cli>
  * **.output stdout** : Envoyer la sortie vers l'écran

=== 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
<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|}}
    * 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 :
      * 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>
      * 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|}}

=== 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.
  * **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 =====

===== Voir aussi =====

  * **(fr)** [[http://Article]]

----
//Basé sur << [[http://Article|Article]] >> par Auteur.//