Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.
Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement…
Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
{{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** :

=== Commandes 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.//
Piste : • GNOME Recettes • Installer et gérer un volume RAID 1 logiciel • Mise à jour Windows 7 vers Windows 10 gratuitement • Page de man vsftpd.conf • Dokuwiki : Thème vector • Gnucash : Gérer les finances personnelles • DbxConv : Convertisseur DBX en MBOX • Raccourcis interwiki • Installation de Dolibarr sur votre poste ou sur un serveur dédié • Formatting Syntax
Documentation du Dr FRAPPE

Recherche

Navigation

Imprimer/exporter

Outils
