Table 1. Informations générales

Rédacteur	K3rn€l P4n1k
Date	samedi 22 avril 2017
État	Rédigé

License

Ce programme est un logiciel libre ; vous pouvez le redistribuer ou le modifier suivant les termes de la GNU General Public License telle que publiée par la Free Software Foundation ; soit la version 3 de la licence,soit (à votre gré) toute version ultérieure.

Ce programme est distribué dans l’espoir qu’il sera utile, mais SANS AUCUNE GARANTIE ; sans même la garantie tacite de QUALITÉ MARCHANDE ou d’ADÉQUATION à UN BUT PARTICULIER. Consultez la GNU General Public License pour plus de détails.

Vous devez avoir reçu une copie de la GNU General Public License en même temps que ce programme ; si ce n’est pas le cas, consultez http://www.gnu.org/licenses."

PrimeDB

Objectif du document

Documente l’installation et l’usage de PrimeDB

Description générale

PrimeDB est une base de données construite à partir des données disponnible sur http://primes.utm.edu/lists/small/millions. Ce repository contient les sources permettant:

• Le téléchargement des données

• L’import de ces données dans une base SQLite3

• Un client très sommaire

• Quelques scripts et templates sql pour automatiser le requêtage

Important

Prévoir 1,5 Giga (estimation large) de libre pour l’installation. Le fichier final fait un peu moins de 700 Méga.

Intention

Profiter de la capacité de stockage pour économiser du temp de calcul.

Dépendances

Table 2. Liste des outils utilisés

Description	Dépendance	Source
Système d’exploitation	GNU/Linux	http://www.getgnulinux.org/fr/switch_to_linux/try_or_install/
Interpreteur	bash	https://www.gnu.org/software/bash/
Gestion de version	git	https://git-scm.com/downloads
Base de données	SQLite3	https://www.sqlite.org/download.html

Installation

Téléchargement et import des données

git clone https://github.com/Phreno/prime-database.git
./prime-database/database/bin/primeDB_setup

Structure des fichiers

database

• bin, fichiers d’installation de la base de données

• data, instance de la base de données

• lib, dépendances des fichiers d’installation

  1. base.profile Les constantes

  2. core.profile Les fonctions

  3. error.profile Gestion des erreurs (source stackoverflow)

  4. setup.profile Fonctions d’installation

• sql, fichiers de création de la table et template d’import

• test, pour des tests mannuels

LICENSE

• gpl-3.0.txt, license GNU GPL v3

• LICENSE, déclaration de permission de copie

sql

• template, modèle de requête à mettre à jour

Usage

En assumant pour la suite du document le paramètrage suivant:

Paramètrage commun à la suite des explications

PRIME_DB="/chemin/vers/la/racine/du/projet"
DATABASE="${PRIME_DB}/database/data/primeDB.db"
SQL="${PRIME_DB}/sql"
TEMPLATE="${SQL}/template"

Utilisation de SQLite3

Sélection des 9 premiers enregistrements avec SQLite3

sqlite3 "${DATABASE}"
sqlite3 sqlite> select rowid, value from prime where rowid < 10;

# Résultat
# 2
# 3
# 5
# 7
# 11
# 13
# 17
# 19
# 23

La même requête en externalisée dans le fichier ${SQL_QUERY}

SQL_QUERY="$(mktemp)"
echo "select rowid, value from prime where rowid < 10;" > "${SQL_QUERY}"
cat "${SQL_QUERY}" | sqlite3 "${DATABASE}"

# Résultat
# 2
# 3
# 5
# 7
# 11
# 13
# 17
# 19
# 23

Utilisation du client prime-db

prime-db est un client sommaire qui encapsule le deuxième type de requête utilisé dans l’explication précédante.

Signature

${PRIME_DB}/prime-db <file.sql>

Table 3. Arguments

file.sql

obligatoire

Fichier sql qui sera joué dans SQLite3

Exemple, récupération de la plus grande valeur disponible

${PRIME_DB}/prime-db "${SQL}/query_max_value.sql"

# Résultat
# 982451653

Exemple, utilisation d’un template pour récupérer le 85460ème nombre premier

SQL_QUERY="$(mktemp)"
cat "${PRIME_TEMPLATE}/template_get_value.sql" | sed 's/#rowid/85460/g' > "${SQL_QUERY}"
${PRIME_DB}/prime-db "${SQL_QUERY}"

# Résultat
# 1096379

Commentaires

L’utilisation de SQLite3 s’est faite tardivement dans l’application, si bien que core.profile & setup.profile contiennent quelques fonctions obsolètes, qui étaient destinées pour travailler sur les fichiers plats.

Références

Numberphile	https://www.youtube.com/watch?v=iFuR97YcSLM
njwildberger	https://www.youtube.com/watch?v=z_IAB5T0Qoo&t=1864s