Up ! Query et Up ! PostgresSQL - Dictionnaire de données et de traitements - Version déclarative

Ce programme exécute interroge le dictionnaire de données et de traitements de PostgreSQL.

Le fichier source est ${UPS_HOME}/upsqry/demo/${UPS_LANGUAGE}/postgres4.upl.

Cet exemple utilise les instructions de l'extension d'Up ! 5GL pour Up ! Query. Les objets sémantiques sont déclarés statiquement.

Pour analyser le fichier source, UpsQry.upi doit être déclaré parmi les modules importés dans le fichier ${UPS_HOME}/ini/${UPS_USER}/upsp5l.ini.

Pour exécuter, les scripts :

${UPS_HOME}/upsqry/demo/french/postgres.sql doit être chargé pour la connexion scott/tiger.
${UPS_HOME}/upsqry/upsqry/upspgs.sql doit être chargé pour la connexion root/dba.

Mode compilé

Commande de compilation


upscmp Source=postgres4.upl

Commande d'exécution


postgres4 ConnexionPostgreSQL=scott/tiger@localhost/scott

Mode interprété


upssng Source=postgres4.upl ConnexionPostgreSQL=scott/tiger@localhost/scott

Fichier source


Source Composant "Exemple d'emploi d'Up ! PostgresSQL" Version 4.0.0;



ImporterModule

/************/

   UpsPgs(<UpsPgs.upi>, ImporterDefinitions);



ConnexionSql

/**********/

   MaConnexionSql(PostgreSQL, "scott/tiger");



Procedure ListerLesCatalogues()

/*****************************/

Debut

Ecran.Ecrire("ListerCatalogues");

Ecran.Ecrire("================");

RequeteSql CataloguesSql ConnexionSql MaConnexionSql 

   ResultatSql(NomCatalogue, Commentaire)

   ParametreSql("scott", Nul);

   Ecran.Ecrire(SiNul(NomCatalogue, "?")+" - "+SiNul(Commentaire, "?"));


Fin RequeteSql

Fin Procedure



Procedure ListerLesSchemas()

/**************************/

Debut

Ecran.Ecrire("ListerSchemas");

Ecran.Ecrire("=============");

RequeteSql SchemasSql ConnexionSql MaConnexionSql 

   ResultatSql(?, NomCatalogue, NomSchema, Commentaire)

   ParametreSql("scott", Nul, Nul);

   Ecran.Ecrire(SiNul(NomCatalogue, "?")+" - "+SiNul(NomSchema, "?")+" - "+SiNul(Commentaire, "?"));

Fin RequeteSql

Fin Procedure



Procedure ListerLesColonnes(NomCatalogue : Nul Ou Caractere, NomSchema : Nul Ou Caractere, NomTable : Nul Ou Caractere)

/********************************************************************************************************************/

Variable

/******/

   Ligne : Caractere;



Debut
Ecran.Ecrire("ListerColonnes");

Ecran.Ecrire("--------------");

RequeteSql ColonnesTablesSql ConnexionSql MaConnexionSql
 
   ResultatSql(?, ?, ?, ?, NomColonne, TypeColonne, TailleColonne, EstNul, Commentaire)

   ParametreSql("scott", NomCatalogue, NomSchema, NomTable, Nul);

   Selon TypeColonne Faire
   
      Cas Pour SorteDonneeBinaire Faire
      
         Ligne="Binaire";
      
      Fin Cas

      Cas Pour SorteDonneeCaractere Faire
      
         Ligne="Caractere";
      
      Fin Cas

      Cas Pour SorteDonneeDate Faire
      
         Ligne="Date";
      
      Fin Cas

      Cas Pour SorteDonneeEntier Faire
      
         Ligne="Entier";
      
      Fin Cas

      Cas Pour SorteDonneeEnumere Faire
      
         Ligne="Enumere";
      
      Fin Cas

      Cas Pour SorteDonneeReel Faire
      
         Ligne="Reel";
      
      Fin Cas

      Cas Pour SorteDonneeAutre Faire
      
         Ligne="Objet";
      
      Fin Cas
   
   Fin Selon

   Si TailleColonne>0 Alors
   
      Ligne+="("+Caractere(TailleColonne, "&&&#")+")";
   
   Fin Si

   Si EstNul Alors
   
      Ligne="Nul Ou "+Ligne;
   
   Fin Si

   Ecran.Ecrire(SiNul(NomColonne, "?")+" - "+Ligne+" - "+SiNul(Commentaire, "?"));

Fin RequeteSql

Fin Procedure



Procedure ListerLesClesPrimaires(NomCatalogue : Nul Ou Caractere, NomSchema : Nul Ou Caractere, NomTable : Nul Ou Caractere)

/**************************************************************************************************************************/

Debut

Ecran.Ecrire("ListerClesPrimaires");

Ecran.Ecrire("-------------------");

RequeteSql ClesPrimairesSql ConnexionSql MaConnexionSql 

   ResultatSql(?, ?, ?, ?, NomContrainte, EstUnique, NomColonne, NumeroColonne)

   ParametreSql("scott", NomCatalogue, NomSchema, NomTable);

   Ecran.Ecrire(SiNul(NomContrainte, "?")+" - "+Decoder(EstUnique, Vrai, "Unique", Faux, "Non unique")+" - "+
   
      SiNul(NomColonne, "?")+" - "+Caractere(NumeroColonne, "&&&#"));
   

Fin RequeteSql

Fin Procedure



Procedure ListerLesClesEtrangeres(NomCatalogue : Nul Ou Caractere, NomSchema : Nul Ou Caractere, NomTable : Nul Ou Caractere)

/***************************************************************************************************************************/

Debut

Ecran.Ecrire("ListerClesEtrangeres");

Ecran.Ecrire("--------------------");

RequeteSql ClesEtrangeresSql ConnexionSql MaConnexionSql 

   ResultatSql(NomContrainte, ?, ?, ?, NomTablePrimaire, NomColonnePrimaire, ?, ?, ?, ?, NomColonneEtrangere, ?)

   ParametreSql("scott", NomCatalogue, NomSchema, NomTable);

   Ecran.Ecrire(NomContrainte+" - "+NomColonneEtrangere+" - "+NomTablePrimaire+"."+NomColonnePrimaire);

Fin RequeteSql

Fin Procedure



Procedure ListerLesIndex(NomCatalogue : Nul Ou Caractere, NomSchema : Nul Ou Caractere, NomTable : Nul Ou Caractere)

/******************************************************************************************************************/

Debut

Ecran.Ecrire("ListerClesIndex");

Ecran.Ecrire("---------------");

RequeteSql IndexSql ConnexionSql MaConnexionSql 

   ResultatSql(?, ?, ?, ?, NomIndex, EstUnique, NomColonne, NumeroColonne)

   ParametreSql("scott", NomCatalogue, NomSchema, NomTable);

   Ecran.Ecrire(SiNul(NomIndex, "?")+" - "+Decoder(EstUnique, Vrai, "Unique", Faux, "Non unique")+" - "+
   
      SiNul(NomColonne, "?")+" - "+Caractere(NumeroColonne, "&&&#"));
   

Fin RequeteSql

Fin Procedure



Procedure ListerLesTables()

/*************************/

Debut

Ecran.Ecrire("ListerTables");

Ecran.Ecrire("============");

RequeteSql TablesSql ConnexionSql MaConnexionSql 

   ResultatSql(?, NomCatalogue, NomSchema, NomTable, SorteTable, Commentaire)

   ParametreSql(Nul, Nul, "scott", Nul, Nul);

   Ecran.Ecrire(SiNul(NomCatalogue, "?")+" - "+SiNul(NomSchema, "?")+" - "+SiNul(NomTable, "?")+" - "+
   
      Decoder(SorteTable, SorteTableSynonyme, "Synonyme", SorteTableTable, "Table", SorteTableVue, "Vue")+" - "+

      SiNul(Commentaire, "?"));
   
   Si SorteTable==SorteTableTable Alors
   
      ListerLesColonnes(NomCatalogue, NomSchema, NomTable);

      Si MaConnexionSql.ListerClesPrimairesSupporte Alors
      
         ListerLesClesPrimaires(NomCatalogue, NomSchema, NomTable);
      
      Sinon
      
         Ecran.Ecrire("ListerClesPrimaires() non supporte.");
      
      Fin Si

      Si MaConnexionSql.ListerClesEtrangeresSupporte Alors
      
         ListerLesClesEtrangeres(NomCatalogue, NomSchema, NomTable);
      
      Sinon
      
         Ecran.Ecrire("ListerClesEtrangeres() non supporte.");
      
      Fin Si

      Si MaConnexionSql.ListerIndexSupporte Alors
      
         ListerLesIndex(NomCatalogue, NomSchema, NomTable);
      
      Sinon
      
         Ecran.Ecrire("ListerIndex() non supporte.");
      
      Fin Si
      Ecran.Ecrire("-----------");
   
   Fin Si

Fin RequeteSql

Fin Procedure



Procedure ListerLesParametres(NomCatalogue : Nul Ou Caractere, NomSchema : Nul Ou Caractere, NomProcedure : Nul Ou Caractere)

/***************************************************************************************************************************/

Variable

/******/

   Ligne : Caractere;



Debut

Ecran.Ecrire("ListerParametres");

Ecran.Ecrire("---------------");

RequeteSql ParametresProceduresSql ConnexionSql MaConnexionSql 

   ResultatSql(?, ?, ?, ?, NomParametre, TypeParametre, TailleParametre, EstNul, SorteDuParametre, ?, Commentaire)

   ParametreSql("scott", NomCatalogue, NomSchema, NomProcedure, Nul);

   Selon TypeParametre Faire
   
      Cas Pour SorteDonneeBinaire Faire
      
         Ligne="Binaire";
      
      Fin Cas

      Cas Pour SorteDonneeCaractere Faire
      
         Ligne="Caractere";
      
      Fin Cas

      Cas Pour SorteDonneeDate Faire
      
         Ligne="Date";
      
      Fin Cas

      Cas Pour SorteDonneeEntier Faire
      
         Ligne="Entier";
      
      Fin Cas

      Cas Pour SorteDonneeEnumere Faire
      
         Ligne="Enumere";
      
      Fin Cas

      Cas Pour SorteDonneeReel Faire
      
         Ligne="Reel";
      
      Fin Cas

      Cas Pour SorteDonneeAutre Faire
      
         Ligne="Objet";
      
      Fin Cas
   
   Fin Selon

   Si TailleParametre>0 Alors
   
      Ligne+="("+Caractere(TailleParametre, "&&&#")+")";
   
   Fin Si

   Si EstNul Alors
   
      Ligne="Nul Ou "+Ligne;
   
   Fin Si

   Ecran.Ecrire(SiNul(NomParametre, "?")+" - "+Ligne+" - "+
   
      Decoder(SorteDuParametre, ParametreEntree, "Entree", ParametreSortie, "Sortie", ParametreEntreeSortie, "EntreeSortie")+" - "+

      SiNul(Commentaire, "?"));
   

Fin RequeteSql

Fin Procedure



Procedure ListerLesProcedures()

/*****************************/

Debut

Ecran.Ecrire("ListerProcedures");

Ecran.Ecrire("================");

RequeteSql ProceduresSql ConnexionSql MaConnexionSql 

   ResultatSql(?, NomCatalogue, NomSchema, NomProcedure, EstUneFonction, ?, Commentaire)

   ParametreSql(Nul, Nul, "scott", Nul);

   Ecran.Ecrire(SiNul(NomProcedure, "?")+" - "+Decoder(EstUneFonction, Vrai, "Fonction", Faux, "Procedure")+" - "+SiNul(Commentaire, "?"));

   ListerLesParametres(NomCatalogue, NomSchema, NomProcedure);

   Ecran.Ecrire("-----------");

Fin RequeteSql

Fin Procedure



Principal

/*******/

Debut

Si MaConnexionSql.ListerCataloguesSupporte Alors

   ListerLesCatalogues();

Sinon

   Ecran.Ecrire("ListerCatalogues() non supporte.");

Fin Si

Ecran.Ecrire(");
Si MaConnexionSql.ListerSchemasSupporte Alors

   ListerLesSchemas();

Sinon

   Ecran.Ecrire("ListerSchemas() non supporte.");

Fin Si
Ecran.Ecrire(");

Si MaConnexionSql.ListerTablesSupporte Alors

   ListerLesTables();

Sinon

   Ecran.Ecrire("ListerTables() non supporte.");

Fin Si
Ecran.Ecrire(");

Si MaConnexionSql.ListerProceduresSupporte Alors

   ListerLesProcedures();

Sinon

   Ecran.Ecrire("ListerProcedures() non supporte.");

Fin Si

Ecran.Ecrire(");

Fin Principal

Résultat de l'exécution

ListerCatalogues ================ scott - ? ListerSchemas ============= - scott - ? ListerTables ============ - - dept - Table - Departements ListerColonnes -------------- deptno - Entier(4) - Numero du departement dname - Caractere - Nom du departement loc - Nul Ou Caractere - Lieu du departement ListerClesPrimaires ------------------- PK_DEPT_DEPTNO - Non unique - deptno - 1 ListerClesEtrangeres -------------------- ListerClesIndex --------------- PK_DEPT_DEPTNO - Unique - deptno - 1 ----------- - - emp - Table - Employes. ListerColonnes -------------- empno - Entier(4) - Numero de l'employe ename - Caractere - Nom de l'employe job - Nul Ou Caractere - Profession de l'employe mgr - Nul Ou Entier(4) - Numero du superieur hierarchique de l'employe hiredate - Nul Ou Date(4) - Date d'embauche de l'employe sal - Nul Ou Reel(8) - Salaire de l'employe comm - Nul Ou Reel(8) - Commission de l'employe deptno - Entier(4) - Numero du departement de l'employe ListerClesPrimaires ------------------- PK_EMP_EMPNO - Non unique - empno - 1 ListerClesEtrangeres -------------------- FK_EMP_DEPTNO - deptno - dept.deptno ListerClesIndex --------------- PK_EMP_EMPNO - Unique - empno - 1 ----------- - - emp_desc - Table - Description des employes ListerColonnes -------------- empno - Entier(4) - Numero de l'employe description - Nul Ou Objet(4) - Description de l'employe ListerClesPrimaires ------------------- ListerClesEtrangeres -------------------- FK_EMP_DESC_DEPTNO - empno - emp.empno ListerClesIndex --------------- ----------- - - emp_pict - Table - Photos des employes ListerColonnes -------------- empno - Entier(4) - Numero de l'employe picture - Nul Ou Objet(4) - Photo de l'employe ListerClesPrimaires ------------------- ListerClesEtrangeres -------------------- FK_EMP_DESC_DEPTNO - empno - emp.empno ListerClesIndex --------------- ----------- - - upsindex - Table - ? ListerColonnes -------------- ListerClesPrimaires ------------------- upsindex_n_key - Unique - n - 1 ListerClesEtrangeres -------------------- ListerClesIndex --------------- upsindex_n_key - Unique - n - 1 ----------- - - v_dept - Vue - ? - - v_emp - Vue - ? ListerProcedures ================ mafonction - Fonction - ? ListerParametres --------------- result - Reel - Sortie - numerodepartement - Entier - Entree - ----------- maprocedure - Fonction - ? ListerParametres --------------- numerodepartement - Entier - Entree - salairemin - Entier - Sortie - salairemax - Entier - Sortie - -----------