Permettre l'infrastructure de tables liées avec phpMyAdmin

Date de publication : 18 janvier 2008

Par Samuel SAYAG
 

I. Introduction

I-A. Pour qui c'est fait...

I-B. ... et pour quoi faire...

1. Effectuer des relations entre vos tables. Si cela ne vous dit rien, n'allez pas plus loin et lisez plutôt un tutoriel Merise ou UML, et découvrez la « relation » et tous ses secrets (voir ici) ;
2. Mettre en favoris vos requêtes préférées ;
3. Afficher des info-bulles sur les champs de vos tables ;
4. Générer un PDF du diagramme de tables de votre base de données (et à afficher amoureusement dans votre chambre :)) ;
5. Stocker des commentaires sur chaque colonne de vos tables ;
6. Avoir un historique SQL lorsque vous travaillez sous phpMyAdmin ;
7. Effectuer les relations décrites au point un en mode graphique.

II. Installation de phpMyAdmin

1. Séparément, l'excellent tuto que voici
2. Un comparatif ici même

III. Import du script sous phpmyAdmin

1. Lancez phpmyAdmin si ce n'est déjà fait ;
2. Cette icône permet d'ouvrir le module d'import de code SQL :
   
3. Cliquez dessus, vous devriez voir apparaître cette fenêtre :
   

   Figure 1. Fenêtre du module d'import de code SQL
4. Cliquez sur "Importez les fichiers", puis sur "Parcourir", sélectionnez votre fichier sauvegardé et cliquez sur "Exécuter".

IV. Configuration de l'infrastructure de tables liées

IV-A. Le mode manuel

-- modifier ma table
ALTER TABLE t_contact
-- ajouter une contrainte d'un nom de mon choix 
	ADD 'nom_de_ma_contrainte_non_obligatoire'
-- sur la clé (ou le champs) id_pays
	FOREIGN KEY 'id_pays'
-- correspondant au champs id_pays de la table pays
	REFERENCE t_pays ('id_pays') 
-- si j'efface un pays, je ne veut pas que l'on efface mon contact
	ON DELETE NO ACTION
-- si l'id du pays est mis à jours, celui de la table contact 
-- aussi
	ON UPDATE CASCADE 

IV-B. Le mode graphique

1. Créer la base qui accueillera vos relations, vos signets, l'historique SQL etc. ;
2. Signaler à phpMyAdmin que cette base aura dorénavant cette utilité pour vous.

IV-B-1. Configurer phpMyAdmin

Figure 4. Base de données pour les nouvelles fonctionnalités de phpMyAdmin

IV-B-2. Créer la base

<?php
/* nom de la base de donnée qui contient toutes les table modules que vous ajouterez */
$cfg['Servers'][$i]['pmadb']         = 'phpMyAdmin'; 

/* nom de la table pour la mise en favoris des requêtes*/
$cfg['Servers'][$i]['bookmarktable'] = 'pma_bookmark';          
                                                   
/* nom de la table pour la gestion des relations entre les tables de vos bases de données*/
$cfg['Servers'][$i]['relation']      = 'pma_relation';          
                                                    
/* tables des informations sur vos table (infobulles)*/
$cfg['Servers'][$i]['table_info']    = 'pma_table_info';          

/* tables des coordonnées des schema de tables dans le document pdf*/
$cfg['Servers'][$i]['table_coords']  = 'pma_table_coords';         

/* encore une table necessaire à la generation pdf*/
$cfg['Servers'][$i]['pdf_pages']     = 'pma_pdf_pages';          

/* infobulles sur les champs de vos tables*/
$cfg['Servers'][$i]['column_info']   = 'pma_column_info';          
/* conservation de l'historique des requêtes*/
$cfg['Servers'][$i]['history']       = 'pma_history';          

/* coordonées des tables enregistrée en mode graphique*/
$cfg['Servers'][$i]['designer_coords']       = 'pma_designer_coords'; 

V. Conclusion

V-A. La création graphique d'une relation entre tables

Figure 5. Fenêtre de conception graphique

1. Cliquez dessus ;
2. Une info bulle vous demande de pointer sur la clé de table référencée ;
3. Cliquez sur le champ clé primaire de la table pays ;
4. Puis une info bulle vous demande de pointer sur la clé étrangère ;
5. Cliquez sur le champ id_pays de la table contact ;
6. Vous devriez voir la fenêtre suivante :
   

   Figure 6. Création de la relation
7. Choissisez ON UPDATE -> CASCADE (si on change le pays d'un contact, l'identifiant référençant le pays doit lui aussi être mi à jour) et ON DELETE -> NO ACTION (nous ne voulons pas effacer un contact même si son pays venait à être effacé) et validez votre choix.

Si vous cliquez sur l'icône de PDF, cela ne produira rien si vous n'avez pas déjà préparé le schéma de votre page PDF (voir plus loin).

V-B. L'enregistrement de requêtes dans les signets

1. Cliquez sur l'onglet "SQL" ;
2. Tapez dans la fenêtre SQL le code SQL suivant :

   Requête de sélection des pays présents dans la base

   SELECT * FROM ids_t_pays;

3. Cliquez sur "Exécuter" ;
4. Dans la même fenêtre, tout en bas, on vous propose d'enregistrer la requête sous un nom et de valider votre choix :
   
5. Faites-le puis, lorsque vous reviendrez dans l'onglet SQL après avoir effectué une autre tâche, il vous sera possible de rappeler votre requête pour l'exécuter, la modifier, la visualiser ou l'effacer :
   .

V-C. La création de PDF

1. Sous le menu base de données, cliquez sur l'onglet "Opération" et cliquez sur le lien Préparer le schéma en PDF (il est tout en bas de la page) ;
2. Vous tombez sur une interface peu claire, mais quoique vous fassiez vous pourrez le modifier donc... N'hésitez pas à expérimenter. Donner le nom de votre page PDF dans le champ prévu à cet effet ;
3. Cliquez sur "Exécuter" ;
4. Votre fenêtre affichera alors plusieurs options qui vous permettront de garnir votre PDF de tout ou partie du schéma de table, de couleurs, d'une grille etc. Faites votre choix et cliquez sur "Exécuter". N'oubliez pas de sauvegarder vos tables lorsque vous les incluez dans votre document et utilisez l'éditeur visuel pour les organiser au mieux ;
5. Votre PDF est généré.