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

Lancer sqlite3 avec le nom de la base :
  * <code>sqlite3 livres.db</code>

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 :
  * <code>rm livres.db</code>

== Créer une table ==

Dans sqlite, dans une base existante, lancer la commande :
  * <code>CREATE TABLE bandedessinée (id integer primary key, titre VARCHAR(30), auteur VARCHAR(30), resume TEXT, num double, date_creation date);</code>

<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 :
  * <code>CREATE TABLE bandedessinée (id integer primary key, titre TEXT, auteur TEXT, resume TEXT, num REAL, date_creation INTEGER);</code>
</WRAP>

== Insérer des valeurs dans la table ==

<WRAP center round info 60%>
Un exemple :
  * <code>INSERT INTO "bandedessinée" VALUES(1, 'tintin au congo', 'hergé', 'Tintin est au congo.', 5.0, NULL);
INSERT INTO "bandedessinée" VALUES(2, 'le nid des marsupilamis', 'franquin', 'Un reportage incroyable', 6.0, date('now'));
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'));</code>
</WRAP>

== Simple requête pour visualiser le contenu de la table ==

<WRAP center round info 60%>
  * <code>select * from bandedessinée;</code>

affichera :

{{materiel:internet:serveur:sqlite-affichage-6.png|}}
</WRAP>

== Requête de visualisation d'une table formatée en sortie COMME une insertion de valeur ==

<WRAP center round info 60%>
  * <code>.mode insert bandedessinée
select * from bandedessinée;</code>

Affichera :

{{materiel:internet:serveur:sqlite-7.png|}}
</WRAP>

<WRAP center round info 60%>
**Quelques exemples de requêtes**

  * __Limiter une requête par nombre d'éléments__ :<code>select * from bandedessinée limit 2;</code>affiche :\\ {{materiel:internet:serveur:sqlite-8.png|}}
  * __Sélectionner les titres de la table bandedessinée enregistrés depuis février__ :<code>select titre from bandedessinée where strftime('%m', date_creation)='02';</code>affiche :\\ {{materiel:internet:serveur:sqlite-9.png|}}
</WRAP>

== Effacer une valeur dans la table ==

<WRAP center round info 60%>
  * <code>DELETE FROM "bandedessinée" WHERE id = 3;</code>
</WRAP>

== Ajouter une colonne à la table ==

<WRAP center round info 60%>
  * <code>ALTER TABLE "bandedessinée" add column "éditeur";</code>
</WRAP>

== Mettre à jour une valeur de la table ==

<WRAP center round info 60%>
  * <code>UPDATE "bandedessinée" SET éditeur ='casterman' WHERE id = 1;</code>
</WRAP>

== Modifier le nom d'une table ==

<WRAP center round info 60%>
  * <code>alter table 'bandedessinée' rename to 'bd';</code>
</WRAP>

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

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

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

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

Piste : • Comment partager la connexion d'une clé 4G • Récuperer ses mails dans le cache de Thunderbird • Exemple de fichier Unbound.conf • Boîtier Enermax EMK3203 • Partager un dossier avec Ubuntu vers Windows • Extensions gnome • Blender : une application très complète de modélisation de tout genres et d'animation • Copier un répertoire ou une partition en gardant les permissions • Commander un hébergement mutualisé chez OVH • RAID 1 logiciel : Simuler une panne de disque et rétablir le RAID

Documentation du Dr FRAPPE

Recherche

Navigation

Imprimer/exporter

Outils