ONYX - 9.0 - Utilisation
Accès aux bases de données
Sommaire
Introduction
Cette documentation décrit les différentes configurations Mapping possibles permettant d’accéder à des bases de données.
Une fois la configuration effectuée au niveau de la configuration générale de Mapping, il est possible de faire des requêtes à partir de M-Connect, M-Designer, ou encore du Workflow.
Certaines bases de données sont accessibles nativement depuis Mapping, c’est le cas d’Oracle sous Unix et MySQL. Pour les autres bases de données, il est nécessaire de passer par une configuration ODBC.
Configuration générale
Généralités
La configuration se trouve dans le fichier mapping.conf, et est accessible via l’interface d’administration ONYX Server : Menu d’administration / Gestion de la configuration / MAPREPORT CONFIG
Une fois la configuration effectuée, il est possible de la tester via la commande map_036 comme suit :
Afficher la liste des tables
#map_036 -mode:1 -database:[nom base ou bibliothèque]
Si la liste des tables de la base de données spécifiée au niveau du paramètre -database s'affiche correctement, c'est que la configuration est bonne et prête à être utilisée.
Exemples :
#map_036 -mode:1 -database:reporting #map_036 -mode:1 -database:QGPL
Pour tester l'exécution d'une requête SQL, il suffit d'utiliser le paramètre -mode:7 comme suit :
#map_036 -mode:7 -cmd="select * from [database].[table]"
Exemple :
#map_036 -mode:7 -cmd="select * from reporting.customers"
Configuration de plusieurs instances sous Linux
Pour utiliser une autre instance d'Oracle, il faut faire :
export MAPREPORT_SERVERADDRESS=nom_de_l_autre_instance export MAPREPORT_SERVERUSER=nom_du_user_oracle export MAPREPORT_SERVERPASSWORD=pwd_du_user_oracle
puis lancer le maprunrpt.
ou Dupliquer le fichier /etc/mapping/mapping.conf en /etc/mapping/mapping.conf_bis
Modifier dans /etc/mapping/mapping.conf_bis
[MAPREPORT_SERVERTYPE] oracle [MAPREPORT_SERVERADDRESS] nom_de_l_instance_ORCL_par_exemple [MAPREPORT_SERVERUSER] nom_du_user_oracle [MAPREPORT_SERVERPASSWORD] pwd_du_user_oracle
Puis faire export MAPPING_PATH=/etc/mapping/mapping.conf_bis puis lancer le maprunrpt
Les différents types de configuration
Configuration ODBC (Windows)
Configuration d'une source de données ODBC
Sous Windows, allez dans le panneau de configuration Outil d’administration / Sources de données (ODBC)
La nouvelle source de données doit être créée dans l’onglet « Sources de données système », afin qu’elle soit utilisable en ligne de commande, mais également par tous les processus Mapping lancés en service.
Cliquez sur Ajouter
Sélectionner le driver désiré.
Exemple de configuration ODBC pour une liaison IBM I (AS400) :
Si ce n'est pas déjà fait, il faut télécharger et installer le driver ODBC "IBM i Access ODBC Driver" à partir du site IBM ACS (IBM i Access Client Solutions). Le driver est présent dans le package des applications pour Windows "ACS Windows App Pkg English (64bit)".
Lien du site valable en mai 2020 : https://www.ibm.com/support/pages/ibm-i-access-client-solutions
- - Downloads for IBM i Access Client Solutions
- - Se connecter et/ou créer un compte si nécessaire
- - Accepter la licence
- - Télécharger le package "ACS Windows App Pkg English (64bit)"
Une fois le téléchargement du package effectué, l'installation se fait en lançant "Image64a\Setup.exe".
Ensuite, ajouter un nouveau connecteur ODBC basé sur le driver "IBM i Access ODBC Driver".
Nom de source de données : Nom libre permettant d’identifier la configuration ODBC
Système : Adresse IP ou nom DNS du serveur IBM i
Le profile utilisateur de connexion n’est pas à définir à ce niveau. Il sera renseigné directement dans la configuration Mapping (mapping.conf)
Attention : dans l’onglet « Serveur », il faut spécifier une bibliothèque par défaut. Cette dernière doit être existante sur le système spécifié.
En cas de problématique liée à des PF avec un CCSID à 65535, il peut être nécessaire d’activer la conversion Ad hoc :
Configuration de MAPPING avec un lien ODBC
Exemple de mapping.conf, section MAPREPORT CONFIG :
[MAPREPORT_SERVERTYPE] odbc [MAPREPORT_SERVERADDRESS] nom_de_l_instance_(AS400 par_exemple) [MAPREPORT_SERVERUSER] profile utilisateur pouvant se connecter à la base de données [MAPREPORT_SERVERPASSWORD] mot de passe de l’utilisateur
Tester la configuration en ligne de commande
Lister les tables de la base d’une base de données : #map_036 -mode:1
Exemple : #map_036 -mode:1 -database:QGPL
Lister le contenu d’une table : #map_036 -mode:5
Exemple : #map_036 -mode:5 -database:QGPL -table:TABLE1
Exécuter une requête : #map_036 -mode:5
Exemple : #map_036 -mode:5 -database:QGPL "-cmd:select * from TABLE1"
ORACLE sous Linux
Configuration
[MAPREPORT_SERVERTYPE] oracle [MAPREPORT_SERVERADDRESS] nom_de_l_instance_ORCL_par_exemple [MAPREPORT_SERVERUSER] nom_du_user_oracle [MAPREPORT_SERVERPASSWORD] pwd_du_user_oracle [ORACLE_HOME] /u01/app/oracle/product/9.0.1
Il faut créer dans de dossier « bin » de Mapping (par défaut /apps/mapping/bin), un lien sur libclntsh.sl qui se nomme liboracle.sl
Attention : lors de la rédaction de cette documents, Mapping étant compilé en 32bits, il faut impérativement utiliser la version 32bits de cette lib
- cd /apps/mapping/bin
- ln -s /u01/app/oracle/product/9.0.1/lib32/libclntsh.sl.9.0 liboracle.sl
Message d'erreur
Si vous avez un problème pour la bibliothèque, contrôler [LIB_PATH] /apps/mapping/bin
Si le message suivant apparaît "Error OCILogon - Error while trying to retrieve text for error ORA-12154", il faut définir la variable d'environnement ORACLE_HOME :
dans le .profile de l'utilisateur lançant le report (mapadmin ou nobodyma) :
export ORACLE_HOME=/u01/app/oracle/product/9.0.1
ou dans la configuration de mapping.conf ajouter
[ORACLE_HOME] 01/app/oracle/product/9.0.1
Si vous avez des problèmes de caractères, vérifier que la variable d’environnement NLS_LANG est correctement définie : NLS_LANG=french_france.WE8ISO8859P15
Informations utiles sur ORACLE
En cas de souci:
Le profil administrateur d'oracle est souvent : oracle
Il faut contrôler les variables d’environnement d’Oracle par la commande "set | grep ORACLE"
La réponse doit être
ORACLE_BASE=/u01/app/oracle ORACLE_DOC=/u01/app/oracle/product/9.0.1/doc ORACLE_HOME=/u01/app/oracle/product/9.0.1 ORACLE_SID=orcl
Le démarrage d'Oracle se fait de la manière suivante (sous le profil oracle, doit être sous SQLPLUS )
sqplplus /nolog connect SYS/change_on_install as SYSDBA startup exit
Le démarrage du listener d'Oracle se fait par " lsnrctl start" sous oracle (Ne doit pas être sous SQLPLUS), ce qui permet la connexion depuis une machine différente.
Test de connexion sous un utilisateur autre que oracle :
"sqlplus user:pwd" se connecte en local
Pour tester la connexion par le listner (méthode de connexion utilisée par MapReport) :
"sqlplus user:pwd@INSTANCE"
Création d'un utilisateur :
"create user map_user IDENTIFIED BY map_user_pwd;" "grant connect,resource to map_user;"
Donner l'autorisation d'utiliser une table d'un autre utilisateur :
"grant SELECT on autre_user.table_autre_user to map_user;"
Donne les tables accessibles du user connecté :"select TABLE_NAME from user_tables;"
Voir les erreurs : "show errors;"
Exécution de la procédure :"EXEC MAPROCEDURE;"
Auto-connexion sans user/login : sqlplus alexis/alexis@ORCL
Liste des procédures disponibles : "SELECT OBJECT_NAME FROM USER_PROCEDURES;"
Suppression d'une procédure : "DROP PROCEDURE MAPROCEDURE;"
Création de la procédure :
CREATE OR REPLACE PROCEDURE MAPROCEDURE AS BEGIN INSERT INTO MATABLE (MYFLOAT) VALUES(1.23); END; RUN MAPROCEDURE; CREATE OR REPLACE PROCEDURE MAPROCEDUREINOUT (valeurin IN NUMBER, valeurout OUT NUMBER) AS BEGIN valeurout := 2 * valeurin; END; RUN MAPROCEDUREINOUT;
Création de la procédure select :
CREATE OR REPLACE PROCEDURE MAPROCEDURESELECT (p_cursor in out types.cursorType) AS BEGIN open p_cursor for SELECT * FROM MATABLE; END; . RUN MAPROCEDURESELECT;
Exécution d’une procédure retournant une valeur :
variable c refcursor exec MAPROCEDURESELECT ( :c ) print c variable c NUMBER exec MAPROCEDURINOUT ( 2 , :c ) print c
Utilisation des procédures dans MapReport
- Cas d'une procédure qui renvoie une table, à mettre dans une table de type SQL dans REPORT, avec pour description d'utilisation.
SQL "BEGIN myprocedure(:mycursor); END;"
!! Attention le mot clé :mycursor est réservé.
- Cas d'une procédure qui renvoie une valeur :
DB.MAVALEUR = SQL "BEGIN myfunc(12); END;"
- Cas d'une procédure qui renvoie plusieurs valeurs :
PARAM ( $DB.RESULTAT , $DB.RESULTAT2 ) SQL "BEGIN MAPROCEDUREINOUT" ( $TRIE.ID , ":param1 , :param2 ) ; END;"
MYSQL
Procédure d'installation de MYSQL sous LINUX
Sous root,
Télécharger la version de MySQL pour votre plateforme
#groupadd mysql #useradd -g mysql mysql #cd /usr/local #gunzip < /path/to/mysql-VERSION-OS.tar.gz | tar xvf - #ln -s full-path-to-mysql-VERSION-OS mysql #cd mysql #scripts/mysql_install_db #chown -R root . #chown -R mysql data #chgrp -R mysql . #bin/safe_mysqld --user=mysql &
Demander à votre administrateur d'ajouter dans les scripts de démarrage de votre machine "bin/safe_mysqld --user=mysql &"
Configuration
Sous Linux :
Ajouter le fichier libstaticmysql.so en version 32 bits dans le dossier « bin » d'ONYX Server [MAPREPORT_SERVERTYPE] mysqlstatic
Sous Windows :
Ajouter le fichier libmysql.dll en version 32 bits dans le dossier « Applications » de Mapping ONYX Server [MAPREPORT_SERVERTYPE] mysql
Indépendamment de la plateforme :
[MAPREPORT_SERVERADDRESS] 127.0.0.1 [MAPREPORT_SERVERPORT] 3306 [MAPREPORT_SERVERUSER] root [MAPREPORT_SERVERPASSWORD] ********
Informations utiles sur MYSQL
Démarrage du serveur MySQL :
cd /usr/local/mysql bin/safe_mysqld --user=mysql &
Arrêt du Serveur :
cd /usr/local/mysql/bin ./mysqladmin shutdown
Lancement d'une session utilisateur :
cd /usr/local/mysql/bin ./mysql
Pour lister les databases :
show databases;
Pour utiliser une base :
use MADATABASE;
Pour lister les tables :
show tables;
Pour voir les informations sur une table :
describe tables;
DB2 UDB (DB2 sur Windows)
Il est possible de connecter un serveur Mapping à une base de données DB2 UDB via une configuration ODBC.
Pour cela, se référer au chapître sur la configuration ODBC.
Particularités : en cas d'invocation d'un service Mapping par WebService SOAP via Apache, il faut ajouter une ligne dans le fichier httpd.conf (apache), dans le bloc <VirtualHost> correspondant au serveur Mapping, afin d'exporter la variable d'environnement %SystemDrive% :
SetEnv SystemDrive "C:"
Remplacer éventuellement C: par la lettre de lecteur correspond au système.
Exemple de bloc dans le fichier httpd.conf avec cette nouvelle ligne :
ServerName mapping-server
Listen 8002
<VirtualHost *:8002>
SetEnv SystemDrive "C:"
DocumentRoot "C:\Mapping\MappingServer\MapHTTPServer"
ScriptAlias /cgi-bin/ "C:\Mapping\MappingServer\MapHTTPServer\cgi-bin\"
<Directory "C:\Mapping\MappingServer\MapHTTPServer">
AuthType Basic
AuthName "Identification"
AuthBasicProvider file
AuthUserFile "C:\Mapping\MappingServer\MapHTTPServer\.htpasswd"
AuthGroupFile "C:\Mapping\MappingServer\MapHTTPServer\.htgroup"
Require valid-user
Options None
</Directory>
</VirtualHost>
