Différences

Ci-dessous, les différences entre deux révisions de la page.

--- utilisateurs:nuxos:sqlite [Le 21/02/2011, 10:32] – [Utiliser un client graphique] mydjey
+++ utilisateurs:nuxos:sqlite [Le 12/06/2012, 20:30] (Version actuelle) – [Installation du paquet sqlite grigouille
@@ Ligne 1: / Ligne 1: @@
+{{tag> BROUILLON}}
+FIXME voir pour compléter les tags\\
+----
+====== SQLite sous Ubuntu ======
+<note help>Cette page est un brouillon destiné à initier une page collaborative sur le thème de SQLite.\\
+Elle permettra d'utiliser les logiciels que l'on trouve sur Ubuntu afin d'administrer des bases SQLite. La partie présentée ci-dessous concerne, pour le moment, l'utilisation la plus élémentaire de SQlite en lignes de commande via le terminal. S'y ajouteront différentes interfaces graphiques ainsi que l'utilisation de SQLite à l'aide de scripts python, perl, bash etc... </note>
+Une base SQLite3 a la particularité d'être contenue dans un fichier qui porte le même nom. Le moteur de base de données SQLite3 est une bibliothèque, libsqlite3, qu'il est possible d'utiliser avec l'interface utilisateur en ligne de commande ''sqlite3'' ou, via l'API C.\\
+SQLite3 présente l'avantage de n'avoir rien à configurer, rien à maintenir ou à administrer. C'est aussi son objectif. En contrepartie, certaines fonctionnalités sont absentes, comme la gestion des utilisateurs ou la possibilité de se connecter à distance à la base (en TCP/IP par exemple).
+//Cette description est tirée de "C en action" 2ième édition de Yves METTIER.//
+===== Installation =====
+Pour installer SQLite3, [[:tutoriel:comment_installer_un_paquet|installez le paquet]] **[[apt>sqlite3]]**.\\
+Par exemple avec l'outil [[:apt-get]] vous saisirez dans un [[:terminal]] la [[:commande_shell|commande]] suivante:
+<code>sudo apt-get install sqlite3</code>
+Remarque : pour installer SQLite2,[[:tutoriel:comment_installer_un_paquet|installez le paquet]] **[[apt>sqlite]]**.\\
+===== Utilisation en ligne de commande =====
+==== Lancer le terminal SQLite ====
+Dans un [[:terminal]], lancer la commande suivante avant de taper les commandes propres à SQLite:
+<code>sqlite3</code>
+Le curseur indique que vous êtes maintenant dans le "terminal" SQlite comme ici:
+<code>SQLite version 3.6.22
+Enter ".help" for instructions
+Enter SQL statements terminated with a ";"
+sqlite>
+</code>
+<note important>
+//Toute commande SQLite sera précédée de son curseur afin de bien distinguer les commandes SQLite des autres commandes.//
+</note>
+==== Quitter le terminal SQLite ====
+<code>sqlite>.quit</code>
+==== Lister les commandes SQLite ====
+<code>sqlite>.help</code>
+Affichera:
+<code>.backup ?DB? FILE		Backup DB (default "main") to FILE
+.bail ON|OFF			Stop after hitting an error.  Default OFF
+.databases			List names and files of attached databases
+.dump ?TABLE? ...		Dump the database in an SQL text format
+				     If TABLE specified, only dump tables matching
+				     LIKE pattern TABLE.
+.echo ON|OFF			Turn command echo on or off
+.exit				Exit this program
+.explain ?ON|OFF?		Turn output mode suitable for EXPLAIN on or off.
+				     With no args, it turns EXPLAIN on.
+.genfkey ?OPTIONS?		Options are:
+				     --no-drop: Do not drop old fkey triggers.
+				     --ignore-errors: Ignore tables with fkey errors
+				     --exec: Execute generated SQL immediately
+				See file tool/genfkey.README in the source
+				distribution for further information.
+.header(s) ON|OFF		Turn display of headers on or off
+.help				Show this message
+.import FILE TABLE		Import data from FILE into TABLE
+.indices ?TABLE?		Show names of all indices
+				     If TABLE specified, only show indices for tables
+				     matching LIKE pattern TABLE.
+.load FILE ?ENTRY?		Load an extension library
+.mode MODE ?TABLE?		Set output mode where MODE is one of:
+				     csv      Comma-separated values
+				     column   Left-aligned columns.  (See .width)
+				     html     HTML <table> code
+				     insert   SQL insert statements for TABLE
+				     line     One value per line
+				     list     Values delimited by .separator string
+				     tabs     Tab-separated values
+				     tcl      TCL list elements
+.nullvalue STRING		Print STRING in place of NULL values
+.output FILENAME		Send output to FILENAME
+.output stdout			Send output to the screen
+.prompt MAIN CONTINUE		Replace the standard prompts
+.quit				Exit this program
+.read FILENAME			Execute SQL in FILENAME
+.restore ?DB? FILE		Restore content of DB (default "main") from FILE
+.schema ?TABLE?			Show the CREATE statements
+				     If TABLE specified, only show tables matching
+				     LIKE pattern TABLE.
+.separator STRING		Change separator used by output mode and .import
+.show				Show the current values for various settings
+.tables ?TABLE?			List names of tables
+				     If TABLE specified, only list tables matching
+				     LIKE pattern TABLE.
+.timeout MS			Try opening locked tables for MS milliseconds
+.width NUM1 NUM2 ...		Set column widths for "column" mode
+.timer ON|OFF			Turn the CPU timer measurement on or off
+</code>
+==== Modifier le format de sortie ====
+Vous pouvez par exemple:
+  * [[#Afficher le nom des colonnes / Changer l'aspect des colonnes ]]
+  * [[#Modifier le séparateur]]
+  * [[#Modifier la largeur des colonnes]]
+  * [[#Modifier la sortie en code html]]
+=== Afficher le nom des colonnes / Changer l'aspect des colonnes ===
+  * Pour présenter les résultat d'une requête sous forme de tableau dans le terminal on utilisera:
+<code>
+sqlite> .headers on
+sqlite> .mode column
+</code>
+Et à l'issue d'une requête les résultats s'afficheront de cette manière:
+<code>
+nom        age    	membre
+----------  ----------  ----------
+dan         23         oui
+bob         45         non
+</code>
+  * Pour revenir au mode précédent:
+<code>
+sqlite> .header off		# Mode par défaut
+sqlite> .mode list		# Mode par défaut
+</code>
+Affichera:
+<code>
+dan|23|oui
+bob|45|non
+</code>
+=== Modifier le séparateur ===
+  * Il est possible de modifier le séparateur dans le mode list:
+<code>
+sqlite> .separator ", "
+</code>
+Affichera:
+<code>
+dan, 23, oui
+bob, 45, non
+</code>
+=== Modifier la largeur des colonnes ===
+  * Par défaut, chaque colonne fait 10 caractères de largeur. Il est possible d'ajuster la taille ainsi:
+<code>
+sqlite> .width 2 15 10 20 3
+</code>
+Affichera:
+<code>
+id  titre            auteur      resume           num  date_creation    éditeur
+--  ---------------  ----------  ---------------  ---  --------------  ----------
+   tintin au congo  hergé      Tintin est au c  5.0                   casterman
+   le nid des mars  franquin    Un reportage in  6.0
+   la déesse       moebius     une aventure ex  7.0  2011-02-03
+</code>
+=== Modifier la sortie en code html ===
+  * Il est possible de sortir directement les résultats en html:
+<code>
+sqlite> .mode html
+</code>
+Affichera:
+<code>
+<TR><TH>id</TH>
+<TH>titre</TH>
+<TH>auteur</TH>
+<TH>resume</TH>
+<TH>num</TH>
+<TH>timenter</TH>
+<TH>éditeur</TH>
+</TR>
+<TR><TD>1</TD>
+<TD>tintin au congo</TD>
+<TD>hergé</TD>
+<TD>Tintin est au congo.</TD>
+<TD>5.0</TD>
+<TD></TD>
+<TD>casterman</TD>
+</TR>
+<TR><TD>2</TD>
+<TD>le nid des marsupilamis</TD>
+<TD>franquin</TD>
+<TD>Un reportage incroyable</TD>
+<TD>6.0</TD>
+<TD></TD>
+<TD></TD>
+</TR>
+<TR><TD>3</TD>
+<TD>la déesse</TD>
+<TD>moebius</TD>
+<TD>une aventure extraordinaire</TD>
+<TD>7.0</TD>
+<TD>2011-02-03</TD>
+<TD></TD>
+</TR>
+</code>
+==== Rappel des paramètres ====
+<code>
+sqlite> .show
+</code>
+Affichera:
+<code>
+     echo: off
+  explain: off
+  headers: off
+     mode: list
+nullvalue: ""
+   output: stdout
+separator: "|"
+    width:
+</code>
+==== Manipuler une base ====
+Vous pouvez par exemple
+  * [[#Créer une base - ouvrir une base]]
+  * [[#Créer une table]]
+  * [[#Lister les tables]]
+  * [[#Insérer des valeurs dans la table]]
+  * Faire une [[#simple requête pour visualiser le contenu de la table]]
+  * [[#Effacer une valeur dans la table]]
+  * [[#Ajouter une colonne à la table]]
+  * [[#Mettre à jour une valeur à la table]]
+  * [[#Modifier le nom d'une table]]
+  * [[#Écrire la sortie des résultats dans un fichier]]
+  * [[#Dumper une table depuis SQLite en format SQL pour sauvegarder la structure et les données sur un disque]]
+  * [[#Dumper une base en format SQL pour sauvegarder sa structure, ses tables et ses données]]
+=== Créer une base - ouvrir une base ===
+<code>sqlite3 livres.db</code>
+  * Si la base ''livres.db'' n'existe pas déjà, elle sera créée. Cette commande, non seulement créé ou ouvre la base, mais place le curseur immédiatement dans l'environnement //terminal// de SQLite. Toute commande tapée par la suite concernera cette base.
+=== Créer une table ===
+Il faut avoir ouvert ou créé une base avant de taper les commandes suivantes:
+<code>
+sqlite> CREATE TABLE bandedessinée (id integer primary key, titre VARCHAR(30), auteur VARCHAR(30), resume TEXT, num double, date_creation date);
+</code>
+<note> Si ''   ...>'' apparait après avoir tapé la commande, c'est qu'il manque tout simplement le '';'' à la fin de la requête. Ajoutez-le juste après le ''   ...>;'' et validez.</note>
+<note>Les types de données SQLite3 sont tels qu'expliqué [[http://www.sqlite.org/datatype3.html|ici]] à savoir: //NULL, INTEGER, REAL, TEXT// et //BLOB//. Ce qui donne par exemple :
+<code>
+sqlite> CREATE TABLE bandedessinée (id integer primary key, titre TEXT, auteur TEXT, resume TEXT, num REAL, date_creation INTEGER);
+</code>
+</note>
+=== Lister les tables ===
+<code>
+sqlite> .tables
+</code>
+=== Insérer des valeurs dans la table ===
+Un exemple d'insertion de valeurs:
+<code>
+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'));
+</code>
+=== Simple requête pour visualiser le contenu de la table ===
+<code>
+sqlite> select * from bandedessinée;
+</code>
+Affichera:
+<code>
+|tintin au congo|hergé|Tintin est au congo.|5.0|
+|le nid des marsupilamis|franquin|Un reportage incroyable|6.0|2011-02-03
+|la déesse|moebius|une aventure extraordinaire|7.0|2011-02-03 18:36:25
+</code>
+== Requête de visualisation d'une table formatée en sortie COMME une insertion de valeur ==
+<code>sqlite> .mode insert bandedessinée
+sqlite> select * from bandedessinée;
+</code>
+Affichera:
+<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,'2011-02-03');
+INSERT INTO 'bandedessinée' VALUES(3,'la déesse','moebius','une aventure extraordinaire',7.0,'2011-02-03');
+</code>
+== Quelques exemples de requêtes ==
+  * Limiter une requête par nombre d'éléments: <code>
+sqlite> sqlite> select * from bandedessinée limit 2;</code><code>
+|tintin au congo|hergé|Tintin est au congo.|5.0||casterman
+|le nid des marsupilamis|franquin|Un reportage incroyable|6.0||</code>
+  * Sélectionner les titres de la table bandedessinée enregistrés depuis février: <code>
+sqlite> select titre from bandedessinée where strftime('%m', date_creation)='02';</code><code>
+le nid des marsupilamis
+la déesse</code>
+=== Effacer une valeur dans la table ===
+<code>
+sqlite> DELETE FROM "bandedessinée" WHERE id = 3;
+</code>
+=== Ajouter une colonne à la table ===
+<code>
+sqlite> ALTER TABLE "bandedessinée" add column "éditeur";
+</code>
+=== Mettre à jour une valeur à la table ===
+<code>
+sqlite> UPDATE "bandedessinée" SET éditeur ='casterman' WHERE id = 1;
+</code>
+=== Modifier le nom d'une table ===
+<code>
+alter table 'bandedessinée' rename to 'bd';
+</code>
+=== Écrire la sortie des résultats dans un fichier ===
+<code>
+sqlite> .output bd.txt
+sqlite> select * from bd;
+sqlite> .quit
+</code>
+  * Visualiser dans le terminal le fichier créé:
+<code>
+cat bd.txt
+</code>
+=== Dumper une table depuis SQLite en format SQL pour sauvegarder la structure et les données sur un disque ===
+== Voir le résultat de la commande .dump ==
+<code>
+sqlite> .dump bd
+PRAGMA foreign_keys=OFF;
+BEGIN TRANSACTION;
+CREATE TABLE "bd" (id integer primary key, titre VARCHAR(30), auteur VARCHAR(30), resume TEXT, num double, date_creation date);
+INSERT INTO "bd" VALUES(1,'tintin au congo','hergé','Tintin est au congo.',5.0,NULL);
+INSERT INTO "bd" VALUES(2,'le nid des marsupilamis','franquin','Un reportage incroyable',6.0,'2011-02-04');
+INSERT INTO "bd" VALUES(3,'la déesse','moebius','une aventure géniale',7.0,'2011-02-04 17:06:23');
+COMMIT;
+</code>
+== Rediriger la sortie vers un fichier puis dumper la table depuis SQLite ==
+<code>
+sqlite> .output bd.sql
+sqlite> .dump bd
+</code>
+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:
+<code>
+sqlite> .quit
+cat bd.sql
+</code>
+== Lire directement un fichier dumpé depuis sqlite ==
+Tout d'abord effacez la table de la base:
+<code>
+sqlite> drop table bd;
+</code>
+Puis lisez le fichier sauvegardé:
+<code>
+sqlite> .read bd.sql
+sqlite> select * from bd;
+</code>
+Affichera:
+<code>
+|tintin au congo|hergé|Tintin est au congo.|5.0|
+|le nid des marsupilamis|franquin|Un reportage incroyable|6.0|2011-02-04
+|la déesse|moebius|une aventure géniale|7.0|2011-02-04 17:06:23
+</code>
+=== Dumper une base en format SQL pour sauvegarder sa structure, ses tables et ses données ===
+== Dumper la base ==
+<code>
+sqlite3 livres.db .dump > livres.sql
+</code>
+== Récupérer un fichier dumpé pour recréer la base ==
+Effacez le fichier original avant de procéder à la récupération de la base:
+<code>
+rm -r livres.db				# Effacer la base originale
+sqlite3 livres.db < livres.sql		# Récuperer la base depuis le fichier de svg
+sqlite3 livres.db			# Se connecter à la base
+sqlite> select * from bd;		# Faire un requête pour vérification
+</code>
+Affichera:
+<code>
+|tintin au congo|hergé|Tintin est au congo.|5.0|
+|le nid des marsupilamis|franquin|Un reportage incroyable|6.0|2011-02-04
+|la déesse|moebius|une aventure géniale|7.0|2011-02-04 17:06:23
+</code>
+===== Utilisation avec un client graphique =====
+Liste de clients graphiques libres disponible sous Linux :
+  * [[http://sqlitebrowser.sourceforge.net/|Sqlite Browser]].
+  * [[http://mbg-sqlclient.developpez.com/|Ohraimeur]].
+  * [[https://addons.mozilla.org/fr/firefox/addon/sqlite-manager/|Sqlite manager]] (extension pour [[:Firefox]]).
+===== Utiliser Sqlite avec Python =====
+Exemple d'utilisation de SQLite avec un script python.\\
+[[:tutoriel:comment_modifier_un_fichier|Créez un fichier]] **test-python.py**. Par exemple avec [[:gedit]] vous saisirez dans un [[:terminal]]:
+<code>gedit test-python.py</code>
+Et ajoutez le code ci-dessous:
+<file python test-python.py>
+#!/usr/bin/env python
+#-*- coding: utf-8 -*-
+import sqlite3
+class Mabase():
+	def __init__(self):
+		self.conn = sqlite3.connect('mabase.db')
+	def creer(self):
+		"""	Créer une simple base.
+			Renvoi True si reussie, False si déjà créée. """
+		# Obtention d'un curseur
+		c = self.conn.cursor()
+		# Créer une table
+		try:
+			c.execute('create table comptes (id INTEGER PRIMARY KEY,signature VARCHAR(50), compteur INTEGER)')
+			# Inserer deux lignes de données
+			c.execute('insert into comptes values (null,"gffgdfgd","0")')
+			c.execute('insert into comptes values (null,"Martin","1")')
+			# Sauvegarder les modifications
+			self.conn.commit()
+			# Fermer le curseur
+			c.close()
+			print "Création de la base réussie."
+			return True
+		except:
+			# Fermer le curseur
+			c.close()
+			return False
+	def lire(self):
+		"""	"""
+		c = self.conn.cursor()
+		c.execute("SELECT * FROM comptes")
+		for row in c:
+			print row
+		c.close()
+# Création de l'instance de classe
+mabase = Mabase()
+if not mabase.creer():	# Si la méthode creer() renvoi False, lire la base
+	mabase.lire()
+</file>
+Modifiez les [[:permissions|permissions]] du script ''test-python.py'' afin de le rendre exécutable, puis lancez-le dans le terminal en tapant:
+<code>
+./test-python.py
+</code>
+----
+//Contributeurs: FIXME//

Différences

Outils pour utilisateurs

Outils du site

Outils de la page

Divers