• SCRIPTS SQL

 

Le gestionnaire de travaux doit être démarré.

Au niveau de la génération du MLD, cochez "Script SQL".
Précisez le chemin et le nom d'un fichier texte.
Cliquez sur le bouton "Générer".

Attention : le script SQL ainsi généré ne permet que de créer les tables (CREATE_TABLE).
Si vous souhaitez modifier la structure des tables ou supprimer des tables (par exemple), il faut modifier à la main ce script pour ne pas faire de CREATE_TABLE, mais des ALTER_TABLE ou des DROP_TABLE (ou autres ordres SQL selon l’action souhaitée).

 

Exécuter un script SQL

Vous pouvez l'exécuter depuis le gestionnaire de requête du SGBD.

 

 

  • SCRIPTS GÉNÉRIQUES

 

Le gestionnaire de travaux doit être démarré.

Au niveau de la génération du MLD, cochez "Script générique".
Précisez le chemin et le nom d'un fichier texte, avec comme extension .gen.
Cliquez sur le bouton "Générer".

 

 

Exemples de scripts générés:

 

 * Script obtenu, sans conservation des données :

PG;0,0,1,0,
CE;'ADELIA','ZENTITE',ZENTITE,ZENTITEL,ZENTITEF,1, ,'ZENTITE';'ID',ID,6,10,0,1,E,0,1,'','','','ID',0,0;'LIBL',LIBL,30,35,0,0, ,0,1,'','','','LIBL',0,0

 

 * Script obtenu, avec conservation des données :

PG;1,0,1,0,
CE;'ADELIA','ZENTITE',ZENTITE,ZENTITEL,ZENTITEF,1, ,'ZENTITE';'ID',ID,6,10,0,1,E,0,1,'','','','ID',0,0;'LIBL',LIBL,30,45,0,0, ,0,1,'','','','LIBL',0,0;'TMSTMP',TMSTMP,13,12,0,0, ,0,1,'','','','Timestamp',0,0

 

Gestion des versions

Facultatif
Vous pouvez gérer une gestion des versions de votre base de données, si vous le souhaitez.

Créez une table permettant de mémoriser le n° de version des tables :

 

Prévoyez une gestion des données pour incrémenter le n°  de version.

 

Gestion des données

Facultatif
Vous pouvez exécuter des requêtes après la création / mise-à-jour des tables.
Ces requêtes seront placées dans un fichier .dat.

Créez un fichier texte .dat : CLIENTS.dat, par exemple.
Saisissez les requêtes SQL.
Par exemples :

INSERT INTO ADELIA.ZENTITE VALUES(1,'LIBL 1')
INSERT INTO ADELIA.ZENTITE VALUES(2,'LIBL 2')
INSERT INTO ADELIA.ZENTITE VALUES(3,'LIBL 3')

UPDATE BDCLI.VERSION SET NO_VER=NO_VER+1

 

.dbd spécifique

Créez un fichier texte .dbd : CLIENTS.dbd, par exemple.
Créez les différentes sections en suivant la description faite dans l’aide en ligne, sous l’onglet Sommaire : « L’outil de gestion de bases de données >> Description de la base de données ».

Exemple - Création de tables, avec insertion de données
[DB2]
GrantedErrors=100,204,805,803,612

[PDM/Generic]
*ALL = script.gen

[Data/Generic]
*ALL = sql_insert.dat
Exemple - Mise-à-jour de tables, sans gestion de versions
[DB2]
GrantedErrors=100,204,805,803,612

[PDM/Generic]
*ALL = script.gen
Exemple - Mise-à-jour de tables, avec gestion de versions
[Database]
Version=3
checkversion=SELECT NO_VER FROM BDCLI.VERSION

[DB2]
GrantedErrors=100,204,805,803,612

[PDM/Generic]
*ALL = script.gen
2 = 3, script_updt_v3.gen

[Data/Generic]
*ALL = sql_insert.dat
2 = sql_updt_v3.dat

*ALL permet de créer les tables si elles n’existent pas.
Dans [Database], précisez la nouvelle version.
Dans [PDM] et [Data], précisez la version actuelle pour la mise-à-jour des tables.

 

Exécution du script générique

L'exécution des scripts génériques se fait dans l'outil de gestion des bases de données (dbtool).

Allez dans Adélia >> Utilitaires >> Outils de gestion des bases de données.

Les exemples sont données avec DB2 comme DGBD.
Mais, le principe est le même avec les autres SGBD.

 

Créer une table

Sélectionnez le .dbd.
Cochez « Créer les tables ou les fichiers ».

Cliquez sur « Suivant ».
Précisez la base de données sur laquelle doit s’exécuter le script.

 

Cliquez sur « Suivant ».
Eventuellement, demandez la journalisation des actions.
Cliquez sur « Suivant ».
Cliquez sur « Exécuter ».

=> La table est créé avec les données insérées dedans.

 

 

Mettre à jour une table, sans gestion de versions

Sélectionnez le .dbd.
Cocher « Créer les tables ou les fichiers », car ce .dbd ne comprend pas de script BD particulier (pas de section [Data/Generic]).

Cliquez sur « Suivant ».
Précisez la base de données sur laquelle doit s’exécuter le script.

Cliquez sur « Suivant ».
Eventuellement, demandez la journalisation des actions.
Cliquez sur « Suivant ».
Cliquez sur « Exécuter ».

=> La table est mise-à-jour.

 

Mettre à jour une table, avec gestion de versions

Sélectionnez le .dbd.
Cochez « Mettre à jour une base de données », car ce .dbd comprend un script BD particulier, permettant, entre autre, la gestion du n° de version (présence d'une section [Data/Generic]).

Cliquez sur « Suivant ».
Précisez la base de données sur laquelle doit s’exécuter le script.

Cliquez sur « Suivant ».
Eventuellement, demandez la journalisation des actions.
Cliquez sur « Suivant ».
Cliquez sur « Exécuter ».

=> La table est mise-à-jour, ainsi que le n° de version dans la table VERSION.

Exécution du script générique en mode batch

Vous pouvez exécuter le script générique en lançant dbtool en mode batch, dans un .bat, par exemple.

Exemple de .bat pour une base 400
dbtool -descfile:"D:\Adelia\scripts génériques\CLIENTS_1.dbd" -logfile:"D:\log\ScriptsGen.txt" -create_tables -dbm:"AS400" -database:"MABIB" -host:"MON400"
-miduser:"user" -midpassword:"pwd" -no_input

Pour plus de précisions, voyez la fiche de l'aide en ligne : « Outil de gestion de bases de données - Mode batch ».