De par son aspect libre et ouvert, des ressources intéressantes existent pour cette base de données. On trouve par exemple un script d’installation évolué ainsi qu’une description précise de la structure… (Voir la liste en fin d’article). J’ai également mis en pièce jointe de cet article quelques documents « fait maison ».

Informations contenues dans la base de données :

La base de données employees sert à gérer comme son nom l’indique, les employés d’une entreprise. Pour chaque employé, les informations suivantes sont conservées : son nom, son prénom et son sexe, sa date de naissance ainsi que la date à laquelle il a été embauché. On garde également l’historique de l’évolution de son salaire ainsi que l’historique de l’évolution de son titre (« Senior Engineer », « Staff », « Engineer »…).

Cette entreprise est organisée en un certain nombre de départements (« Marketing », « Finance »…). Pour chaque département la base de données enregistre l’historique des manageurs (qui doit être un employé de la liste précédemment évoquée) ainsi que l’historique des employés de ce département (également des employés de la liste).

Resources

• Diagramme entité-relation (obtenu avec le logiciel MySQL Workbench puis annoté)
• Liste des tables (à partir de l’export du logiciel SQLyog)
• 10 premiers enregistrements de chaque table (réalisé à la main sur le même modèle que le document précédent)
• (en) Sample database with test suite in Launchpad : Site Launchpad de la base de données employees (description, téléchargement, questions/réponses, annonces, …)
• (en) MySQL :: HTML Setup Guide for employee data : Page décrivant la mise en place la base de données employees dans la documentation officielle de MySQL.
• (en) MySQL :: MySQL Documentation : Autres exemples officiels de bases de données.

Il fonctionne grâce à AWK, donc sur pratiquement n’importe quel système UNIX, et Mac OS X en particulier.

Pour en savoir plus sur l’utilisation de AWK dans Mac OS X, je vous invite à consulter l’article Se servir de AWK dans Mac OS X

Le script :

#!/usr/bin/awk -f
# Script de conversion d'un fichier .csv Excel en un script d'insertion SQL.
# version 1
# http://jmini.fr/

# STRUCTURE DU FICHIER :
# separateur : ;
# premiere ligne : nom de la table
# deuxieme ligne : nom des champs
# lignes suivantes : enregistrements

BEGIN {
	FS=";";
	RS="\n";
	OFS="";
	printf "-- csvToSql : debut du script sql\n";
}

{
	gsub(/'/,"\\'", $0);
}

NR==1 {
	li="INSERT INTO  `" $1 "` (  `";
}
NR==2 {
	nb_champ=NF;
	for(i=1; i<NF; i++)
		li=li $i "` ,  `";
	li=li $i "` ) ";
	print li;
	li="VALUES ";
}

NR>2 {
	li=li "('"
	for(i=1; i<nb_champ; i++)
		li=li $i "',  '";

	li=li $i "')";

	print li;
	li=", ";
}

END {
	print ";";
	print "-- csvToSql : fin du script sql \n";
}

Retrouvez tous les fichiers de démonstration dans une archive zip : csvsql.zip

Utilisation du script :

1) Préparer le fichier CSV

Peu importe la manière dont vous obtenez votre fichier CSV (copier-coller, export Excel…) vous devez vous assurer qu’il respecte bien le format prévu par le script. Si ce n’est pas le cas, un éditeur texte et une série de rechercher-remplacer devrait faire l’affaire. Pour les utilisateurs avertis, il est aussi possible de changer le script AWK…

Dans la configuration du script actuelle, il faut que fichier soit construit de la manière suivante :

• Le séparateur de champs doit être un point-virgule « ; »
• La première ligne ne doit contenir qu’un champ : le nom de la table
• La deuxième ligne doit contenir les noms des champs de la table SQL
• Les lignes suivantes doivent contenir les enregistrements (et donc le même nombre de champs que la deuxième ligne, s’il y en a plus, ils seront ignorés)

Exemple : fichier panier.csv :

Ce fichier s’obtient très facilement avec Excel en remplissant correctement une feuille du classeur :

Visualisation du fichier CSV dans Excel

Pour générer le fichier CSV, il suffit de faire : Menu > Fichier > Enregistrer sous… puis de choisir dans le format de fichier « CSV (séparateur : point-virgule) »

Enregistrer le fichier dans le répertoire de travail (ici un dossier csvsql sur le bureau).

2) Préparation du script

Copier le script ci-dessus dans un fichier texte nommé csvToSql.awk et rendez-le exécutable (méthode décrite dans l’article sur l’utilisation d’AWK)

ou utilisez le script de l’archive Zip de démonstration

Le plus simple est d’avoir ce fichier de script dans le répertoire de travail (dans notre cas, toujours le dossier csvsql sur le bureau).

3) Préparer le terminal

Ouvrer le terminal et placer vous dans le répertoire de travail contenant le script AWK (csvToSql.awk) et le fichier source (dans notre exemple panier.csv)

4) Lancer le script :

Il suffit de taper dans le terminal la commande :

On obtient dans terminal la requête SQL que l’on peut réutiliser à l’endroit adéquat (notamment dans PhpMyAdmin)

-- csvToSql : debut du script sql
INSERT INTO  `panier` (  `id` ,  `fruit` ,  `nombre` ,  `etat` )
VALUES ('1',  'pomme',  '23',  'bon'), ('2',  'poire',  '4',  'mauvais'), ('3',  'banane',  '7',  'parfait');
-- csvToSql : fin du script sql

-- Creation de la table
CREATE TABLE  `panier` (
`id` INT( 4 ) NOT NULL AUTO_INCREMENT ,
`fruit` VARCHAR( 20 ) ,
`nombre` INT( 8 ) DEFAULT  '0' NOT NULL ,
`etat` VARCHAR( 20 ) ,
PRIMARY KEY (  `id` )
) TYPE = MYISAM COMMENT =  'Panier de fruits';

Par définition, LAMP est un acronyme qui désigne la réunion sur une même plateforme de : Linux (système d’exploitation), Apache (serveur web), MySQL (serveur de base de données) et PHP (langage de script). Par définition donc, Mac OS n’est donc pas une solution LAMP, puisque Mac OS n’est pas un Linux. Néanmoins, Mac OS X est un UNIX (basé sur FreeBSD) et peut tout à fait servir de serveur web. Wikipédia propose le néologisme MAMP pour désigner de telle solution.

Cet article décrit comment installer un serveur Web sur la version normale de Mac OS X. Un tel serveur web peu notamment servir à faire des essais, ou alors comme serveur d’un intranet par exemple. Pour des besoins plus évolués, il faudrait certainement se pencher sur l’utilisation de MAMP avec Mac OS X Serveur (les principes de cet article doivent tout de même être vrais).

Apache :

Par défaut Apache est installé pour Mac OS X. Pour le lancer c’est très simple, il faut faire :

Menu Pomme > Préférence Système > Partage > Services

Dans la liste il suffit de sélectionner Partage Web personnel et de cliquer sur Démarrer.

Dès que l’on tape : http://localhost/ (ou http://127.0.0.1/) dans son navigateur, on obtient les pages du serveur Apache.

La racine du serveur web se trouve dans le dossier :

Macintosh HD > Bibliothèque > WebServer > Documents.

Il faut des droits d’administrateur pour modifier ce dossier.

Chaque utilisateur a la possibilité d’avoir son site internet. Il place alors ses pages dans le dossier :

Macintosh HD > Utilisateurs > Dossier personnel (la maison) > Sites

Les pages sont alors disponibles à l’adresse : http://127.0.0.1/~nom_dutilisateur/

MySQL :

Il est tout à fait possible d’avoir une base de données MySQL. Pour ma part j’ai choisi d’installer une solution toute faite proposée par ServerLogistics.

Elle a l’avantage de s’installer avec un simple fichier .pkg (utilisable avec l’installateur Apple) et propose un PreferencesPane (module pour les préférences système).

Emplacement du Socket MySQL

Récemment, j’ai rencontré un problème avec le Soket MySql. Il semblerait qu’il y ait un ancien et un nouvel emplacement :

• Par défaut, Apache l’attend ici : /var/mysql/mysql.sock
• Celui installé par ServerLogistics se trouve à l’ancien emplacement : /tmp/mysql.sock

Il faut donc modifier le fichier de configuration pour indiquer que l’on veut l’utiliser l’ancien emplacement. Le fichier de configuration est à l’adresse : /etc/php.ini

Voici comment modifier le fichier de configuration (lire également l’article sur l’édition des fichiers textes dans le terminal si vous n’êtes pas à l’aise avec son utilisation). Dans le terminal taper (il faut être administrateur) :

dans le fichier, il faut modifier la valeur de la variable mysql.default_socket. Il faut que la ligne soit égale à :

Plus d’information sur ce changement sur le site d’Apple : améliorations de l’interaction Apache/PHP/MySQL.
(cela concerne la version serveur, mais le fonctionnement est sensiblement le même)

PHP :

Par défaut, PHP n’est pas activé. Il faut le faire en modifiant le fichier : /etc/httpd/httpd.conf

Il s’agit de décommenter (enlever un #) devant certaines lignes.

Lancer l’éditeur en tapant dans le terminal (il faut être administrateur) :

Les détails des lignes à modifier sont bien décrits dans l’article : xrings : Activer PHP sous Mac OS 10.2 (Copie de l’article au format pdf : xringsnet-activer_php.pdf)