====== Migration SQLite vers MySQL ======

===== Objectif =====
Cette documentation va expliquer comment effectuer la migration de SQLite vers un SGBD, ici MySQL.

===== Requis : =====
Demander à votre administrateur réseau de créer la base de donnée nécessaire a la configuration. \\
Ainsi que d’avoir le paquet sqlite3 installer sur votre serveur web à côté de l’installation de web2py. \\
Avoir une sauvegarde de l’application.

===== Migration des données : =====
On s'assure que notre base de donnée sur le SGBD est bien disponible.

Pour effectuer la migration, nous allons commencer par exporter les données de sqlite sous forme de script SQL. \\
On se place d’abord dans le dossier contenant le fichier de stockage sqlite.
<code># cd /var/www/web2py/applications/MRBS/databases</code>

Puis on réalise un export grâce a la commande qui suit :
<code># sqlite3 storage.sqlite .dump > data.sql</code>

A l’aide de votre éditeur de texte préféré (ici vim sera utilisée) on modifie le fichier afin de supprimer les commandes inutiles tel que les commandes //PRAGMA//, //BEGIN TRANSACTION//, //CREATE TABLE// et //COMMIT//. On retire également toutes les données concernant //sqlite_sequence//. \\
On remplace les guillemets double (“) par des guillemets inversées dite backquotes (`) avec la commande :
<code> :%s/”/`/g</code>

On supprime le contenu du dossier databases dans le dossier // /var/www/web2py/applications/MRBS // a l’aide de la commande suivante :
<code># rm -rf /var/www/web2py/applications/MRBS/databases/*</code>

On va maintenant configurer web2py afin d’effectuer la connexion vers MySQL. \\
On modifie le fichier **db.py** dans l’édition de l’application MRBS. //
On commente la ligne d’origine (ligne 11 ci-dessous) puis on ajoute une nouvelle ligne qui est la ligne 12 ci-dessous. Sa syntaxe est la suivante :
<code>mysql://<Login>:<Mot de Passe>@<Hôte>/<Base de Donnée></code>
{{ :sio:ppe2:mission_2:dal_av.png |}}

Après le test de la connexion de l’application cette erreur apparaît :
<code><class 'gluon.contrib.pymysql.err.ProgrammingError'> (1064, u"You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near 'accessible INT,\n categorie_id INT, INDEX categorie_id__idx (categorie_id), FO' at line 5")</code>

A l’aide du post sur le blog du PPE ainsi que nos recherches personnelles, nous avons trouvé la solution qui consiste à ajouter //“,ignore_field_case=False, entity_quoting=True”// dans la fonction DAL.
{{ :sio:ppe2:mission_2:dal_ap.png |}}

La dernière étape consiste a réimporter les données de l’application. Pour cela nous allons tout d’abord nous connecter en ligne de commande au serveur de base donnée (se référer a la documentation “[[sio:ppe2:mission_1:setup_sgbd|Mise en place d’un SGBD]]”partie test de connexion).

La syntaxe de cette commande est la suivante :
<code>mysql -u “Utilisateur” -p -h “Hôte” “Nom BDD” < “fichier”</code>

Dans notre cas :
<code>mysql -u Devs -p -h 172.21.101.12 mrbs < data.sql</code>

Après réalisation des tests primaires sur l’application,  nos développeurs confirment le bon fonctionnement de l’application après la migration.