Cette page traitera principalement du système de gestion de base de données (SGBD) MySQL
et, sous l'angle de celui-ci, de SQL dans le cadre de l'application EzGED.

====== Créer une base de données ======

Pour créer une base de données nommée //nchp_test//
<code>
mysql -u root -p -e "create database nchp_test;"
</code>

====== Sauvegarder / Exporter ======
Pour sauvegarder notre base de données nous allons réaliser un dump.

===== Structures et données dans un seul fichier =====
Ouvrez un interpréteur de commandes et entrez la commande suivante :

<code>mysqldump -u root -p nom_base > dump_base.sql</code>

Si le répertoire des binaires de mysql n'est pas dans les variables d'environnement il faudra indiquer le chemin complet
vers la commande. Par exemple:

<code>C:\nchp\mysql\bin\mysqldump -u root -p nom_base > dump_base.sql</code>

Où //nom_base// doit être remplacé par le nom de votre base de données (pour EzGED par défaut ce nom est **nchp_ezged**)\\
et //dump_base.sql// est le nom du fichier de sauvegarde (vous pourriez l'appeler autrement bien entendu).

<code>mysqldump -u root -p nom_base > dump_base.sql</code>

===== Structures et données dans des fichiers séparés =====

Pour exporter la structure (triggers et procédures comprises) sans les données entrez la commande suivante :

<code>mysqldump -u root -p --routines --no-data nom_base > dump_structure_base.sql</code>

Pour exporter les données seules entrez la commande suivante:

<code>mysqldump -u root -p --no-create-info --skip-triggers nom_base > dump_datas_base.sql</code>

===== Sélectionner des tables à dumper =====
Il est possible d'exporter uniquement certaines tables avec cette commande :

<code>mysqldump -u root -p base table_1 table_2 ... table_n > dump_selection_tables.sql </code>

====== Reparer les tables InnoDB ======

Si besoin de réparer les tables InnoDB vous pouvez utiliser la fonction //db_regenerate_innodb_indexes()// du module python db_mysql livré par EzGED. 

Pour les instructions voir la page [[https://wiki.ezdev.fr/doku.php?id=dev:api:python:db_mysql#regenerer_les_indexes_innodb | de documentation du module db_mysql ]]

====== Importer / Restaurer ======

===== Structures et données dans un seul fichier =====

<code>mysql -u root -p ma_base < dump_base.sql </code>

===== Structures et données dans des fichiers séparés =====

On remonte d'abord la structure:
<code>mysql -u root -p ma_base < dump_structure_base.sql </code>

Puis on remonte les données:
<code>mysql -u root -p ma_base < dump_datas_base.sql </code>
====== Réparation de tables ======
Réparation d'une table dans phpMyadmin ou dans l'invite mysql (bref un client SQL connecté à la base de données):

<code>REPAIR TABLE <nom_de_la_table></code>

Réparation auto de toutes les tables de toutes les bases de données :

<code>mysqlcheck -u root -p --auto-repair --check --optimize --all-databases</code>

Si la table est en myisam et que la réparation ne fonctionne pas vous pouvez tenter ceci :

<code>myisamchk --safe-recover cheminfichier.MYI</code>
====== Remarques ======
Si pour l'une des commandes ci-dessus l'interpréteur vous signifie que la commande n'est pas reconnue, deux solutions possibles.

1/ Déplacez vous jusqu'au niveau du répertoire contenant les binaires mysql :
<code>cd C:\nchp\mysql\bin</code>
ou

2/ Assurez vous que le chemin ci-dessus soit bien présent dans la variable **path** des variables d'environnement windows.

La plupart des opérations ci-dessus sont accessibles via l'interface graphique phpmyadmin mais la ligne de commande est plus performante.
Avec phpmyadmin vous seriez par exemple limité sur la taille du fichier sql pour l'import en fonction des paramètres de configuration de php.

====== Base de données d'archivage ======

Objectif: déplacer sur une autre base de données des tables qui sont en consultation afin d'alléger les dumps.

La base de données d'archive reste sur la même instance il n'y aura donc aucune difficulté pour continuer à
y accéder depuis la ged.

On commence par créer la base de données
<code sql>
CREATE DATABASE nchp_archive; 
</code>

La procédure est ensuite la suivante ([[https://mariadb.com/kb/en/copying-tables-between-different-mariadb-databases-and-mariadb-servers/|Documentation MarIADB]]):
<code sql>
FLUSH TABLES db_name.table_name FOR EXPORT

# Copy the relevant files associated with the table

UNLOCK TABLES;
</code>

En passant par PhpMyAdmin il suffit d'aller dans ''Operation'' et tout au début de la page il est proposer de déplacer la table vers la base de donnée qu'il suffit donc de sélectionner.

Une fois le déplacement effectué on peut créer une vue (sur la table de production) qui va sélectionner tout les champs de la table qui maintenance se trouve sur la base d'archivage

<code sql>
CREATE VIEW nomtable AS SELECT * FROM base_archive.nomtable
</code>

====== Migration vers MySQL 5.6 ======
Il est nécessaire d'ajouter le paramètre de configuration suivant dans le .ini:
<code>
[mysqld]
secure_auth=0
</code>

Par défaut dans MySQL 5.6 secure_auth est à 1 et bloque toute tentative d'authentification avec un mot de passe haché avec l'algorithme pré-4.1

https://dev.mysql.com/doc/refman/5.0/en/server-options.html#option_mysqld_secure-auth\\
https://dev.mysql.com/doc/refman/5.0/en/old-client.html


====== Réinitialiser le mot de passe root======

Suivre la procédure indiqué sur la documentation de MySQL : https://dev.mysql.com/doc/mysql-windows-excerpt/5.7/en/resetting-permissions-windows.html

====== Configuration adaptée aux tables volumineuses ======

Voici une configuration adaptée aux instances MySQL/MariaDB traitant
des volumes de données importants.

<file my.ini>
[mysqld]
datadir=C:/nchp/mysql/data
port=3306
#EGE-20190429 : Ajout-Modif suite retour Fabrice
#innodb_buffer_pool_size=1023M
sql_mode="STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION"
default_storage_engine=innodb
skip-external-locking
key_buffer_size = 512M
table_open_cache = 512
sort_buffer_size = 2M
read_buffer_size = 2M
read_rnd_buffer_size = 8M
myisam_sort_buffer_size = 64M
thread_cache_size = 8
query_cache_size = 64M
thread_concurrency = 10
max_connections = 1000
#EGE-20201230 : Optimisation suite erreurs bdd
innodb_buffer_pool_size= 4G
wait_timeout = 43200
max_allowed_packet = 64M
innodb_log_file_size= 20M

#EGE-20190429 : Traces requetes longues
slow_query_log=1
slow_query_log_file=C:/nchp/mysql/log/mysql-slow.log
long_query_time = 2
net_read_timeout = 60
connect_timeout = 20

[client]
port=3306
plugin-dir=C:/nchp/mysql/lib/plugin
</file>