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

<subnumberlist>
  - **.help** : Lister les commandes :<cli prompt='> '>sqlite> .help
.archive ...             Manage SQL archives
</cli>
  - **.exit** / **.quit** : Quitter le programme sqlite
  - **.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)
      - **.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|}}
    - **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
  - **.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
         eqp: off
     explain: auto
     headers: off
        mode: html
   nullvalue: ""
      output: stdout
colseparator: "|"
rowseparator: "\n"
       stats: off
       width: 
    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.
  - **.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
  - **.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|}}
</subnumberlist>

=== 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><WRAP center round tip 60%>
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>
</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(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>

===== Désinstallation =====

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

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

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

Piste : • Dolibarr : module Imports • translate : un plugin de traduction qui n'exige pas que le nom de la page soit le même dans toutes les langues • Mini-tutoriels • Créer une Clé USB Windows 10 • DbxConv : Convertisseur DBX en MBOX • Différences entre /etc/dhcpcd.conf et /etc/network/interfaces • Comment afficher un écran Android sur un PC Linux • yalist : Plugin de liste universel simple • Toucher : "touche" les fichiers de configuration sans modifier les paramètres de DokuWiki

Documentation du Dr FRAPPE

Recherche

Navigation

Imprimer/exporter

Outils