La source SQL (SRC = "SQL") permet la lecture de données dans toute base SQL accessible par un Driver SQL Adélia (Oracle, DB2, SQL Server, ODBC).
Les paramètres reconnus pour la source sont les suivants :
Paramètres en entrée (DATA_SRC)
Nom paramètre |
Type |
Obligatoire |
Description |
DBM |
chaîne |
Oui (*) |
Type (alias) du gestionnaire de bases de données : - DB2 : pilote API pour DB2 UDB, - Oracle : pilote API pour Oracle (8.0 et >), - SQL Server : pilote API pour SQL Server, - ODBC : pilote API pour ODBC. Les valeurs Oracle7 et Oracle8 sont reconnues pour compatibilité avec les scripts existants. |
DLL |
chaîne |
Oui (*) |
Remplacement pour DBM. Permet de spécifier directement un pilote API par le nom de sa DLL (ex : apiora.dll). |
DATABASE DB |
chaîne |
Oui |
Nom, ou URL d'accès de la base de données contenant les données à transférer. |
USER |
chaîne |
Non |
Utilisateur connecté à la base de données. Si ce paramètre n'est pas spécifié, une connexion système sera tentée. |
PASSWORD |
chaîne |
Non |
Mot de passe de l'utilisateur. |
CONNECT |
chaîne |
Non |
Chaîne de connexion à la base de données sous la forme "user.password". Paramètre supporté pour compatibilité ; l'utilisation des paramètres USER et PASSWORD est recommandée. |
CONNECT |
chaîne |
Non |
Chaîne de connexion à la base de données sous la forme "user.password". Si ce paramètre n'est pas spécifié, une connexion système sera tentée. |
REQUEST |
chaîne |
Oui (**) |
Requête SQL produisant l'ensemble des données à exporter. Toute requête SQL valide de type "SELECT" peut être utilisée pour produire les données. |
TABLE |
chaîne |
Oui (**) |
Déprécié : ce paramètre est accepté si le script est en version 1.0. Nom de la table (schéma.nomtable) dont les données doivent être exportées. Raccourci pour (REQUEST="SELECT * FROM schéma.nomtable") |
Paramètres en sortie (DATA_DEST)
Nom paramètre |
Type |
Obligatoire |
Description |
DBM |
chaîne |
Oui (*) |
Type (alias) du gestionnaire de bases de données : - DB2 : pilote API pour DB2 UDB, - Oracle : pilote API pour Oracle (8.0 et >), - SQL Server : pilote API pour SQL Server, - ODBC : pilote API pour ODBC. Les valeurs Oracle7 et Oracle8 sont reconnues pour compatibilité avec les scripts existants. |
DLL |
chaîne |
Oui (*) |
Remplacement pour DBM. Permet de spécifier directement un pilote API par le nom de sa DLL (ex : apiora7.dll). |
DATABASE DB |
chaîne |
Oui |
Nom, ou URL d'accès de la base de données contenant les données à transférer. |
USER |
chaîne |
Non |
Utilisateur connecté à la base de données. Si ce paramètre n'est pas spécifié, une connexion système sera tentée. |
PASSWORD |
chaîne |
Non |
Mot de passe de l'utilisateur. |
CONNECT |
chaîne |
Non |
Chaîne de connexion à la base de données sous la forme "user.password". Paramètre supporté pour compatibilité ; l'utilisation des paramètres USER et PASSWORD est recommandée. |
CONNECT |
chaîne |
Non |
Chaîne de connexion à la base de données sous la forme "user.password". Si ce paramètre n'est pas spécifié, une connexion système sera tentée. |
SCHEMA |
chaîne |
Non |
Schéma propriétaire de la table (version 2.0). |
TABLE |
chaîne |
Oui |
Nom de la table (schéma.nomtable) destinataire des données. Remarque : le format (schéma.nomtable) est supporté pour compatibilité uniquement si la version du script est inférieure à 2.0. Dans le cas contraire, il sera interprété comme un nom SQL long contenant un point. En version 2.0, le schéma propriétaire doit être spécifié dans le paramètre SCHEMA. |
MODE |
chaîne |
Non |
Mode d'insertion des données : - INSERT : les données sont insérées dans la table (défaut). - REPLACE : les données viennent remplacer les données de la table. Une clause de suppression peut alors être spécifiée (DELETE) ; sinon, toutes les données initiales de la table sont supprimées. - UPDATE : les données sont mises à jour ou ajoutées en fonction de la clé primaire de la table. Si la table ne possède pas de clé ou si la clé comprend toutes les colonnes, les données sont ajoutées. - CREATE : la table est recréée à partir des informations en entrée. Cette option n'est possible que si la source des données est capable de décrire précisément la structure de la table à générer. |
DELETE |
chaîne |
Non |
Si la clause de suppression est spécifiée (en mode REPLACE), une requête "DELETE FROM table WHERE clause" sera exécutée avant l'insertion des données. |
COMMIT |
entier |
Non |
Nombre estimé de Ko de données à insérer dans la table entre deux points de validation (Commit). Si ce paramètre n'est pas spécifié, une valeur de "1000" (1 Mo) sera prise par défaut. Une valeur inférieure ou égale à zéro provoquera un fonctionnement en mode AUTOCOMMIT (validation automatique de chaque ligne insérée). |
Notes :
(*) |
Les paramètres DBM et DLL sont mutuellement exclusifs |
(**) |
Les paramètres REQUEST et TABLE sont mutuellement exclusifs |
Cliquez ci-dessous pour plus d'informations sur :