Outils pour utilisateurs
td_histoire_numerique:descriptif_exercice_2
Différences
Ci-dessous, les différences entre deux révisions de la page.
| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente Prochaine révision Les deux révisions suivantes | ||
|
td_histoire_numerique:descriptif_exercice_2 [2014/10/04 13:51] Francesco Beretta [Procédure à suivre pour l'installation] |
td_histoire_numerique:descriptif_exercice_2 [2014/10/11 10:10] Francesco Beretta [Procédure à suivre pour l'installation de l'interface] |
||
|---|---|---|---|
| Ligne 5: | Ligne 5: | ||
| ===== Création de la base de données bd_td_exercice ===== | ===== Création de la base de données bd_td_exercice ===== | ||
| + | |||
| + | Veuillez trouver [[td_histoire_numerique:postgresql&#apprendre_a_utiliser_postgresql|ici]] quelques indications pour apprendre à utiliser PostgreSQL. | ||
| + | |||
| + | \\ | ||
| + | |||
| + | Procédure d'installation détaillée: | ||
| + | \\ | ||
| * Téléchargez le {{:td_histoire_numerique:bases_de_donnees_20141003.zip|dossier zippé}} contenant les fichiers à utiliser | * Téléchargez le {{:td_histoire_numerique:bases_de_donnees_20141003.zip|dossier zippé}} contenant les fichiers à utiliser | ||
| * Dézippez-le: il contient deux dossier -> mettez-les dans le dossier du cours, dans un sous-dossier que vous nommerez 'bases_importees' | * Dézippez-le: il contient deux dossier -> mettez-les dans le dossier du cours, dans un sous-dossier que vous nommerez 'bases_importees' | ||
| Ligne 22: | Ligne 29: | ||
| * Une fois le fichier ouvert (vous pourrez donc lire dans l'onglet 'Editeur SQL' une série de scripts SQL prêts à exécution), exécuter avec le menu Requêtes > Exécuter ou avec le bouton avec la forme d'une fleche verte | * Une fois le fichier ouvert (vous pourrez donc lire dans l'onglet 'Editeur SQL' une série de scripts SQL prêts à exécution), exécuter avec le menu Requêtes > Exécuter ou avec le bouton avec la forme d'une fleche verte | ||
| * Vous regardez la dernière ligne du message : "La requête a été exécutée avec succès en 391 ms, mais ne renvoie aucun résultat." (le reste ne compte pas, même pas les lignes annulées) – Si vous voyez ce résultat (même si la durée en ms est différente) c'est bon. | * Vous regardez la dernière ligne du message : "La requête a été exécutée avec succès en 391 ms, mais ne renvoie aucun résultat." (le reste ne compte pas, même pas les lignes annulées) – Si vous voyez ce résultat (même si la durée en ms est différente) c'est bon. | ||
| + | * En exécutant la requête SQL que vous voyez dans la boîte de dialogue SQL, le serveur PostgreSQL a créé les tables et ajouté les données que contient la requête SQL (instruction INSERT). | ||
| + | |||
| + | |||
| * Vous répétez ensuite l'opération avec les fichiers : **schema_parametres.sql** et **schema_vues_affichage.sql** | * Vous répétez ensuite l'opération avec les fichiers : **schema_parametres.sql** et **schema_vues_affichage.sql** | ||
| + | * Ouvrez le schema_parametres.sql | ||
| + | * Si le logiciel vous demande si vous voulez sauvegarder le texte que vous venez d'effacer à l'étape précédente, dites : non – car le nouveau texte SQL doit remplacer celui qui vient d'être exécuté | ||
| + | * Exécutez le script, etc. | ||
| * ATTENTION : exécuter les trois fichiers .sql exactement DANS L'ORDRE INDIQUÉ | * ATTENTION : exécuter les trois fichiers .sql exactement DANS L'ORDRE INDIQUÉ | ||
| * Fermez ensuite l'Editeur SQL' | * Fermez ensuite l'Editeur SQL' | ||
| Ligne 61: | Ligne 74: | ||
| * Ouvrir dans le fichier **schema_objets.sql** | * Ouvrir dans le fichier **schema_objets.sql** | ||
| * Une fois le fichier ouvert (vous pourrez donc lire dans l'onglet 'Editeur SQL' une série de scripts SQL prêts à exécution), exécuter avec le menu Requêtes > Exécuter ou avec le bouton avec la forme d'une fleche verte | * Une fois le fichier ouvert (vous pourrez donc lire dans l'onglet 'Editeur SQL' une série de scripts SQL prêts à exécution), exécuter avec le menu Requêtes > Exécuter ou avec le bouton avec la forme d'une fleche verte | ||
| + | * En exécutant ce script SQL, le serveur PostgreSQL produit 3 nouvelles tables avec les séquences numériques associées, et alimente les tables avec les données que contient le script même (instruciton INSERT) | ||
| * Vous répétez ensuite l'opération avec les fichiers : **schema_parametres.sql** et **schema_vues_affichage.sql** | * Vous répétez ensuite l'opération avec les fichiers : **schema_parametres.sql** et **schema_vues_affichage.sql** | ||
| * ATTENTION : exécuter les trois fichiers .sql exactement DANS L'ORDRE INDIQUÉ | * ATTENTION : exécuter les trois fichiers .sql exactement DANS L'ORDRE INDIQUÉ | ||
| Ligne 73: | Ligne 87: | ||
| * Cette fois, la table est vide car c'est à vous de la remplir | * Cette fois, la table est vide car c'est à vous de la remplir | ||
| + | \\ | ||
| Ligne 100: | Ligne 114: | ||
| - | * Télécharger la version du fichier qui correspond au système de fonctionnement de l'ordinateur: | + | * Télécharger le {{:td_histoire_numerique:td_histoire_numerique.zip|fichier}} qui sert d'interface à la base de données |
| - | * {{:td_histoire_numerique:td_histoire_numerique.odb.zip|Fichier pour Mac}} | + | |
| - | * {{:td_histoire_numerique:td_histoire_numerique.zip|Fichier pour Windows}} | + | |
| * Le dézipper et le mettre dans le dossier du cours | * Le dézipper et le mettre dans le dossier du cours | ||
| * Ouvrir le fichier avec le logiciel Base de la suite LibreOffice | * Ouvrir le fichier avec le logiciel Base de la suite LibreOffice | ||
| * ATTENTION: ce fichier ne marche qu'avec la version stable de LibreOffice: 4.2.6.3, et pas avec la version 4.3. Si vous avez installé la version de développement de LibreOffice (4.3), désinstallez-là et remplacez là par la version stable. | * ATTENTION: ce fichier ne marche qu'avec la version stable de LibreOffice: 4.2.6.3, et pas avec la version 4.3. Si vous avez installé la version de développement de LibreOffice (4.3), désinstallez-là et remplacez là par la version stable. | ||
| * Dans l'interface principale de la base de données, dans le menu 'Edition' > Bases de données > Propriétés, {{ :td_histoire_numerique:bd_proprietes_connexion.png?100 |}} on voit l'adresse de connection vers la base de données PostgreSQL: | * Dans l'interface principale de la base de données, dans le menu 'Edition' > Bases de données > Propriétés, {{ :td_histoire_numerique:bd_proprietes_connexion.png?100 |}} on voit l'adresse de connection vers la base de données PostgreSQL: | ||
| - | * dbname=bd_td_exercice hostaddr=127.0.0.1 port=5432 | + | <code>dbname=bd_td_exercice hostaddr=127.0.0.1 port=5432</code> |
| - | * Il n'y a rien a changer à ce sujet | + | * ATTENTION que l'adresse est bien celle-ci et aucune autre (pas par ex. dbname=bd_td_exercice hostaddr=127.0.0.1 port=5432). Car pour les utilisateurs Mac j'ai hélas laissé cette adresse là par mégarde. Il faut mettre l'adresse correcte (nom de la base de données et port) pour que tout se passe bien |
| * Dans le cadre de gauche, dans 'Formulaires', {{ :td_histoire_numerique:bd_ecran_principal.png?100 |}} on peut ouvrir le formulaire **objets** et retrouver les objets déjà créées à partir des notices biographiques de l'exercice précédent | * Dans le cadre de gauche, dans 'Formulaires', {{ :td_histoire_numerique:bd_ecran_principal.png?100 |}} on peut ouvrir le formulaire **objets** et retrouver les objets déjà créées à partir des notices biographiques de l'exercice précédent | ||
| + | * Au moment d'ouvrir le formulaire, Base vous demandera votre mot de passe utilisé lors de l'installation de PostgreSQL | ||
| * On peut parcourir les objets un par un, ou ouvrir la liste de tous les objets que contient la table –en utilisant le bouton en bas à droite {{ :td_histoire_numerique:bd_formulaire_objets.png?100 |}} – puis appliquer de filtres, trier, etc. C'est très pratique car l'objet sélectionné dans la liste est celui qu'on voit sur la fiche | * On peut parcourir les objets un par un, ou ouvrir la liste de tous les objets que contient la table –en utilisant le bouton en bas à droite {{ :td_histoire_numerique:bd_formulaire_objets.png?100 |}} – puis appliquer de filtres, trier, etc. C'est très pratique car l'objet sélectionné dans la liste est celui qu'on voit sur la fiche | ||
| Ligne 118: | Ligne 131: | ||
| - | ====== Création des objets et indexation des textes ====== | + | Il s'agit maintenant de créer une interface pour la base de données personnelle que vous avez créé plus haut dans PostgreSQL: **bd_personnelle** |
| + | |||
| + | Pour ce faire : | ||
| + | |||
| + | * Accéder au menu Fichier, enregistrer sous... {{ :td_histoire_numerique:bd_creer_copie_base.png?100 |}} | ||
| + | * renommez la copie que vous allez créer, l'appelant par ex. bd_personnelle – vous pouvez également la mettre dans un autre dossier, par ex. le dossier principal de votre travail de Master | ||
| + | * Validez et vous vous trouverez désormais dans le nouveau fichier de Base qui (pour mémoire) vous sert de client pour accéder au serveur PostgreSQL | ||
| + | * Il faudra maintenant changer les paramètres de connexion pour changer de base PostgreSQL interfacée | ||
| + | * allez dans le menu Edition > Base de données > Propriétés | ||
| + | * remplaces le nom de la base de données : 'dbname=bd_td_exercice' devient 'dbname=bd_personnelle' | ||
| + | * vous changez ainsi la base de données du serveur PostgreSQL qui devient visible grâce au client Base | ||
| + | * Testez la connexion avec le bouton de la même interface, mettant votre mot de passe. | ||
| + | * Si vous vous êtes trompés de mot de passe, il faut fermer et réouvrir le fichier | ||
| + | * ouvrez le formulaire 'objets': maintenant il sera vide car les tables du schéma 'objets' de votre base personnelle sont vides – à vous de les remplir | ||
| + | * pour créer un nouvel objet, uitliser le formulaire 'objets_creation' {{ :td_histoire_numerique:bd_formulaire_objets_creation.png?100 |}} car le formulaire 'objets' sert uniquement à visualiser et modifier des objets existants | ||
| + | |||
| + | |||
| + | Si vous avez tout effectué correctement jusqu'ici vous disposez désormais d'une base de données à vous, vous permettant de créer des objets et de les associer entre eux. Par exemple, de créer un acteur et de l'associer à la bibliographie qui le concerne. | ||
| + | |||
| + | |||
| + | \\ | ||
| + | |||
| + | |||
| + | |||
| + | ====== Sauvegarde de votre base personnelle !!! ====== | ||
| + | |||
| + | |||
| + | IMPORTANT: il faut **effectuer des sauvegardes régulières de votre base de données personnelle** en exportant en format SQL le contenu du schéma 'objets'. Vous pourrez ainsi recréer uen copie identique de votre base dans n'importe quel serveur PostgreSQL, par ex. sur un autre ordinateur. | ||
| + | |||
| + | * Ouvrir le client PGAdminIII et vous connecter à la base de données 'bd_personnelle' | ||
| + | * Déplier les schémas dans l'arboréscence à gauche | ||
| + | * sélectionner le schéma Objets, faire un click droit et sélectionner la commande sauvegarder{{ :td_histoire_numerique:pgsql_sauvegarde_du_schema.png?100 |}} | ||
| + | * créer un dossier de sauvegarde de vos données dans le dossier du TD ou de votre Master | ||
| + | * atteindre ce dossier par le bouton '...' de la sauvegarde de PGAdminIII | ||
| + | * comme nom du ficher de sauvegarde taper 'schema_objets_20141004.sql' Vous saurez ainsi directement à quelle date vous avez effectué la dernière sauvegarde | ||
| + | * Ensuite paramétrer dans le même onglet: | ||
| + | * Format : fichier plat | ||
| + | * Codage : UTF8 | ||
| + | * Le reste : vide | ||
| + | * Onglet 'Options 1': cocher 'Ne pas sauvegarder: Propriétaire, Droits'; le reste décoché | ||
| + | * Onglet 'Options 2' : cocher 'Requêtes : Utiliser les colonnes pour les Insert, Utiliser les commandes pour les insert' Le reste décoché, sauf laisser 'Messages en mode verbeux' | ||
| + | * Puis appuyer sur Sauvegarder. | ||
| + | * Si tout va bien, la liste des messages termine par 'Le process a retourné le code de sortie 0.' (si c'est '1' il y a un problème, '0' c'est OK) | ||
| + | * Vérifier que vous trouvez le nouveau document dans le dossier des sauvegardes. | ||
| + | * Ce n'est pas nécessaire de sauvegarder les autres schémas car normalement vous ne les touchez pas. Ils sont donc identiques aux fichiers que je vous ai envoyés et vous pouvez mettre une simple copie de ceux-ci dans votre dossier de sauvegarde. | ||
| + | * Le fichier de sauvegare vous permettra de recréer une copie exacte de votre schéma 'objets' de données sur un autre serveur (exactement comme on a fait lors de l'installation de la base de données pour le fichier exercice que je vous ai fourni). Donc si votre ordinateur a une défaillance, ou qu'on vous le vole, et si vous avez une copie de ces fichiers sur un disque dur à la maison, vous pourrez recréer votre base sur un nouvel ordinateur. Exactement comme on fait avec un document de traitement de texte. | ||
| + | |||
| + | |||
| + | Le fichier de sortie .sql est un fichier texte, facilement stockable sur une clé USB et très facile à mettre sur n'importe quelle autre plateforme, garantissant ainsi la pérennité de vos données. | ||
| + | |||
| + | Plus tard, vous pourrez aussi m'envoyer ces fichiers et je pourrai voir vos données, vous donner des indications et précisions et vous paramétrer des requêtes d'exploitation, pour vous apprendre à exploiter vos données | ||
| + | ====== Mise à jour de la base de données et de l'interface ====== | ||
| + | Télécharger le {{:td_histoire_numerique:bd_20141011.zip|fichier de la mise à jour}} et vérifier que c'est bien la dernière version.\\ | ||
| + | Version actuelle: bd_20141011 | ||
| - | ====== Sauvegarde de la base de données ====== | + | * Extraire – dézipper le dossier |
| + | * Ouvrir votre base de données personnelle (bd_personnelle) avec pgAdminIII | ||
| + | * Déplier dans l'arboréscence de gauche les schémas (rouge) | ||
| + | * NE TOUCHEZ JAMAIS au schéma 'objets' | ||
| + | * sélectionner le schéma vues_affichage, puis click droit: **supprimer en cascade** | ||
| + | * sélectionner le schéma paramètre, puis click droit: **supprimer en cascade** | ||
| + | * recrééz les schémas paramètre et vues_affichage selon les instructions [[td_histoire_numerique:descriptif_exercice_2&#creation_de_la_base_de_donnees_bd_personnelle|données ci-dessus]] et SANS TOUCHER au schéma 'objets' | ||
td_histoire_numerique/descriptif_exercice_2.txt · Dernière modification: 2014/11/27 09:45 par Francesco Beretta
