SAP Business Intelligence platform Manuel utilisateur

Guide d'accès aux données
■ SAP BusinessObjects Business Intelligence platform 4.1 Support Package 1
2013-09-19
Copyright
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.Toute reproduction ou communication
de la présente publication, même partielle, par quelque procédé et à quelque fin que ce soit, est
interdite sans l'autorisation expresse et préalable de SAP AG. Les informations contenues dans ce
document peuvent être modifiées par SAP AG sans préavis. Certains logiciels commercialisés par
SAP AG et ses distributeurs contiennent des composants logiciels qui sont la propriété d'éditeurs
tiers. Les spécifications des produits peuvent varier d’un pays à l’autre. Elles sont fournies par SAP
AG et ses filiales (« Groupe SAP ») uniquement à titre informatif, sans engagement ni garantie
d'aucune sorte. Le Groupe SAP ne pourra en aucun cas être tenu responsable des erreurs ou
omissions relatives à ces informations. Les seules garanties fournies pour les produits et les services
du Groupe SAP sont celles énoncées expressément à titre de garantie accompagnant, le cas échéant,
lesdits produits et services. Aucune des informations contenues dans ce document ne saurait
constituer une garantie supplémentaire. SAP et tous les autres produits et services SAP mentionnés
dans ce document, ainsi que leurs logos respectifs, sont des marques commerciales ou des marques
déposées de SAP AG en Allemagne ainsi que dans d'autres pays. Pour plus d'informations sur les
marques déposées, voir http://www.sap.com/france/about-sap/legal/copyright.epx.
2013-09-19
Table des matières
3
Chapitre 1
Historique des versions du document...................................................................................13
Chapitre 2
Introduction au guide d'accès aux données..........................................................................17
2.1
2.2
2.3
2.4
A propos de ce guide.............................................................................................................17
Chapitre 3
Introduction à l'accès aux données.......................................................................................19
3.1
3.2
3.2.1
3.2.2
3.3
3.3.1
3.3.2
3.4
3.5
3.6
A propos du serveur de connexion.........................................................................................19
Chapitre 4
Spécificités de l'accès aux données.....................................................................................27
4.1
4.1.1
4.1.2
4.1.3
4.2
4.3
4.3.1
4.3.2
4.3.3
4.3.4
4.3.5
Prise en charge des systèmes d'exploitation 64 bits..............................................................27
Public.....................................................................................................................................17
Tâches clés............................................................................................................................17
Conventions exposées dans ce guide....................................................................................18
Composants d'une connexion................................................................................................19
Architecture du système........................................................................................................20
Pilotes d'accès aux données..................................................................................................20
Fichiers de configuration d'accès aux données.......................................................................21
A propos du fichier de configuration globale cs.cfg.................................................................22
A propos des fichiers de configuration de pilote.....................................................................22
Mode de déploiement............................................................................................................24
Services de connectivité........................................................................................................25
Connexions OLAP.................................................................................................................26
Prise en charge d'UNIX 64 bits..............................................................................................27
Prise en charge de Microsoft Windows 64 bits......................................................................28
Installation des pilotes ODBC................................................................................................29
Prise en charge de la connexion unique..................................................................................29
Procédures stockées.............................................................................................................31
Fonctionnalités de base de données prises en charge............................................................32
Procédures stockées Oracle..................................................................................................32
Pour créer un curseur dans un package.................................................................................33
Pour créer une procédure stockée Oracle..............................................................................33
Procédures stockées SAP HANA..........................................................................................34
2013-09-19
Table des matières
4
4.3.6
4.4
4.4.1
4.4.2
4.4.3
4.5
4.5.1
4.5.2
4.5.3
4.6
4.6.1
4.6.2
4.7
Macros Teradata....................................................................................................................34
Chapitre 5
Création d'une connexion.....................................................................................................41
5.1
5.2
5.2.1
5.2.2
5.2.3
5.2.4
5.2.5
5.2.6
5.2.7
5.2.8
5.2.9
5.2.10
5.2.11
5.3
5.3.1
5.3.2
5.3.3
5.3.4
5.3.5
5.3.6
5.4
5.4.1
5.4.2
5.4.3
5.5
5.5.1
Conditions requises pour la connexion...................................................................................41
Pools de connexions..............................................................................................................35
A propos des connexions du pool..........................................................................................35
Mode de pool de connexions.................................................................................................36
Vérification du pool de connexions du middleware.................................................................37
Equilibrage de charge.............................................................................................................37
Recherche du serveur le mieux adapté...................................................................................37
Logique d'équilibrage de charge.............................................................................................38
Rétrocompatibilité..................................................................................................................39
Allocation de mémoire............................................................................................................39
Pour activer HOARD..............................................................................................................39
Pour désactiver HOARD........................................................................................................40
Activité sur le poste de travail CA Wily Introscope.................................................................40
Vérification de la configuration de la connexion......................................................................41
Affichage de l'aide sur l'outil cscheck.....................................................................................42
Pour exécuter l'outil cscheck..................................................................................................43
Outil de vérification : présentation des fonctions....................................................................43
Outil de vérification : list.........................................................................................................44
Outil de vérification : driverssearch........................................................................................45
Outil de vérification : find........................................................................................................46
Outil de vérification : middleware............................................................................................48
Outil de vérification : accessdriver..........................................................................................49
Outil de vérification : connectivity...........................................................................................50
Outil de vérification : ping ......................................................................................................51
Outil de vérification : Informations du CMS............................................................................54
Création de connexions JDBC ..............................................................................................55
Création d'une connexion JDBC avec le fichier SBO.............................................................56
Exemple de structure de fichiers SBO JDBC.........................................................................57
Création d'une connexion JDBC avec le paramètre Extensions..............................................57
Pour créer une connexion Generic JDBC...............................................................................58
Informations de référence sur l'emplacement des fichiers JAR...............................................59
Pour rechercher la version d'un pilote JDBC..........................................................................62
Création de connexions JavaBean.........................................................................................63
Création d'une connexion JavaBean.......................................................................................64
Exemple de structure de fichiers SBO JavaBean ...................................................................65
Création d'une connexion JavaBean avec le paramètre Extensions........................................65
Création de connexions ODBC..............................................................................................66
Création d'une connexion Generic ODBC..............................................................................67
2013-09-19
Table des matières
5
5.5.2
Création d'une connexion Generic ODBC3............................................................................68
Chapitre 6
Informations de référence sur le pilote d'accès aux données...............................................71
6.1
6.2
6.2.1
6.2.2
6.2.3
6.2.4
6.3
6.3.1
6.3.2
6.3.3
6.3.4
6.3.5
6.3.6
6.3.7
6.3.8
6.3.9
6.3.10
6.3.11
6.3.12
6.3.13
6.3.14
6.4
6.4.1
6.4.2
6.4.3
6.4.4
6.5
6.5.1
6.5.2
6.5.3
6.5.4
6.5.5
6.5.6
6.5.7
6.5.8
6.5.9
6.5.10
6.5.11
Pilotes d'accès aux données..................................................................................................71
CSV OpenDriver....................................................................................................................71
Fonctionnalités CSV OpenDriver...........................................................................................72
CSV OpenDriver : Mappage de tables...................................................................................72
Emplacement du fichier CSV..................................................................................................74
Détection du schéma CSV.....................................................................................................74
Pilote OData..........................................................................................................................76
Fonctionnalités du pilote OData.............................................................................................77
Emplacement du service Northwind.......................................................................................78
Exemple de service OData.....................................................................................................78
Pilote OData : Mappage des espaces de noms, des propriétaires et des qualificateurs.........80
Pilote OData : Mappage des tables........................................................................................80
Pilote OData : Mappage des colonnes...................................................................................81
Pilote OData : Mappage des clés...........................................................................................82
Pilote OData : Mappage des éléments de documentation......................................................84
Pilote OData : Mappage des entités de types dérivés............................................................84
Surveillance des performances du pilote OData.....................................................................85
Pilote OData : Restrictions et comportements non triviaux.....................................................87
Pilote OData : Configuration de la taille maximale de la colonne ............................................88
Authentification des sources OData.......................................................................................89
Suivi des activités du pilote OData.........................................................................................89
Pilote SAP ERP......................................................................................................................90
Fonctionnalités du pilote SAP ERP.........................................................................................90
Pilote SAP ERP : Accès aux requêtes SAP et InfoSets..........................................................91
Pilote SAP ERP : Accès aux fonctions ABAP.........................................................................93
Restrictions relatives au pilote SAP ERP................................................................................96
Pilote XML.............................................................................................................................96
Fonctionnalités du pilote XML................................................................................................97
Emplacement du fichier XML..................................................................................................97
Exemple de document et de schéma XML..............................................................................98
Pilote XML : Mappage de plusieurs fichiers..........................................................................100
Pilote XML : Mappage des tables.........................................................................................100
Pilote XML : Mappage des colonnes....................................................................................101
Pilote XML : Mappage des clés primaires et étrangères.......................................................103
Pilote XML : Mappage des éléments mixtes.........................................................................104
Pilote XML : Mappage des éléments récursifs.....................................................................105
Pilote XML : Mappage des éléments any et anyAttribute.....................................................105
Pilote XML : Mappage des éléments anyType et simpleType...............................................107
2013-09-19
Table des matières
6
6.5.12
6.6
6.6.1
6.6.2
6.6.3
6.6.4
6.6.5
6.7
Pilote XML : Configuration de la taille maximale de la colonne .............................................108
Chapitre 7
Informations de référence sur la connexion........................................................................117
7.1
7.1.1
7.1.2
7.2
7.3
7.3.1
7.3.2
7.4
7.5
7.6
7.6.1
7.6.2
7.7
7.8
7.9
7.10
7.10.1
7.10.2
7.11
7.11.1
7.12
7.13
7.13.1
7.13.2
7.13.3
7.13.4
7.13.5
7.13.6
7.13.7
7.14
7.15
Connexions HIVE.................................................................................................................117
Pilote de services Web........................................................................................................108
Fonctionnalités du pilote de services Web............................................................................109
Emplacement des services Web..........................................................................................109
Exemple de définition de services Web ...............................................................................110
Mappage des règles pour les services Web.........................................................................112
Pilote du service Web : Configuration de la taille maximale de la colonne ............................115
Disque local utilisé en tant que cache pour les opérations de tri...........................................115
Pour créer une connexion à Apache Hadoop HIVE...............................................................117
Pour créer une connexion à Amazon EMR HIVE...................................................................120
Connexions IBM DB2 : Clés de référence mappées à une valeur nulle................................120
Connexions IBM Informix.....................................................................................................121
Problèmes de valeurs de date avec différents fuseaux horaires............................................121
Echec de connexion lorsque le mode Transaction n'est pas pris en charge..........................121
Connexions MS Analysis Services.......................................................................................122
Connexions MS SQL Server : Définition des options de JVM.............................................122
Connexions Oracle...............................................................................................................123
Connexions aux clusters de serveurs Oracle........................................................................123
Pour définir la valeur de paramètre CURSOR_SHARING Oracle..........................................124
Connexions Oracle EBS.......................................................................................................124
Connexions Oracle Essbase.................................................................................................125
Connexions Oracle RAC......................................................................................................125
Connexions salesforce.com : Configuration de l'environnement...........................................126
Fonctionnement des connexions salesforce.com dans l'outil de conception d'information.....126
Fonctionnement des connexions salesforce.com dans l'outil de conception d'univers..........127
Connexions SAP BW...........................................................................................................127
Pour activer les connexions SAP BW 64 bits.......................................................................128
Connexions SAP ERP : Echec de chargement du pilote.......................................................128
Connexions SAP HANA.......................................................................................................129
Création d'une connexion SAP HANA..................................................................................130
Modification d'une connexion SAP HANA............................................................................131
Avant de configurer la connexion unique pour les connexions SAP HANA...........................131
Pour configurer la connexion unique pour l'outil de conception d'information........................132
Pour configurer la connexion unique pour Web Intelligence..................................................134
Pour configurer la connexion unique pour Web Intelligence Rich Client................................134
Pour configurer la JVM (Java Virtual Machine) pour l'instrumentation..................................135
Connexions SAP MaxDB.....................................................................................................135
Connexions SAP NetWeaver BW........................................................................................136
2013-09-19
Table des matières
7
7.15.1
7.15.2
7.15.3
7.16
7.16.1
7.17
Configuration requise pour la connexion de Data Federator à SAP NetWeaver BW.............136
Chapitre 8
Création d'une connexion au serveur de requêtes Data Federator XI 3.0...........................139
8.1
8.2
A propos des connexions au serveur de requêtes Data Federator XI 3.0.............................139
8.3
8.3.1
8.3.2
8.4
Configuration des connexions ODBC Data Federator..........................................................140
8.4.1
Configuration du middleware ODBC Data Federator pour une connexion à Web Intelligence Rich
Client...................................................................................................................................143
8.4.2
Configuration du serveur de connexion pour une connexion Web Intelligence Rich Client à
Data Federator.....................................................................................................................144
8.4.3
8.4.4
Définition de la clé de registre Windows RichClient .............................................................144
Chapitre 9
Configuration des paramètres globaux d'accès aux données.............................................147
9.1
9.2
9.3
9.4
9.5
9.5.1
9.5.2
9.5.3
9.5.4
9.5.5
9.5.6
9.5.7
9.5.8
9.5.9
9.5.10
9.5.11
A propos des paramètres globaux........................................................................................147
Conditions pour le fonctionnement de connexions dans l'outil de conception d'information...137
Conditions pour l'accès à des univers à plusieurs sources de SAP NetWeaver BW.............137
Connexions SAS..................................................................................................................137
Installation de pilotes pour les connexions SAS....................................................................138
Connexions Teradata : Mappage de la base de données Teradata au propriétaire actuel .....138
Configuration de l'Assistant de connexion pour une connexion JDBC ou ODBC Data
Federator.............................................................................................................................140
Configuration du middleware ODBC Data Federator ...........................................................141
Configuration du serveur de connexion pour une connexion ODBC Data Federator.............141
Configuration des connexions Web Intelligence Rich Client à l'aide du middleware ODBC
Data Federator.....................................................................................................................142
Configuration du serveur de connexion pour les connexions de Web Intelligence Rich Client ou
de l'outil de conception d'univers à Data Federator..............................................................144
A propos du fichier de configuration cs.cfg...........................................................................147
A propos du fichier de configuration OlapClient.cfg..............................................................148
Pour afficher et modifier le fichier cs.cfg...............................................................................148
Configuration des paramètres globaux.................................................................................149
Charset List Extension.........................................................................................................149
Config File Extension............................................................................................................150
Description Extension..........................................................................................................150
Ignore Driver Load Failure....................................................................................................150
Load Drivers On Startup......................................................................................................151
Max Pool Time.....................................................................................................................152
Configuration de l'extension de fichier..................................................................................152
SQL External Extension........................................................................................................153
SQL Parameter Extension....................................................................................................153
Strategies Extension............................................................................................................154
Validate Configuration Files..................................................................................................154
2013-09-19
Table des matières
8
9.5.12
9.6
9.7
9.8
9.8.1
9.9
9.10
9.10.1
9.10.2
9.10.3
9.10.4
9.10.5
9.11
9.11.1
Validation des flux XML........................................................................................................154
Chapitre 10
Configuration des paramètres du pilote d'accès aux données...........................................167
10.1
10.1.1
10.1.2
10.1.3
10.1.4
10.1.5
10.1.6
10.2
10.2.1
Configuration des paramètres du pilote................................................................................167
Chapitre 11
Informations de référence sur les paramètres SBO............................................................179
11.1
11.2
11.3
11.3.1
11.3.2
11.3.3
11.3.4
11.3.5
11.3.6
11.3.7
11.3.8
11.3.9
11.3.10
Structure du fichier SBO......................................................................................................179
Définition du mode de déploiement......................................................................................155
Configuration du mode de déploiement................................................................................156
Configuration des pilotes à charger......................................................................................156
Définition d'une connectivité par ordinateur..........................................................................157
Configuration des protocoles d'accès CORBA.....................................................................157
Activation des journaux et des traces des pilotes et du serveur de connexion......................158
A propos du fichier de configuration _trace.ini......................................................................158
Activation des journaux et des traces dans le fichier cs.cfg..................................................162
Pour activer les journaux et les traces en mode Bibliothèque...............................................162
Pour activer les journaux et les traces en mode Serveur......................................................163
Lecture des journaux et des traces......................................................................................163
Activation des journaux et des traces pour le client OLAP ...................................................164
Exemple de journal...............................................................................................................165
Fichiers de configuration d'accès aux données.....................................................................167
Fichiers SBO installés..........................................................................................................168
Pour afficher et modifier les fichiers SBO.............................................................................174
Personnalisation des fichiers SBO ......................................................................................174
Vérification dynamique des connexions................................................................................175
Propriétés du pilote JDBC...................................................................................................176
A propos des pilotes ODBC DataDirect ..............................................................................176
Pour activer l'utilisation de pilotes de marque DataDirect.....................................................177
Description des paramètres SBO.........................................................................................180
Paramètres SBO communs..................................................................................................181
Array Bind Available.............................................................................................................182
Array Bind Size....................................................................................................................182
Array Fetch disponible..........................................................................................................182
Taille de l'Array fetch............................................................................................................183
Taille d'affichage maximale en BigDecimal............................................................................185
Binary Max Length...............................................................................................................185
Paramètre Bucket Split Size.................................................................................................186
Séparateur de catalogue......................................................................................................186
CharSet Table......................................................................................................................187
Description File....................................................................................................................187
2013-09-19
Table des matières
11.3.11
11.3.12
11.3.13
11.3.14
11.3.15
11.3.16
11.3.17
11.3.18
11.3.19
11.3.20
11.3.21
11.3.22
11.3.23
11.3.24
11.3.25
11.3.26
11.3.27
11.3.28
11.3.29
11.3.30
11.3.31
11.3.32
11.3.33
11.3.34
11.3.35
11.3.36
11.3.37
11.3.38
11.3.39
11.3.40
11.3.41
11.4
11.4.1
11.5
11.5.1
11.6
11.6.1
11.6.2
11.6.3
11.6.4
11.6.5
9
Dictionary Transaction Mode................................................................................................188
Capacités du pilote..............................................................................................................188
Nom du pilote......................................................................................................................189
Caractère d'échappement....................................................................................................189
Extensions...........................................................................................................................190
Family..................................................................................................................................190
Forcer l'exécution.................................................................................................................190
Casse de l'identificateur.......................................................................................................191
Chaîne de signal des identificateurs.....................................................................................192
Inclusion de synonymes.......................................................................................................192
Integer Max Length..............................................................................................................192
Introscope Available.............................................................................................................193
Nombre maximal de lignes disponibles.................................................................................194
Native Int64 Available...........................................................................................................194
Optimize Execute.................................................................................................................194
Propriétaires disponibles......................................................................................................195
Qualificateurs disponibles.....................................................................................................195
Expiration de la requête disponible.......................................................................................196
Mise entre guillemets des identificateurs..............................................................................196
Skip SAML SSO..................................................................................................................197
Fichier SQL externe.............................................................................................................197
SQL Parameter File..............................................................................................................198
Connexion unique disponible................................................................................................198
Strategies File......................................................................................................................199
String Max Length................................................................................................................199
Temp Data Dir......................................................................................................................200
Mode de transaction disponible............................................................................................201
Type.....................................................................................................................................202
Unicode...............................................................................................................................202
Format d'URL.......................................................................................................................203
Taille maximale des données XML........................................................................................204
Paramètres SBO JavaBean..................................................................................................204
Classe JavaBean.................................................................................................................204
Paramètres SBO JCO.........................................................................................................205
ERP Max Rows....................................................................................................................205
Paramètres SBO JDBC.......................................................................................................205
Connexion partageable.........................................................................................................206
Caractère d'échappement disponible (Escape Character Available)......................................206
Clés étrangères disponibles.................................................................................................207
Obtention d'une colonne étendue.........................................................................................207
Classe JDBC.......................................................................................................................208
2013-09-19
Table des matières
10
11.6.6
11.6.7
11.6.8
11.6.9
11.6.10
11.7
11.7.1
11.8
11.8.1
11.8.2
11.8.3
11.8.4
11.8.5
11.8.6
11.8.7
11.8.8
11.8.9
11.9
11.9.1
11.9.2
11.10
11.10.1
11.11
11.11.1
11.11.2
11.11.3
11.11.4
11.11.5
11.12
11.12.1
Clés primaires disponibles....................................................................................................208
Chapitre 12
Configuration des paramètres de fonctionnalités des bases de données..........................223
12.1
12.2
12.2.1
12.3
12.4
12.5
A propos des paramètres de fonctionnalités des bases de données....................................223
Paramètres régionaux de visualisation préférés disponibles.................................................208
Connexion partagée.............................................................................................................209
JDBC ResultSet Type..........................................................................................................209
JDBC ResultSet Concurrency.............................................................................................210
Paramètres SBO OData.......................................................................................................211
Enforce Max Protocol Version..............................................................................................211
Paramètres SBO ODBC......................................................................................................211
Jeu de caractères................................................................................................................212
Statut de connexion disponible.............................................................................................212
Coût estimé disponible.........................................................................................................213
Chaîne vide..........................................................................................................................213
ODBC Cursors....................................................................................................................213
SQLDescribeParam disponible.............................................................................................214
SQLMoreResults disponible.................................................................................................214
Utilisation du pilote OEM DataDirect ...................................................................................215
V5toV6DriverName.............................................................................................................215
Paramètres SBO OLE DB....................................................................................................216
Enumerator CLSID...............................................................................................................216
Provider CLSID....................................................................................................................216
Paramètres SBO OLE DB OLAP..........................................................................................217
MSOlap CLSID....................................................................................................................217
Paramètres SBO Sybase.....................................................................................................217
Comportement des pilotes...................................................................................................218
Cryptage du mot de passe...................................................................................................218
Identificateur entre guillemets...............................................................................................219
Reprise sur erreur................................................................................................................219
Taille du texte.......................................................................................................................219
Paramètres SBO Teradata ..................................................................................................220
Replace Current Owner With Database...............................................................................220
A propos des fichiers PRM..................................................................................................223
Structure de fichier de paramètres PRM..............................................................................224
Pour afficher et modifier des fichiers PRM...........................................................................225
Pour afficher et modifier un fichier texte d'aide sur les fonctions..........................................226
Pour modifier le texte d'aide d'une fonction PRM.................................................................226
2013-09-19
Table des matières
11
Chapitre 13
Informations de référence sur les paramètres PRM............................................................229
13.1
13.1.1
13.1.2
13.1.3
13.1.4
13.1.5
13.1.6
13.1.7
13.1.8
13.1.9
13.1.10
13.1.11
13.1.12
13.1.13
13.1.14
13.1.15
13.1.16
13.1.17
13.1.18
13.1.19
13.1.20
13.1.21
13.1.22
13.1.23
13.1.24
13.1.25
13.1.26
13.1.27
13.1.28
13.1.29
13.1.30
13.1.31
13.1.32
13.1.33
13.1.34
13.1.35
13.1.36
13.1.37
13.1.38
Informations de référence sur la configuration de fichier PRM..............................................229
ANALYTIC_CLAUSE...........................................................................................................229
ANALYTIC_FUNCTIONS.....................................................................................................230
CALCULATION_FUNCTION................................................................................................230
CONSTANT_SAMPLING_SUPPORTED..............................................................................231
DISTINCT............................................................................................................................231
EXT_JOIN............................................................................................................................232
FULL_EXT_JOIN..................................................................................................................232
GROUP_BY.........................................................................................................................233
GROUP_BY_SUPPORTS_COLUMN_INDEX......................................................................233
GROUP_BY_SUPPORTS_COMPLEX.................................................................................234
GROUP_BY_SUPPORTS_CONSTANT...............................................................................235
HAVING...............................................................................................................................235
INTERSECT.........................................................................................................................235
INTERSECT_ALL.................................................................................................................236
INTERSECT_IN_SUBQUERY...............................................................................................236
JOIN....................................................................................................................................237
LEFT_EXT_JOIN...................................................................................................................237
LEFT_OUTER.......................................................................................................................238
LIKE_SUPPORTS_ESCAPE_CLAUSE.................................................................................238
MINUS.................................................................................................................................239
MINUS_ALL........................................................................................................................239
MINUS_IN_SUBQUERY......................................................................................................240
ORDER_BY.........................................................................................................................240
ORDER_BY_REQUIRES_SELECT........................................................................................241
ORDER_BY_SUPPORTS_COLUMN_INDEX.......................................................................241
PERCENT_RANK_SUPPORTED..........................................................................................242
RANK_SUPPORTED...........................................................................................................242
RIGHT_EXT_JOIN................................................................................................................243
RIGHT_OUTER....................................................................................................................243
SEED_SAMPLING_SUPPORTED........................................................................................244
SELECT_SUPPORTS_NULL................................................................................................244
SUBQUERY_IN_FROM.......................................................................................................245
SUBQUERY_IN_IN..............................................................................................................245
SUBQUERY_IN_WHERE.....................................................................................................245
TECHNICAL_COLUMN_NAME_PATTERN..........................................................................246
UNION.................................................................................................................................246
UNION_ALL.........................................................................................................................247
UNION_IN_SUBQUERY......................................................................................................247
2013-09-19
Table des matières
Chapitre 14
Informations de référence sur la conversion du type de données......................................249
14.1
14.1.1
14.1.2
14.1.3
14.1.4
14.1.5
14.1.6
14.1.7
14.1.8
14.1.9
14.1.10
14.2
14.3
Conversion du type de données ..........................................................................................249
Annexe A
Informations supplémentaires.............................................................................................269
Index
12
Types de données du fichier CSV........................................................................................250
Types de données JDBC.....................................................................................................251
Types de données ODBC....................................................................................................254
Types de données OData.....................................................................................................257
Types de données OLE DB..................................................................................................258
Types de données Oracle OCI.............................................................................................260
Types de données SAP ERP................................................................................................261
Types de données SAP HANA.............................................................................................262
Types de données Sybase CTL............................................................................................263
Types de données XML.......................................................................................................265
Restriction des volumineuses de longueur variable...............................................................266
Mappage du type de données pour les univers multi-sources...............................................266
271
2013-09-19
Historique des versions du document
Historique des versions du document
Le tableau suivant fournit un récapitulatif des principales modifications effectuées dans le document :
13
2013-09-19
Historique des versions du document
Version
Date
Modifications
Nouveaux pilotes OData, XML et de services Web, voir Pilotes
d'accès aux données.
Pour la prise en charge de la connexion unique pour Teradata 13,
Teradata 14 et Sybase IQ, voir Prise en charge de la connexion
unique.
Pour la prise en charge des procédures stockées SAP HANA,
voir Procédures stockées SAP HANA.
Pour les connexions SAP ERP, le mappage simplifié des colonnes
d'entrée facultatives, voir Pilote SAP ERP : Accès aux fonctions
ABAP.
Pour les connexions SAP HANA, la prise en charge de la nouvelle
version SAP HANA SPS 05, les connexions OLAP, la connexion
unique via le protocole SAML, le protocole SSL et les plateformes
UNIX 64 bits via ODBC, voir Connexions SAP HANA.
Plateforme SAP BusinessObjects Business Intelligence 4.1
Mai
2013
Prise en charge des connexions HIVE 0.9 via JDBC, voir Connexions HIVE.
Nouvel outil de journalisation pour l'activité du serveur de connexion, voir Activation des journaux et des traces des pilotes et
du serveur de connexion.
Pour savoir comment activer les journaux du client OLAP, voir
Activation des journaux et des traces pour le client OLAP .
Prise en charge des pilotes ODBC DataDirect 7.0, voir A propos
des pilotes ODBC DataDirect .
Nouveau paramètre SBO pour les pilotes d'accès aux données,
voir Dictionary Transaction Mode.
Nouveaux paramètres SBO pour les connexions MySQL, voir
JDBC ResultSet Type et JDBC ResultSet Concurrency.
Nouveau paramètre SBO pour les connexions Teradata, voir
Replace Current Owner With Database.
Nouveau paramètre SBO pour ignorer le protocole SAML avec
des connexions SAP HANA, voir Skip SAML SSO.
14
2013-09-19
Historique des versions du document
Version
Date
Modifications
D'autres connectivités sont disponibles. Pour en savoir plus, voir
la Product Availability Matrix (matrice de disponibilité des produits).
Pour la description du mode de pool de connexions, voir Mode
de pool de connexions.
Pour vérifier les connexions stockées sur le CMS, voir Outil de
vérification : Informations du CMS.
Pour trouver la version du pilote JDBC, voir Pour rechercher la
version d'un pilote JDBC.
Pour ajuster le délai d'expiration de la connexion OData afin
d'améliorer les performances, voir Surveillance des performances
du pilote OData.
Pour la prise en charge des connexions en fonction des différentes
versions de la base de données HIVE, voir Connexions HIVE.
Plateforme SAP BusinessObjects Business Intelligence 4.1
Support Package 1
Pour le paramètre UNIX pour les connexions MS SQL Server,
voir Connexions MS SQL Server : Définition des options de JVM.
Août2013
Pour définir la valeur de paramètre CURSOR_SHARING, voir Connexions Oracle.
Pour la prise en charge des connexions 64 bits par SAP BW pour
les univers .unv, voir Connexions SAP BW.
Si le pilote SAP ERP ne se charge pas, voir Connexions SAP
ERP : Echec de chargement du pilote.
Pour la prise en charge de la base de données SAP HANA 1.0 SPS 06, voir Connexions SAP HANA.
Pour les exigences de sécurité correspondant aux connexions
SAP NetWeaver BW, voir Connexions SAP NetWeaver BW.
Pour l'exemple de fichier cs.cfg du serveur de connexion en
mode serveur, voir Définition du mode de déploiement.
Pour le format de date à utiliser dans les requêtes aux systèmes
SAP ERP, voir Types de données SAP ERP.
Pour les types de données SAP HANA et leur équivalent dans
les fondations de données, voir Types de données SAP HANA.
15
2013-09-19
Historique des versions du document
16
2013-09-19
Introduction au guide d'accès aux données
Introduction au guide d'accès aux données
2.1 A propos de ce guide
Le Guide d'accès aux données vous fournit des informations sur les fonctionnalités du serveur de
connexion et vous explique comment le configurer pour que la plateforme SAP BusinessObjects
Business Intelligence 4.1 SP1 puisse se connecter aux bases de données de production.
Le Guide d'accès aux données vous fournit les informations suivantes :
• Notions de base du serveur de connexion
• En savoir plus sur les pilotes d'accès aux données pour les sources de données CSV, OData, SAP
ERP et XML.
• Création d'une connexion JDBC, ODBC ou Javabean
• Configuration des paramètres d'accès aux données
Remarque :
Il fournit également des informations sur la configuration de certaines connexions relationnelles qui
reposent sur le service de fédération de données et sur des connexions OLAP.
2.2 Public
Le Guide d'accès aux données est destiné au public suivant :
•
•
utilisateurs de l'application SAP BusinessObjects chargés de créer des connexions à des sources
de données
administrateurs système responsables de la configuration et de la gestion d'une installation de la
plateforme de BI
2.3 Tâches clés
Le Guide d'accès aux données fournit des informations clés pour gérer les paramètres de configuration
et établir les connexions. Pour chacune des tâches suivantes, consultez la section correspondante
ci-dessous.
17
2013-09-19
Introduction au guide d'accès aux données
•
•
•
•
•
•
Comment définir le mode de fonctionnement du serveur ?
Comment sélectionner les pilotes à charger ?
Comment configurer les pilotes d'accès aux données ?
Comment vérifier la configuration de la connexion ?
Comment créer des connexions JDBC ?
Comment créer des connexions SAP HANA ?
Remarque :
Pour les tâches d'administration telles que le démarrage et l'arrêt du serveur de connexion, la gestion
des propriétés et des métriques, consultez le Guide d'administration de la plateforme de Business
Intelligence.
Rubriques associées
• Configuration du mode de déploiement
• Configuration des pilotes à charger
• Pour afficher et modifier les fichiers SBO
• Pour exécuter l'outil cscheck
• Création de connexions JDBC
• Connexions SAP HANA
2.4 Conventions exposées dans ce guide
Dans ce guide, la variable rép-install-connectionserver correspond au chemin d'installation
racine des fichiers d'accès aux données utilisés par les outils client de SAP BusinessObjects. Sous
Microsoft Windows, le répertoire rép-install-connectionserver par défaut correspond à
C:\Program Files\SAP Business Objects\SAP BusinessObjects
Enterprise XI 4.0\dataAccess.
La variable rép-install-pbi correspond au chemin d'installation racine de la plateforme de BI ou
des outils client. Sous MS Windows (64 bits), elle correspond au répertoire C:\Program Files
(x86)\SAP Business Objects\SAP BusinessObjects Enterprise XI 4.0.
Attention :
Dans les fichiers de configuration d'accès aux données, utilisez le caractère d'échappement \ avec la
barre oblique inverse \ dans les chemins d'accès aux fichiers si vous déployez la plateforme de BI
sous Microsoft Windows.
18
2013-09-19
Introduction à l'accès aux données
Introduction à l'accès aux données
3.1 A propos du serveur de connexion
Connection Server est un logiciel d'accès aux données qui gère la connexion entre l'application
SAP BusinessObjects et une source de données.
Le serveur de connexion permet à des applications telles que l'outil de conception d'univers, l'outil de
conception d'information et SAP BusinessObjects Web Intelligence de se connecter à une source de
données et d'exécuter des requêtes par rapport à cette source de données.
Le serveur de connexion ne dispose pas d'une interface utilisateur. Vous créez et administrez des
connexions à partir de l'interface utilisateur de ces applications ou en modifiant les fichiers de
configuration Connection Server.
•
Création de connexions
Vous créez des connexions à l'aide de l'Assistant de connexion des outils client de la plateforme
de BI.
Remarque :
L'Assistant de connexion de l'outil de conception d'univers est l'Assistant de création de connexion.
Dans l'outil de conception d'information, il peut s'agir soit de l'Assistant de création de connexion
relationnelle, soit de l'Assistant de création de connexion OLAP. Consultez les guides utilisateur de
l'application pour savoir comment utiliser l'Assistant de connexion.
•
Optimisation de l'accès aux données
: vous pouvez optimiser la transmission des données via le serveur de connexion en modifiant les
fichiers de configuration d'accès aux données. Il s'agit de fichiers au format XML installés avec le
serveur de connexion. Vous pouvez définir les valeurs de paramètres pour qu'elles s'appliquent à
un pilote d'accès aux données spécifique ou à tous les pilotes installés.
3.2 Composants d'une connexion
Une connexion d'accès aux données intègre les composants suivants :
• Connection Server est le logiciel qui gère la connexion entre l'application et la source de données.
Par exemple, le serveur de connexion traite les requêtes de données provenant de l'application.
19
2013-09-19
Introduction à l'accès aux données
•
Un pilote d'accès aux données est un composant logiciel spécifique à la base de données qui gère
la connexion entre Connection Server et le middleware de base de données.
•
Les fichiers de configuration définissent les paramètres permettant de configurer la connexion entre
les systèmes suivants :
• L'application et le serveur de connexion
•
L'application et le pilote d'accès aux données
•
Le serveur de connexion et le pilote d'accès aux données
3.2.1 Architecture du système
Le diagramme ci-dessous décrit comment le serveur de connexion et les pilotes d'accès aux données
s'intègrent dans une configuration SAP BusinessObjects.
3.2.2 Pilotes d'accès aux données
20
2013-09-19
Introduction à l'accès aux données
Les pilotes d'accès aux données établissent la connexion entre le serveur de connexion et la source
de données. Pour pouvoir être accessible depuis une application SAP BusinessObjects, la base de
données doit être associée à un pilote d'accès aux données.
Les applications SAP BusinessObjects incluent des pilotes d'accès aux données permettant de configurer
les connexions aux bases de données. Les pilotes fournis dépendent du type de licence dont vous
disposez.
Avant de pouvoir créer une connexion à une base de données pour laquelle vous ne disposez pas de
pilote, vous devez vous procurer les pilotes requis. Pour cela, les options suivantes s'offrent à vous :
•
Contactez votre représentant SAP pour savoir si un pilote est disponible et si votre licence vous
autorise à l'utiliser.
•
Utiliser le kit de développement de pilote (Driver Development Kit, DDK) pour mettre au point un
pilote à utiliser. Pour en savoir plus, contactez votre représentant SAP.
Lorsque vous créez une connexion, vous sélectionnez le pilote d'accès aux données correspondant à
la source de données cible. Par exemple, si vous accédez à une base de données Oracle 10g, vous
devez installer le middleware approprié (client Oracle 10g), puis le pilote d'accès aux données Oracle
de SAP BusinessObjects.
Attention :
Les pilotes d'accès aux données bean Excel (bean_excel.jar) et CSV (dbd_open_sample.jar)
sont des exemples de pilotes. Vous ne devez pas les utiliser tels quels mais comme points de départ
pour développer des pilotes plus complexes à l'aide du Driver Development Kit.
Pour obtenir la liste la plus récente des pilotes d'accès aux données pris en charge, visitez le site
SAP Service MarketPlace à l'adresse http://service.sap.com/bosap-support ou contactez votre
représentant SAP.
Pour en savoir plus sur le DDK, voir le Data Access Driver Java SDK Developer Guide (Guide de
développement du pilote d'accès aux données Java SDK) à l'adresse http://boc.sdn.sap.com.
3.3 Fichiers de configuration d'accès aux données
Les fichiers de configuration d'accès aux données font partie de l'installation de la plateforme de BI. Ils
peuvent être répartis en différents niveaux :
•
Niveau global
Le fichier de configuration cs.cfg s'applique à toutes les connexions.
•
Niveau pilote
Les fichiers de configuration SBO s'appliquent à des pilotes spécifiques.
Outre les fichiers de configuration qui contrôlent la connexion, chaque pilote d'accès aux données est
doté d'un fichier de configuration PRM correspondant. Ces fichiers contrôlent la façon dont une
21
2013-09-19
Introduction à l'accès aux données
application génère le SQL en fonction des capacités logicielles de la base de données. Ils sont utilisés
par des applications telles que l'outil de conception d'information.
3.3.1 A propos du fichier de configuration globale cs.cfg
Les fichiers de configuration globaux cs.cfg utilisés par les pilotes d'accès aux données sont installés
à l'emplacement suivant :
• rép-install-connectionserver \connectionServer
Le fichier cs.cfg contient des paramètres qui s'appliquent à tous les pilotes d'accès aux données
installés.
Rubriques associées
• A propos des paramètres globaux
3.3.2 A propos des fichiers de configuration de pilote
Les fichiers de configuration utilisés par les pilotes d'accès aux données sont installés à l'emplacement
suivant :
• Sous Microsoft Windows :
rép-install-connectionserver/connectionServer/RDBMS
•
Sous UNIX :
rép-install-connectionserver/connectionServer/RDBMS
où RDBMS est soit le nom de la couche réseau, soit le middleware de la base de données qui utilise le
fichier de configuration.
Les paramètres des fichiers ci-dessous s'appliquent aux pilotes d'accès aux données qui sont installés.
22
2013-09-19
Introduction à l'accès aux données
Fichier propre au pilote
<pilote>.sbo
<pilote>.prm
<pilote><la
ngue>.cod
Modifiable
Description
Exemple
Oui
Chaque pilote d'accès
aux données est doté
d'un fichier SBO. Définit la configuration de
connectivité spécifique
à chaque pilote et base
de données cible.
oracle.sbo
Oui
Chaque pilote d'accès
aux données est doté
d'un fichier PRM. Définit les paramètres qui
déterminent le mode de
génération SQL d'une
application.
oracle.prm
Non
Chaque pilote d'accès
aux données est doté
d'un fichier COD.
Stocke des informations relatives aux définitions des connexions.
Définit les champs affichés lors de la création
d'une nouvelle connexion.
oracleen.cod
Remarque :
Ne modifiez pas ces fichiers.
<driver>.rss
23
Non
Chaque pilote d'accès
aux données est doté
d'un fichier RSS.
Stocke les phrases
SQL prédéfinies qui
sont utilisées par le
serveur de connexion.
oracle.rss
2013-09-19
Introduction à l'accès aux données
Fichier propre au pilote
<pilote>.stg
Modifiable
Description
Exemple
Non
Le pilote d'accès aux
données peut être doté
d'un fichier de stratégie. Pour en savoir
plus, consultez les informations de référence
sur les paramètres du
fichier SBO.
oracle.stg
Rubriques associées
• Description des paramètres SBO
• Informations de référence sur la configuration de fichier PRM
• A propos des paramètres de fonctionnalités des bases de données
3.4 Mode de déploiement
Le serveur de connexion peut s'exécuter dans les deux modes de déploiement suivants :
•
Mode Bibliothèque (serveur contenu dans des processus)
Le serveur de connexion fait partie du processus client. La plupart des applications
SAP BusinessObjects utilisent le serveur de connexion en mode Bibliothèque.
•
Mode Serveur
Le serveur de connexion est un serveur CORBA avec accès à distance. Le serveur de connexion
sert les clients CORBA et HTTP pour traiter les modes de déploiement 2-Tier et de niveau Web
respectivement.
Pour en savoir plus sur les scénarios de déploiement, voir le Guide d'administration de la plateforme
SAP BusinessObjects Business Intelligence.
Rubriques associées
• Définition du mode de déploiement
• Configuration du mode de déploiement
• Configuration des pilotes à charger
24
2013-09-19
Introduction à l'accès aux données
3.5 Services de connectivité
Trois instances de serveur du erveur de connexion sont fournies avec l'installation par défaut de la
plateforme de BI. Elles sont regroupées sous Services de connectivité dans la CMC (Central
Management Console).
Les serveurs du serveur de connexion hébergent les services suivants :
•
•
Service de connectivité natif (64 bits)
Service de connectivité natif (32 bits sous MS Windows uniquement)
L'Adaptive Processing Server héberge l'Adaptive Connectivity Service, qui permet aux applications
utilisateur d'accéder à distance à des sources de données Java.
Au démarrage, les services de connectivité affichent la liste des sources de données prises en charge
sur le cluster de la plateforme de BI, ce qui permet aux applications SAP BusinessObjects de consulter
et d'utiliser l'instance de serveur appropriée. Les applications recherchent des sources de données via
le serveur de connexion en mode bibliothèque d'abord, puis en mode serveur.
Connexion et service
Lorsque le serveur de connexion est utilisé en mode bibliothèque, la liste des sources de données
disponibles est définie par les pilotes d'accès aux données et le middleware installé sur l'ordinateur
local. Lorsque le serveur de connexion est utilisé en mode serveur, la liste des sources de données
inclut également celles prises en charge par chaque instance de serveur exécutée sur le système
backend de la plateforme de BI.
Chaque instance de serveur prend en charge un sous-ensemble des sources de données prises en
charge par la couche d'accès aux données. Le sous-ensemble dépend des paramètres suivants :
•
•
•
•
La technologie d'implémentation du serveur CS (C++ ou Java).
Le système d'exploitation hôte (versions UNIX ou MS Windows).
Les pilotes pouvant être sélectionnés lors de l'installation de la plateforme de BI.
Les sources de données actives pouvant être sélectionnées pour chaque instance de serveur dans
la CMC.
Le tableau suivant décrit le service de connectivité que chaque type de connexion peut utiliser.
Connexion
Service de connectivité
Description
Toutes les sources de
données natives 64 bits
Service de connectivité natif
Prise en charge d'ODBC, OLE DB, OCI,
etc.
Service de connectivité natif
Prise en charge des sources de données
disponibles en 32 bits uniquement. Ce
service est disponible uniquement sous
MS Windows.
Toutes les sources de
données natives 32 bits
25
2013-09-19
Introduction à l'accès aux données
Connexion
Sources de données
basées sur Java
Service de connectivité
Description
Adaptive Connectivity Service
Prise en charge de tous les middlewares
basés sur Java. Ce service est une implémentation Java basée sur la structure
PJS (Platform Java Service).
Exemple :
•
•
•
Une source de données native 64 bits correspond à une base de données Oracle via Oracle OCI.
Une source de données native 32 bits correspond à MS Excel 2007 via ODBC.
Une source de données basée sur Java correspond à MS SQL Server 2008 R2 via JDBC.
3.6 Connexions OLAP
La couche d'accès aux données permet à la plateforme de BI de se connecter aux sources de données
OLAP.
Les univers .unv reposant sur des sources de données OLAP utilisent des connexions gérées par le
serveur de connexion 32 bits. La présente version permet aux connexions SAP BW d'utiliser soit le
serveur de connexion 32 bits, soit le 64 bits.
Les univers .unx reposant sur des sources de données OLAP utilisent des connexions gérées par le
composant client OLAP de la plateforme de BI.
Pour obtenir la liste des sources de données OLAP, voir la Product Availability Matrix (matrice de
disponibilité des produits). Pour créer des connexions OLAP, voir le Guide de l'utilisateur de l'outil de
conception d'information.
Rubriques associées
• Connexions SAP BW
La couche d'accès aux données permet à la plateforme de BI d'accéder à la source de
données SAP BW.
26
2013-09-19
Spécificités de l'accès aux données
Spécificités de l'accès aux données
4.1 Prise en charge des systèmes d'exploitation 64 bits
SAP BusinessObjects fournit des versions de la plateforme de BI pour les systèmes d'exploitation
suivants :
•
•
Versions 32 bits de Microsoft Windows
Versions 64 bits de Microsoft Windows et versions UNIX
La couche d'accès aux données fournit alors des pilotes d'accès aux données pouvant être exécutés
dans un environnement 32 bits ou 64 bits.
Les sections suivantes décrivent en détails ce que cela implique pour la prise en charge du middleware
de base de données dans des environnements 32 bits ou 64 bits.
Pour obtenir la liste complète des sources de données prises en charge par les systèmes d'exploitation
64 bits, voir la Product Availability Matrix.
Remarque :
Le DDK fournit des exemples de pilotes d'accès aux données pouvant être exécutés dans un
environnement 32 bits ou 64 bits. Pour en savoir plus sur le DDK, voir le Data Access Driver Java SDK
Developer Guide (Guide du développeur pour le SDK Java de pilotes d'accès aux données).
4.1.1 Prise en charge d'UNIX 64 bits
Le serveur de connexion est inclus dans la plateforme de BI et prend en charge l'installation dans les
environnements UNIX 64 bits comme serveur en cours de processus ou comme serveur à distance.
Attention :
Assurez-vous d'installer un middleware 64 bits pour exécuter les connexions de bases de données via
Connection Server.
Certains fournisseurs ne fournissent pas de middleware 64 bits pour les bases de données et couches
réseau suivantes sous UNIX. Ils ne sont disponibles que sous Microsoft Windows :
•
•
•
27
DB2 UDB pour iSeries V5 avec Client Access AS400
DB2 UDB pour iSeries V6 avec Client Access AS400
DB2 pour i v6.1 avec Client Access AS400
2013-09-19
Spécificités de l'accès aux données
•
•
•
•
•
DB2 pour i v7.1 avec Client Access AS400
Source de données générique via OLE DB
MS Access 2010 et 2013 via ODBC
MS Excel 2010 et 2013 via ODBC
MS SQL Server 2008, 2008 R2 et 2012 via OLE DB
4.1.2 Prise en charge de Microsoft Windows 64 bits
Le serveur de connexion est inclus dans la plateforme de BI et prend en charge l'installation sur
l'environnement MS Windows 32 bits ou 64 bits (comme serveur en cours de processus ou comme
serveur à distance).
Les fournisseurs ne prévoient pas le middleware 64 bits pour les bases de données suivantes via ODBC
sur Microsoft Windows :
•
•
•
•
•
•
•
Ingres Database 9
MS Access 2007
MS Excel 2007
PostgreSQL 8
Fichiers texte
Serveur de requêtes Data Federator XI 3.0
Salesforce.com
L'environnement Microsoft Windows 64-bits ne prend pas non plus en charge les bases de données
OLAP suivantes et leur middleware :
•
•
MS Analysis Services via OLE DB pour OLAP
Oracle Essbase via le middleware Essbase
Pour toutes ces sources de données, la couche d'accès aux données est compatible avec les
middlewares 32 bits sur les versions 64 bits de Microsoft Windows. Cette fonctionnalité est gérée par
le biais d'un déploiement spécifique constitué de deux serveurs de connexion exécutés simultanément
en mode Serveur. Le premier est un serveur 32 bits qui exécute les connexions aux sources de données
ne gérant pas les middlewares 64 bits et le second est un serveur 64 bits qui exécute les connexions
aux autres sources de données. Comme le fichier cs.cfg est commun aux deux serveurs, ces derniers
partagent la même configuration.
Restriction :
Cette architecture implique que vous ne pouvez pas exécuter le même pilote d'accès aux données sur
les deux serveurs. Néanmoins, vous pouvez créer une connexion Generic ODBC sur le Connection
Server 32 bits ou le Connection Server 64 bits, mais pas sur les deux serveurs en même temps.
Rubriques associées
• Taille de l'Array fetch
28
2013-09-19
Spécificités de l'accès aux données
4.1.3 Installation des pilotes ODBC
Pour les installations de l'outil de conception d'information ou de l'outil de conception d'univers sur un
système d'exploitation Windows 32 bits, les pilotes associés à toutes les sources de données ODBC
devant être créées, testées et accessibles dans l'outil doivent être définis à l'aide de l'Administrateur
de sources de données ODBC qui se trouve à l'emplacement suivant sur l'ordinateur physique sur
lequel l'outil est installé :
•
C:\Windows\System32\odbcad32.exe
Pour les installations de l'outil de conception d'information ou de l'outil de conception d'univers sur un
système d'exploitation Windows 64 bits, les pilotes associés à toutes les sources de données ODBC
devant être créées, testées et accessibles dans l'outil doivent être définis à l'aide de la version 32 bits
de l'Administrateur de sources de données ODBC qui se trouve à l'emplacement suivant sur l'ordinateur
physique sur lequel l'outil est installé :
•
C:\Windows\SysWOW64\odbcad32.exe
Pour l'outil de conception d'information, les sources de données ODBC utilisées par les composants
du serveur sont définies à l'aide de l'Administrateur de sources de données ODBC qui se trouve à
l'emplacement suivant sur l'ordinateur physique sur lequel les composants du serveur sont installés :
•
•
Version 64 bits : C:\Windows\System32\odbcad32.exe (utilisation recommandée s'il existe un
middleware de base de données 64 bits)
Version 32 bits : C:\Windows\SysWOW64\odbcad32.exe (utilisation recommandée s'il existe
uniquement un middleware de base de données 32 bits)
Remarque :
Si l'outil de conception d'information ou l'outil de conception d'univers utilise un DSN ODBC pour les
sources de donnés d'univers, des DSN de nom identique doivent être créés sur l'ordinateur physique
sur lequel les composants du serveur sont installés pour les applications de reporting SAP
BusinessObjects utilisant les univers publiés.
Pour en savoir plus, reportez-vous au Guide d'administration de la plateforme SAP BusinessObjects
Business Intelligence.
4.2 Prise en charge de la connexion unique
La plateforme de BI fournit une authentification par connexion unique lorsque la solution est installée
sur les plateformes suivantes et avec les connectivités suivantes :
29
2013-09-19
Spécificités de l'accès aux données
Source de données
Description
MS Analysis Services sur Microsoft Windows
La connexion unique à la plateforme de BI est
fournie par Windows AD à l'aide de Kerberos.
MS SQL Server via ODBC ou OLE DB sur Micro- La connexion unique à la plateforme de BI est
soft Windows
fournie par Windows AD à l'aide de Kerberos.
Oracle via OCI sur Microsoft Windows
La connexion unique à la plateforme de BI est
fournie par le protocole LDAP.
Oracle EBS via OCI sur toutes les plateformes
Vous activez la connexion unique en installant et
configurant le plug-in d'authentification fourni avec
la plateforme. Les utilisateurs se connectent à la
plateforme de BI depuis une application SAP BusinessObjects en utilisant leurs références de connexion EBS (nom d'utilisateur et mot de passe).
SAP BW via OLAP BAPI sur toutes les plateformes Vous activez la connexion unique en installant et
configurant l'authentification SAP. Les utilisateurs
se connectent à la plateforme de BI depuis une
application SAP BusinessObjects en utilisant leurs
références de connexion SAP BW.
Systèmes SAP ERP via la connectivité SAP Java Vous activez la connexion unique en installant et
(JCo) 3.x sur toutes les plateformes
configurant l'authentification SAP. Les utilisateurs
se connectent à la plateforme de BI depuis une
application SAP BusinessObjects en utilisant leurs
références de connexion SAP ERP.
30
2013-09-19
Spécificités de l'accès aux données
Source de données
Description
Base de données SAP HANA 1.0 SPS 06 via
La connexion fournie est une connexion unique
ODBC, JDBC sur toutes les plateformes et OLAP vers la base de données et utilise soit Windows
sous Microsoft Windows, Linux et AIX
AD à l'aide de Kerberos (dans ODBC, JDBC et
OLAP), soit le protocole SAML (dans JDBC et
OLAP). Les utilisateurs se connectent à la plateforme de BI depuis une application SAP BusinessObjects en utilisant leurs références de connexion
Windows AD.
Base de données Sybase IQ via ODBC sous Mi- La connexion unique à la plateforme de BI est
crosoft Windows
fournie par Windows AD à l'aide de Kerberos.
Teradata 13 et Teradata 14 via ODBC sous Micro- La connexion unique à la plateforme de BI est
soft Windows
fournie par Windows AD à l'aide de Kerberos.
Pour en savoir plus sur la connexion unique, consultez le Guide d'administration de la plateforme de
Business Intelligence.
Rubriques associées
• Connexions Oracle EBS
• Pilote SAP ERP
• Connexions SAP HANA
4.3 Procédures stockées
Le serveur de connexion peut gérer les données des sources de données résultant d'une requête SQL
ou de l'exécution d'une procédure stockée.
Les procédures stockées sont des scripts SQL stockés sous la forme de code exécutable dans un
SGBDR. Elles peuvent recevoir des arguments et renvoyer des données.
Les procédures stockées pour les bases de données et couches réseau suivantes sont prises en charge
dans la plateforme de BI :
•
•
•
•
•
31
DB2 UDB et iSeries via un pilote CLI
Sybase Adaptive Server via CTLIB
Javabean
DB2 UDB, Derby, HSQL DB, Informix, MS SQL Server, MySQL 5, Oracle, SAP HANA et Sybase,
toutes via JDBC
Oracle via OCI
2013-09-19
Spécificités de l'accès aux données
•
•
DB2 iSeries, Informix, MS SQL Server, SAP HANA, Sybase ASIQ, Sybase SQL Anywhere et
Teradata (macros uniquement), toutes via ODBC
MS SQL Server via OLE DB
4.3.1 Fonctionnalités de base de données prises en charge
Connection Server prend uniquement en charge les procédures stockées qui renvoient les données
sous forme d'ensembles de résultats, c'est-à-dire de tables. Cela signifie qu'une procédure stockée ne
peut pas renvoyer d'entiers, de chaînes ou de curseurs et qu'elle doit toujours contenir des instructions
SELECT. A noter également que les procédures stockées prises en charge ne doivent contenir aucun
paramètre OUT ou IN/OUT, uniquement des paramètres IN. De plus, les instructions COMPUTE, PRINT,
OUTPUT ou STATUS contenues dans les procédures stockées ne sont pas exécutées.
Attention :
Ces restrictions ne sont pas valides pour les procédures stockées Oracle. Pour en savoir plus sur les
procédures stockées Oracle prises en charge, consultez la section suivante.
Le serveur de connexion prend en charge les procédures stockées Oracle dans un package. Le nom
du package est renvoyé en tant que nom du catalogue. Ce comportement s'applique pour les couches
réseau Oracle CI et JDBC
Pour en savoir plus sur l'utilisation des procédures stockées, reportez-vous au Guide de l'utilisateur de
l'outil de conception d'univers.
4.3.2 Procédures stockées Oracle
Les procédures stockées Oracle prises en charge sont les suivantes :
•
•
procédures PL/SQL renvoyant des ensembles de résultats via un curseur REF ;
procédures stockées PL/SQL avec un paramètre de variable de curseur REF ENTREE/SORTIE et
pas de paramètre SORTIE.
Remarque :
Les autres paramètres de curseur ENTREE/SORTIE de la procédure sont ignorés.
Les procédures stockées Oracle non prises en charge sont les suivantes :
•
•
•
•
•
32
procédures PL/SQL ne renvoyant pas d'ensembles de résultats via un paramètre de CURSEUR
REF ;
procédures PL/SQL avec au moins un paramètre SORTIE ;
fonctions PL/SQL ;
procédures PL/SQL avec un paramètre ENTREE/SORTIE de type différent du paramètre de
CURSEUR REF, par exemple, VARRAY ;
fonctions de table PL/SQL.
2013-09-19
Spécificités de l'accès aux données
Pour accéder aux procédures stockées Oracle, vous devez effectuer plusieurs tâches à la fin du serveur
pour permettre à la plateforme de BI de se connecter à une procédure stockée. Les sections suivantes
expliquent ce processus.
4.3.3 Pour créer un curseur dans un package
Dans les bases de données Oracle, un package est un objet de base de données qui contient des
types, objets et sous-programmes PL/SQL liés. Vous devez créer un curseur dans un package avant
de créer une procédure stockée Oracle à l'aide du curseur défini.
•
Dans le système d'administration de base de données Oracle, utilisez l'instruction suivante :
CREATE or REPLACE PACKAGE catalog_data AS
TYPE CatCurTyp IS REF CURSOR RETURN
all_objects%ROWTYPE;
END catalog_data;
Attention :
La plateforme de BI ne prend en charge que les procédures stockées autonomes, pas celles des
packages.
4.3.4 Pour créer une procédure stockée Oracle
Dans la procédure suivante, vous utilisez le curseur catcurtyp que vous avez précédemment créé
dans le package et catalog_data.catcurtyp.
•
Effectuez l'une des actions suivantes :
a. Ecrivez l'instruction suivante :
CREATE or REPLACE PROCEDURE get_allobjects(cat_cv IN OUT
catalog_data.catcurtyp) AS
BEGIN
OPEN cat_cv FOR SELECT * FROM all_objects;
END;
b. Ecrivez l'instruction suivante avec plusieurs paramètres :
CREATE or REPLACE PROCEDURE get_ownerobjects(owner_name IN
varchar2, cat_cv IN OUT catalog_data.catcurtyp) AS
BEGIN
OPEN cat_cv FOR SELECT * FROM all_objects WHERE
owner=owner_name;
END;
Remarque :
Pour en savoir plus sur la création de packages et de procédures stockées, consultez votre
documentation Oracle.
33
2013-09-19
Spécificités de l'accès aux données
4.3.5 Procédures stockées SAP HANA
Le serveur de connexion prend en charge les procédures stockées SAP HANA via JDBC et ODBC.
Vous créez des procédures stockées SAP HANA à l'aide de la syntaxe suivante :
CREATE PROCEDURE <procedure_name>
{LANGUAGE <lang>} {SQL SECURITY <mode>}
{READS SQL DATA {WITH RESULT VIEW <view_name>}} AS
BEGIN
select ... from <table_name>;
END
LANGUAGE, SQL SECURITY et READS SQL DATA ne sont pas obligatoires. Le langage par défaut est
SQLScript. Pour en savoir plus, voir le guide SAP HANA Database SQLScript Guide.
Exemple :
Procédure stockée simple :
CREATE PROCEDURE Proc
LANGUAGE SQLSCRIPT READS SQL DATA AS
BEGIN
select * from CUSTOMER;
END
Procédure stockée contenant un paramètre et une vue de résultats :
CREATE PROCEDURE ProcWithResultView(IN id int)
LANGUAGE SQLSCRIPT READS SQL DATA WITH RESULT VIEW ProcView AS
BEGIN
select * from CUSTOMER where CUST_ID = :id;
END
4.3.6 Macros Teradata
Connection Server prend uniquement en charge les macros Teradata si la connexion établie utilise
ODBC.
Attention :
Il ne prend pas en charge les procédures stockées Teradata dans ODBC car celles-ci ne renvoient
aucun ensemble de résultats. Il ne prend pas non plus en charge les macros et les procédures stockées
dans JDBC.
Vous créez des macros Teradata à l'aide de la syntaxe suivante :
create macro <macro_name> as (select * from <table_name>;);
Pour en savoir plus, voir la documentation de Teradata.
34
2013-09-19
Spécificités de l'accès aux données
Exemple :
Macro simple :
create macro GUEST95 as (select * from guest where TYear='FY95';);
Macro avec un paramètre :
create macro MGUESTIN (inyear VARCHAR(12)) as (select * from GUEST where TYear=:inyear;);
Macro avec plusieurs ensembles de résultats :
create macro MGUEST as
(
select * from guest where TYear='FY95';
select count(*) from guest;
);
4.4 Pools de connexions
Un pilote ouvre une connexion à la base de données pour accéder aux données. Vous pouvez utiliser
une des deux méthodes suivantes pour vous connecter à la base de données :
• Chaque fois que Connection Server a besoin d'informations, le pilote d'accès aux données ouvre
une connexion à la base de données, extrait les données, puis ferme la connexion.
•
Connection Server garde ouvertes les connexions disponibles et conserve leurs informations dans
le pool de connexions. Chaque fois que Connection Server a besoin d'informations dans la source
de données, le pilote d'accès aux données vérifie le pool de connexions pour voir s'il contient des
connexions adéquates non utilisées. Si une connexion existante est disponible, elle est utilisée. Si
toutes les connexions sont en cours d'utilisation, Connection Server crée une connexion et l'ajoute
au pool. Cette méthode permet d'utiliser les ressources du système plus efficacement.
Rappel :
Connection Server n'ajoute pas de connexion utilisant la connexion unique au pool.
4.4.1 A propos des connexions du pool
Les connexions disponibles dans le pool de connexions peuvent être exclusives ou partageables.
•
35
Les connexions exclusives peuvent être affectées à un seul utilisateur à la fois. Lorsqu'une connexion
exclusive est affectée, elle n'est plus disponible dans le pool. Elle ne peut alors plus être affectée
à d'autres demandeurs. Lorsque la connexion n'est plus utilisée, le pilote personnalisé la libère afin
de pouvoir la réaffecter.
2013-09-19
Spécificités de l'accès aux données
•
Les connexions partageables peuvent être affectées à plusieurs utilisateurs à la fois. Lorsqu'une
connexion est affectée, elle reste dans le pool et donc disponible pour d'autres demandeurs.
Vous pouvez choisir de créer une connexion exclusive ou partageable à l'aide du paramètre Mode de
pool de connexions de l'Assistant de connexion.
Rubriques associées
• Connexion partageable
• Connexion partagée
• Max Pool Time
4.4.2 Mode de pool de connexions
Valeur du mode de pool de connexions
Description du mode de pool de connexions
Déconnecter après chaque transaction
Se déconnecte de la base de données à l'issue d'une
requête. Lors de la prochaine exécution d'une requête, la connexion est recréée.
Conserver la connexion active pendant
Il s'agit de l'option de pool de connexions. Si une requête se termine avant l'échéance spécifiée dans
Délai de connexion (par défaut, 10 minutes), la connexion peut être réutilisée. Tous les utilisateurs
partagent la connexion.
Conserver la connexion active pendant toute La connexion est fermée lorsque l'utilisateur quitte
la durée de la session (mode local uniqueme- l'application ou lorsque le navigateur Web se ferme.
Cette option n'utilise pas le pool de connexions.
nt)
Choix du mode de pool de connexions
Le mode de pool de connexions peut dépendre de la disponibilité des ressources de votre ordinateur.
•
•
•
36
Si la mémoire est réduite, sélectionnez l'option Déconnecter après chaque transaction.
Si la mémoire est étendue et que les performances sont essentielles, sélectionnez l'option Conserver
la connexion active pendant toute la durée de la session (mode local uniquement).
Pour contrôler le comportement avec plus de précision, sélectionnez l'option Conserver la connexion
active pendant.
2013-09-19
Spécificités de l'accès aux données
4.4.3 Vérification du pool de connexions du middleware
Les middleware de source de données fournissent souvent leur propre mécanisme de pool de
connexions. Veillez à ce que la configuration du pool de connexions du middleware soit compatible
avec celle de l'outil de conception afin d'obtenir les performances de connexion que vous espérez.
4.5 Equilibrage de charge
En mode serveur, vous pouvez exécuter plusieurs instances du serveur de connexion sur la plateforme
de BI. Dans ce mode de déploiement, le serveur de connexion implémente un mécanisme d'équilibrage
de charge. Il sélectionne le meilleur serveur en termes de ressources pouvant prendre en charge de
nouvelles demandes de clients.
L'équilibrage de charge aide à résoudre les problèmes d'extensibilité en augmentant le nombre
d'instances de serveur sur la plateforme de BI.
Attention :
Ce mécanisme d'équilibrage de charge est différent de celui implémenté par le CMS (Central
Management Server).
L'équilibrage de charge est réalisé aux niveaux suivants :
•
•
Les proxy client dans un déploiement à deux niveaux, au niveau du client.
Les ponts serveur dans un déploiement de niveau Web, au niveau Web.
Le serveur de connexion comporte également un mécanisme de recherche au niveau de l'application,
qui l'aide à choisir la bonne instance de serveur pour un travail. Le serveur de connexion relie le client
au serveur approprié, selon le type de source de données demandé par le client et selon la paire couche
réseau et base de données prise en charge par le serveur.
Rappel :
L'équilibrage de charge est réalisé après la recherche. Il est disponible sur toutes les plateformes.
4.5.1 Recherche du serveur le mieux adapté
Les problèmes d'extensibilité du serveur de connexion peuvent être générés par :
•
37
Le nombre de connexions ouvertes à la base de données
2013-09-19
Spécificités de l'accès aux données
Les problèmes liés au nombre de connexions à la base de données sont déjà traités par le mécanisme
de pool de connexions.
•
Les processeurs utilisés par le serveur de connexion
Le serveur de connexion peut utiliser un certain nombre de processeurs pour convertir les données
ou écrire et renvoyer des tampons de réponse volumineux au client. Toutefois, le serveur de
connexion n'utilise pas énormément de processeurs.
•
Le nombre de travaux en cours d'exécution
Le nombre de travaux exécutés sur un serveur augmente sa charge de travail.
•
La mémoire totale allouée par le serveur de connexion ou le middleware intégré
La mémoire totale utilisée dépend des requêtes SQL exécutées. Par exemple, une instruction SQL
unique pour une grande table peut avoir un impact plus important sur l'extensibilité qu'une série de
petites requêtes SQL.
Le serveur de connexion implémente l'équilibrage de charge avec l'aide de l'indicateur de charge le
plus pertinent, à savoir dans ce cas la mémoire totale allouée. Moins le serveur de connexion utilise
de mémoire, plus il est sain.
Remarque :
Le serveur de connexion peut aussi utiliser le nombre de travaux comme indicateur de santé dans les
versions futures.
La formule suivante permet de calculer l'ETAT du serveur :
HEALTH = (available memory / max memory) * constant
où :
•
•
•
taille max. de la mémoire est la mémoire totale maximale allouée, par exemple 2 Go sur
une plateforme MS Windows 32 bits
mémoire disponible est la différence entre la taille max. de la mémoire et la mémoire
totale actuelle allouée
constant est l'ETAT maximal du serveur (défini sur 10 000 pour le serveur de connexion).
4.5.2 Logique d'équilibrage de charge
1. Chaque serveur candidat envoie son ETAT à l'équilibreur de charge.
Un serveur candidat désigne un serveur de connexion qui prend en charge la paire couche
réseau/base de données requise. En partant du principe que toutes les instances de serveur prennent
en charge le même ensemble de sources de données, elles sont toutes des candidates potentielles
pour servir une requête client.
2. L'équilibreur de charge détermine à quel serveur envoyer la requête client en identifiant et en classant
les serveurs les plus sains. Il sélectionne ensuite le meilleur serveur. Si l'ensemble de serveurs ne
contient qu'un seul serveur, il s'agit alors du serveur cible.
38
2013-09-19
Spécificités de l'accès aux données
L'ETAT DU SERVEUR est mis à jour au cours de son cycle de vie. L'ETAT DU SERVEUR est recalculé
lorsque l'une des opérations suivantes est effectuée :
•
•
•
Un travail est créé ou détruit
Un travail est préparé ou exécuté
Une opération d'extraction de données est exécutée
4.5.3 Rétrocompatibilité
Le mécanisme d'équilibrage de charge est pris en charge sur toutes les plateformes à partir de la
plateforme SAP BusinessObjects Business Intelligence 4.0 Feature Pack 3. En cas de déploiements
incrémentiels ou de mises à niveau limitées sur des versions précédentes, la rétrocompatibilité est
prise en charge. Un serveur qui n'envoie pas son ETAT à l'équilibreur de charge est considéré comme
sain, c'est-à-dire comme ayant atteint son état maximal.
Remarque :
L'équilibrage de charge est également disponible pour certaines plateformes dans des Services Packs
de versions précédentes. Plus en savoir plus, contactez votre représentant SAP.
4.6 Allocation de mémoire
Le service de connectivité natif peut utiliser la fonctionnalité d'allocation de mémoire HOARD sous
MS Windows 64 bits. HOARD est un utilitaire d'allocation de mémoire extensible et optimisé, destiné
aux composants C++, il favorise de meilleures performances du service, une meilleure extensibilité et
moins de fragmentation de mémoire.
La couche d'accès aux données fournit les fichiers binaires suivants :
•
•
ConnectionServer.exe, fichier binaire par défaut. HOARD n'est pas activé.
ConnectionServerOptimized.exe, fichier binaire adapté à HOARD.
4.6.1 Pour activer HOARD
1. Ouvrez la CMC.
2. Sous "Services de connectivité", arrêtez le service de connectivité natif hébergé par le serveur de
connexion.
3. Localisez le fichier exécutable du serveur de connexion.
Ce fichier se trouve dans le répertoire rép-install-pbi\win64_x64.
39
2013-09-19
Spécificités de l'accès aux données
4. Effectuez une copie de sauvegarde du fichier ConnectionServer.exe.
5. Renommez ConnectionServerOptimized.exe en ConnectionServer.exe.
6. Redémarrez le service.
Vous avez activé HOARD dans le service de connectivité natif.
4.6.2 Pour désactiver HOARD
1. Ouvrez la CMC.
2. Sous "Services de connectivité", arrêtez le service de connectivité natif hébergé par le serveur de
connexion.
3. Restaurez le fichier ConnectionServer.exe par défaut.
4. Redémarrez le service à partir de la CMC.
Vous avez désactivé HOARD dans le service de connectivité natif.
4.7 Activité sur le poste de travail CA Wily Introscope
Le poste de travail CA Wily Introscope permet d'effectuer le suivi de l'activité des workflows impliquant
le serveur de connexion. Il est possible d'analyser les fonctions du serveur de connexion à l'aide de
différentes vues proposées par l'outil, qui sont les suivantes :
•
•
•
Tableau de bord d'entreprise et vue de résumé des informations globales
Affichage de la trace, où les erreurs sont mises en surbrillance et décrites par des messages
Arborescence, où les appels de fonctions successifs d'un workflow spécifique sont affichés et où le
temps passé sur une fonction est mis en surbrillance pour facilement suivre les activités chronophages
Pour en savoir plus, voir le Guide d'administration de la plateforme SAP BusinessObjects de Business
Intelligence.
Rubriques associées
• Pour configurer la JVM (Java Virtual Machine) pour l'instrumentation
40
2013-09-19
Création d'une connexion
Création d'une connexion
5.1 Conditions requises pour la connexion
Cette section décrit les conditions requises pour créer une connexion.
•
Vérifiez que la plateforme utilisée est prise en charge par les connexions SAP.
•
Vérifiez que le middleware de la base de données est correctement installé pour pouvoir accéder
à la base de données via un ordinateur ou un serveur.
•
Vérifiez que vous disposez de toutes les informations nécessaires pour accéder à votre base de
données (mot de passe et nom de connexion à la base de données par exemple).
•
Installez la solution SAP BusinessObjects que vous allez utiliser et le pilote d'accès aux données
approprié.
•
Vérifiez que tous les services ont démarré correctement.
•
Consultez le fichier Readme fourni avec la solution SAP BusinessObjects pour connaître les
modifications d'environnement et de logiciel éventuellement requises.
•
Voir les notes de version de l'accès aux données pour savoir si des modifications qui peuvent
modifier votre environnement ont été apportées à la configuration.
Remarque :
Vous pouvez utiliser l'outil cscheck pour vérifier votre infrastructure et déterminer si elle peut être
utilisée avec des applications SAP BusinessObjects.
Rubriques associées
• Vérification de la configuration de la connexion
5.2 Vérification de la configuration de la connexion
Le logiciel Connection Server inclut un utilitaire de ligne de commande que vous pouvez utiliser pour
vérifier l'infrastructure de la connexion à la source de données. L'outil cscheck permet de vérifier à
tout moment le middleware client et les pilotes d'accès aux données installés.
41
2013-09-19
Création d'une connexion
Remarque :
Les résultats de toutes les vérifications concernent l'ordinateur local à partir duquel vous exécutez
l'outil.
L'outil cscheck est installé sous rép-install-boe\rép_plateforme où rép-install-boe est
le répertoire d'installation de BOE et rép_plateforme est win32x_86, win64_x64, etc.
cscheck s'exécute à partir d'une console de commandes (DOS ou shell). La sortie est affichée à
l'écran. Vous pouvez choisir de générer la sortie au format XML ou de supprimer la sortie afin d'utiliser
l'outil dans un script.
L'outil cscheck vous permet d'effectuer les fonctions suivantes sur l'ordinateur local :
•
Renvoyer les détails de toutes les connectivités (couches réseau et bases de données) que
l'installation prend en charge.
•
Renvoyer les détails des pilotes d'accès aux données installés sur l'ordinateur local.
•
Renvoyer les détails des connectivités installées sur l'ordinateur local.
•
Vérifier la validité d'une installation de middleware pour une couche réseau et un client de base de
données fournis.
•
Vérifier la validité d'une installation de pilote d'accès aux données pour une couche réseau et un
client de base de données fournis.
•
Vérifier si une connexion à une base de données spécifique peut être établie.
Rubriques associées
• Outil de vérification : présentation des fonctions
5.2.1 Affichage de l'aide sur l'outil cscheck
L'outil cscheck fournit des fonctionnalités permettant les actions suivantes :
•
afficher l'aide générale sur l'outil cscheck ;
•
afficher l'aide relative à chaque fonction cscheck disponible.
L'aide est disponible dans la langue sélectionnée lors de l'installation de la solution SAP BusinessObjects.
Pour afficher l'aide générale de l'outil cscheck, utilisez la syntaxe suivante :
Figure 5-1 : Syntaxe d'aide des commandes
cscheck
42
--help|h --language|l { langue }
2013-09-19
Création d'une connexion
Pour afficher l'aide d'une fonction, utilisez la syntaxe suivante où NomFonction correspond au nom
de la fonction pour laquelle vous voulez afficher l'aide et langue correspond à la langue d'affichage
de l'aide :
Figure 5-2 : Syntaxe d'aide des fonctions
cscheck
--help|h { NomFonction }--language|l { langue }
Exemple :
Pour afficher l'aide de l'outil cscheck en anglais, utilisez la commande suivante :
cscheck --help
Pour afficher l'aide de la fonction connectivity en français, utilisez la commande suivante :
cscheck --language fr --help connectivity
5.2.2 Pour exécuter l'outil cscheck
Vous pouvez exécuter l'outil cscheck à tout moment après avoir installé la solution SAP BusinessObjects.
1. Ouvrez une console de commandes.
2. Modifiez le répertoire en fonction du chemin d'installation de l'outil.
3. Entrez cscheck avec les paramètres corrects afin de trouver les informations souhaitées.
4. Vérifiez les informations renvoyées.
Rubriques associées
• Outil de vérification : présentation des fonctions
5.2.3 Outil de vérification : présentation des fonctions
A partir d'une console de commandes, utilisez la commande cscheck avec la fonction appropriée et
ses arguments pour renvoyer les résultats qui vous intéressent.
Les commandes cscheck possèdent la structure suivante. Certains paramètres sont facultatifs.
Figure 5-3 : syntaxe cscheck
cscheck --language|l { langue de sortie } --xml|x --mute|m nom de la fonction options de
la fonction
La première partie de la commande contrôle le format de sortie :
43
2013-09-19
Création d'une connexion
•
langue de sortie ou l suivi de la langue spécifiée dans la norme ISO639-1. Cette option est
facultative. La langue par défaut est l'anglais.
•
--xml ou x indique que la sortie est au format XML. Cette option est facultative. La sortie par défaut
affiche du texte à l'écran.
•
--mute indique que la sortie n'est pas générée. Cette option est utile si vous vous servez de l'outil
dans un script qui vérifie le statut renvoyé. Cette option est facultative. La sortie est générée par
défaut.
La partie restante de la commande est composée de la fonction et des arguments de l'option.
nom de la fonction peut prendre les valeurs suivantes. Chaque fonction dispose d'une version
abrégée pouvant être utilisée à la place du nom complet :
• list ou lt
•
driverssearch ou ds
•
find ou fd
•
middleware ou mw
•
accessdriver ou ad
•
connectivity ou ct
•
ping ou pg
Rubriques associées
• Outil de vérification : accessdriver
• Outil de vérification : connectivity
• Outil de vérification : driverssearch
• Outil de vérification : find
• Outil de vérification : list
• Outil de vérification : middleware
• Outil de vérification : ping
5.2.4 Outil de vérification : list
Cette fonction renvoie la liste des couches réseau et des moteurs de base de données pris en charge.
Par exemple, vous pouvez l'utiliser pour déterminer les valeurs correctes à utiliser avec les autres
fonctions de l'outil de vérification.
44
2013-09-19
Création d'une connexion
Remarque :
Cette fonction renvoie la liste complète des pilotes d'accès aux données et du middleware pris en
charge, y compris ceux qui ne sont pas nécessairement installés sur votre ordinateur.
Figure 5-4 : syntaxe de la fonction list
cscheck |list||lt|
Exemple :
La commande ci-après répertorie toutes les couches réseau et tous les moteurs de base de données
pris en charge par la solution SAP BusinessObjects installée sur l'ordinateur actif.
cscheck list
Vous trouverez ci-dessous un extrait de la liste des résultats.
Oracle Client
Oracle 10
Oracle 11
Sybase Open Client
Sybase Adaptive Server 15.5
Informix ODBC Driver
Informix Dynamic Server 11
Teradata ODBC Driver
Teradata 12
Teradata 13
Teradata 14
ODBC Drivers
Generic ODBC Datasource
Generic ODBC3 Datasource
...
Rubriques associées
• Outil de vérification : présentation des fonctions
• Affichage de l'aide sur l'outil cscheck
5.2.5 Outil de vérification : driverssearch
Cette fonction renvoie la liste des pilotes d'accès aux données installés.
Figure 5-5 : syntaxe de la fonction driverssearch
cscheck |driverssearch||ds|
Exemple :
La commande suivante répertorie tous les pilotes d'accès aux données installés sur l'ordinateur.
cscheck driverssearch
45
2013-09-19
Création d'une connexion
Vous trouverez ci-dessous un extrait de la liste des résultats.
This access driver is installed: Oracle OCI access driver
Client layer: Oracle Client
Database engine(s):
Oracle 10
Oracle 11
This access driver is installed: Sybase Open Client access driver
Client layer: Sybase Open Client
Database engine(s):
Sybase Adaptive Server 15.5
This access driver is installed: Informix ODBC access driver
Client layer: Informix ODBC Driver
Database engine(s):
Informix Dynamic Server 11
This access driver is installed: Teradata ODBC access driver
Client layer: Teradata ODBC Driver
Database engine(s):
Teradata 12
Teradata 13
Teradata 14
...
Rubriques associées
• Outil de vérification : présentation des fonctions
• Affichage de l'aide sur l'outil cscheck
5.2.6 Outil de vérification : find
Cette fonction dresse la liste des types de connectivité disponibles (middleware et clients de base de
données) disponibles à partir de l'ordinateur local. Cette opération inclut les étapes suivantes :
• types de connectivité disponibles sur l'ordinateur local
•
types de connectivité disponibles à l'aide de la couche de communication CORBA
•
types de connectivité disponibles à l'aide de la couche de communication HTTP
•
Les types de connectivité Java disponibles sur l'ordinateur local
Figure 5-6 : syntaxe de la fonction find
cscheck |find||fd| -m { mode d'accès au serveur de connexion }
46
2013-09-19
Création d'une connexion
Tableau 5-1 : Paramètres d'entrée de la fonction
Mode permettant à l'application client d'accéder
au serveur de connexion :
• local : répertorie les types de connectivité
disponibles sur l'ordinateur local.
Mode d'accès au serveur de connexion(-m)
•
corba : répertorie les types de connectivité
disponibles à l'aide de CORBA.
•
http : répertorie les types de connectivité disponibles à l'aide d'HTTP.
•
java : répertorie les types de connectivité disponibles sur l'ordinateur local.
•
extended : répertorie les types de connectivité local, java et CORBA.
Exemple : Recherche des connectivités locales
La commande suivante renvoie la liste des pilotes d'accès aux données présents sur l'ordinateur local
pouvant être chargés par le serveur de connexion.
cscheck find –m local
Vous trouverez ci-dessous un extrait de la liste des résultats.
Local Library Mode
IBM DB2 Client
DB2 10 for LUW
DB2 10 for z/OS
DB2 for i v6
DB2 for i v7
DB2 for z/OS v9
DB2 UDB for iSeries v5
DB2 v9
Essbase Provider
Hyperion Essbase 7
Hyperion Essbase 9
Informix ODBC Driver
Informix Dynamic Server 11
ODBC Drivers
Generic ODBC datasource
Generic ODBC3 datasource
MS SQL Server 2008
MS SQL Server 2012
Sybase SQL Anywhere 10
...
Exemple : Recherche des connectivités du serveur CORBA
La commande suivante renvoie la liste des pilotes d'accès aux données disponibles à partir d'un
serveur CORBA.
47
2013-09-19
Création d'une connexion
cscheck find –m corba
Rubriques associées
• Outil de vérification : présentation des fonctions
• Affichage de l'aide sur l'outil cscheck
• Outil de vérification : Informations du CMS
5.2.7 Outil de vérification : middleware
Cette fonction vérifie la validité de l'installation du middleware client pour la couche réseau et le client
de base de données fournis. Pour vérifier à la fois le middleware et le pilote d'accès aux données pour
une couche réseau et un client de base de données fournis, vous pouvez utiliser la fonction connec
tivity.
Figure 5-7 : syntaxe de la fonction middleware
cscheck |middleware| |mw| -c { couche réseau } -d { client de base de données }
Tableau 5-2 : Paramètres d'entrée de la fonction
couche réseau (-c)
Couche réseau utilisée par le middleware de la
base de données, telle qu'elle est renvoyée par
la fonction find.
client de base de données (-d)
Base de données à vérifier, telle qu'elle est renvoyée par la fonction find.
Exemple :
La commande ci-après vérifie la validité de l'installation du middleware du client Oracle 10g sur
l'ordinateur local. Elle crée le fichier de sortie suivant au format XML : c:\result.xml.
cscheck --xml middleware -c "Client Oracle" -d "Oracle 9" > c:\result.xml
Si le middleware n'est pas correctement installé, le résultat généré est le suivant :
Starting to check the middleware component installation...
Begin AND operator...
ORACLE_HOME... The environment setting does not exist.
End AND operator: failure.
The middleware is not correctly installed.
48
2013-09-19
Création d'une connexion
Rubriques associées
• Outil de vérification : présentation des fonctions
• Affichage de l'aide sur l'outil cscheck
• Outil de vérification : connectivity
• Outil de vérification : accessdriver
5.2.8 Outil de vérification : accessdriver
Cette fonction vérifie la validité de l'installation du pilote d'accès aux données pour la couche réseau
et le client de base de données fournis. Pour vérifier à la fois le middleware et le pilote d'accès aux
données pour une couche réseau et un client de base de données fournis, vous pouvez utiliser la
fonction connectivity.
Figure 5-8 : syntaxe de la fonction accessdriver
cscheck |accessdriver| |ad| -c { couche réseau } -d { client de base de données }
Tableau 5-3 : Paramètres d'entrée de la fonction
couche réseau (-c )
Couche réseau utilisée par le middleware de la
base de données, telle qu'elle est renvoyée par
la fonction find.
client de base de données (-d)
Base de données à vérifier, telle qu'elle est renvoyée par la fonction find.
Exemple :
La commande ci-après vérifie la validité de l'installation du pilote d'accès aux données Oracle 10 et
affiche la sortie en français :
cscheck -l fr accessdriver -c "Oracle Client" -d "Oracle 10"
Si la langue française n'est pas installée, le résultat généré est le suivant :
The language specified is not installed. Please use an installed language. English ([en]).
Exemple :
La commande ci-après vérifie la validité de l'installation du pilote d'accès aux données Oracle 10 :
cscheck ad -c "Oracle Client" -d "Oracle 10"
49
2013-09-19
Création d'une connexion
Le résultat généré est le suivant :
Starting to check the access driver component installation...
Begin AND operator...
Config Directory... success.
%SharedRoot%\ConnectionServer\Network Layers\Oracle OCI... success.
Directory... success.
/connectionserver-install-dir/connectionServer//oracle... success.
Library... success.
/connectionserver-install-dir/connectionServer//libdbd_oci10.so... success.
/connectionserver-install-dir/connectionServer//libdbd_oci11.so... success.
Data File Name... success.
/connectionserver-install-dir/connectionServer//oracle/oracle.sbo... success.
End AND operator: success.
The access driver is installed.
Rubriques associées
• Outil de vérification : présentation des fonctions
• Affichage de l'aide sur l'outil cscheck
• Outil de vérification : list
5.2.9 Outil de vérification : connectivity
Cette fonction vérifie que le middleware et le pilote d'accès aux données installés sont valides pour la
couche réseau et le client de base de données fournis.
Vous pouvez les vérifier manuellement à l'aide des fonctions middleware et accessdriver. Vous
pouvez utiliser la fonction ping pour savoir si vous pouvez établir une connexion à une base de données
spécifique.
Figure 5-9 : syntaxe de la fonction connectivity
cscheck |connectivity| |ct| -c { couche réseau } -d { client de base de données }
Tableau 5-4 : Paramètres d'entrée de la fonction
50
couche réseau (-c)
Couche réseau utilisée par le middleware de la
base de données, telle qu'elle est renvoyée par
la fonction find.
client de base de données (-d)
Base de données à vérifier, telle qu'elle est renvoyée par la fonction find.
2013-09-19
Création d'une connexion
Exemple :
La commande ci-après vérifie le middleware du client Oracle installé et le pilote d'accès aux données
Oracle 10. La commande écrit la sortie dans le fichier texte c:\result.txt.
cscheck -l en connectivity -c "Oracle Client" -d "Oracle 10">c:\result.txt
Si le middleware n'est pas correctement installé, le résultat généré est le suivant :
Starting to check the middleware component installation...
Begin AND operator...
ORACLE_HOME... The environment setting does not exist.
End AND operator: failure.
The middleware is not correctly installed.
Starting to check the access driver component installation...
Begin AND operator...
Config Directory... success.
%SharedRoot%\ConnectionServer\Network Layers\Oracle OCI... success.
Directory... success.
/connectionserver-install-dir/connectionServer//oracle... success.
Library... success.
/connectionserver-install-dir/connectionServer//libdbd_oci10.so... success.
/connectionserver-install-dir/connectionServer//libdbd_oci11.so... success.
Data File Name... success.
/connectionserver-install-dir/connectionServer//oracle/oracle.sbo... success.
End AND operator: success.
The access driver is installed.
Rubriques associées
• Outil de vérification : présentation des fonctions
• Affichage de l'aide sur l'outil cscheck
• Outil de vérification : find
• Outil de vérification : accessdriver
• Outil de vérification : middleware
• Outil de vérification : ping
5.2.10 Outil de vérification : ping
Cette fonction a pour objectif d'accéder à une base de données spécifique à l'aide des détails fournis.
Figure 5-10 : syntaxe de la fonction ping
cscheck ping|pg| -m { mode d'accès au serveur de connexion } -c { couche réseau } -d {
client de base de données } -u { nom d'utilisateur } -p { mot de passe } -s { source de données
} -t { base de données } -r { nom d'hôte } -j { PID }
51
2013-09-19
Création d'une connexion
Tableau 5-5 : Paramètres d'entrée de la fonction
Mode permettant à l'application client d'accéder
au serveur de connexion :
• local : le serveur de connexion est exécuté
sur l'ordinateur local.
•
corba : le serveur de connexion est exécuté
sur un serveur CORBA.
•
http : le serveur de connexion est exécuté
sur un serveur HTTP.
•
java : le serveur de connexion utilise un pilote
d'accès aux données Java sur l'ordinateur local.
Mode d'accès au serveur de connexion(-m)
52
couche réseau (-c)
Middleware de base de données pour la connexion à vérifier, tel qu'il est renvoyé par la fonction find.
client de base de données (-d)
Type de base de données, tel qu'il est renvoyé
par la fonction find.
nom d'utilisateur (-u)
Nom d'utilisateur valide pour la base de données.
mot de passe (-p)
Mot de passe correspondant au nom d'utilisateur.
source de données (-s)
Serveur exécutant la base de données.
base de données (-t)
Serveur de la base de données.
nom d'hôte (-r)
En mode CORBA, ordinateur hébergeant le serveur de connexion.
PID (-i)
En mode CORBA, numéro de processus du serveur de connexion à utiliser pour la commande
ping.
2013-09-19
Création d'une connexion
Exemple : Commande ping pour une base de données Oracle
La commande suivante vérifie l'accès pour :
• Mode d'accès au serveur de connexion : local : la base de données est exécutée sur l'ordinateur
local.
•
Couche réseau : Oracle Client
•
Base de données : Oracle 10g
•
Source de données : Harlaxton
•
Nom d'utilisateur : efashion
•
Mot de passe : X2345
cscheck ping -m local -c "Oracle Client" -d "Oracle 10" -u "efashion" -p
"X2345" -s "Harlaxton"
Exemple : Commande ping pour une base de données Sybase utilisant CORBA
La commande suivante vérifie l'accès pour :
• Mode d'accès au serveur de connexion : CORBA : le serveur de connexion s'exécute sur un serveur
CORBA.
•
Couche réseau : Sybase
•
Nom d'utilisateur : syadmin
•
Mot de passe : password
•
Source de données : Sybase Adaptive Server 15
•
Base de données : SY1
•
Hôte de base de données : sybasehost
•
ID de processus : 456
cscheck ping -m corba -c "Sybase Open Client" -d syb15 -u "syadmin" -p
"password" -s "Sybase Adaptive Server 15.5" -t "SY1" -r "sybasehost" -i 456
Rubriques associées
• Outil de vérification : présentation des fonctions
• Outil de vérification : find
• Outil de vérification : Informations du CMS
53
2013-09-19
Création d'une connexion
5.2.11 Outil de vérification : Informations du CMS
Les paramètres suivants permettent de spécifier les informations du CMS que vous pouvez utiliser
avec la fonction find ou ping de l'outil cscheck.
Figure 5-11 : Syntaxe du CMS
cscheck --ce_cluster { Serveur CMS } --ce_user { Nom d'utilisateur } --ce_pass { Mot
de passe } --ce_auth { Authentification } find -m corba
Tableau 5-6 : Paramètres d'entrée de la fonction
Serveur CMS (--ce_cluster)
Hôte et port permettant d'accéder au CMS.
Nom d'utilisateur (--ce_user)
Nom d'utilisateur permettant d'accéder au CMS.
Mot de passe (--ce_pass)
Mot de passe permettant d'accéder au CMS.
Authentification (--ce_auth)
Méthode utilisée pour authentifier les références
de connexion de l'utilisateur lors de l'accès au
CMS.
Exemple :
La commande suivante renvoie une liste des connexions stockées sur le CMS et disponibles à l'aide
de CORBA.
cscheck --ce_cluster hôtelocal --ce_user Administrateur --ce_pass Motdepasse1
--ce_auth SecEnterprise find -m corba
Rappel :
Les paramètres doivent être placés avant la fonction find ou ping sur la ligne de commande. Ils sont
tous obligatoires.
Rubriques associées
• Outil de vérification : find
• Outil de vérification : ping
54
2013-09-19
Création d'une connexion
5.3 Création de connexions JDBC
Un ensemble de pilotes d'accès aux données est installé avec la plateforme de BI. Vous pouvez utiliser
ces pilotes d'accès aux données pour créer des connexions aux bases de données. Ces pilotes se
trouvent dans le répertoire rép-install-connectionserver\connectionServer\drivers\ja
va.
Remarque :
La connectivité JDBC est disponible pour SAP BusinessObjects Enterprise XI 3.0 et versions ultérieures.
Web Intelligence Rich Client prend en charge la connectivité JDBC en mode 3-Tier à partir de la
plateforme SAP BusinessObjects Business Intelligence 4.0.
Le logiciel SAP BusinessObjects inclut également des fichiers de configuration pour l'utilisation de
pilotes JDBC comme moyen d'accès aux bases de données. Pour utiliser ces pilotes, procédez comme
suit :
1. Procurez-vous le logiciel du pilote Java auprès de votre fournisseur de base de données.
2. Pour spécifier les chemins des fichiers JAR, procédez comme suit :
• Définissez l'élément ClassPath dans le fichier de configuration SBO du pilote d'accès aux
données avec le chemin complet du fichier JAR.
• Stockez les fichiers JAR dans des répertoires créés à partir des valeurs du paramètre Exten
sions du fichier SBO.
Vous pouvez utiliser simultanément ces deux méthodes de spécification des chemins de fichiers JAR.
Toutefois, les fichiers JAR spécifiés dans le fichier SBO ont priorité sur les fichiers JAR stockés dans
vos propres répertoires.
Remarque :
SAP Visual Intelligence permet aux utilisateurs de sélectionner directement des fichiers JAR à partir
de la zone de création de connexion de l'application. Pour en savoir plus, voir le Guide de l'utilisateur
de SAP Visual Intelligence.
Pour obtenir la liste la plus récente des pilotes JDBC pris en charge, visitez le site
SAP Service MarketPlace à l'adresse http://service.sap.com/bosap-support ou contactez votre
représentant SAP.
Remarque :
La couche d'accès aux données fournit la connectivité JDBC générique qui permet de créer une
connexion à une source de données que la plateforme de BI ne prend pas explicitement en charge.
Rubriques associées
• Création d'une connexion JDBC avec le fichier SBO
• Création d'une connexion JDBC avec le paramètre Extensions
• Pour créer une connexion Generic JDBC
• Propriétés du pilote JDBC
55
2013-09-19
Création d'une connexion
5.3.1 Création d'une connexion JDBC avec le fichier SBO
•
Procurez-vous le logiciel de pilote JDBC nécessaire pour la base de données et copiez les fichiers
sur votre système. Ces fichiers sont disponibles auprès du fournisseur de la base de données. Le
logiciel du pilote est généralement constitué d'un ou de plusieurs fichiers .jar. Notez le chemin
d'installation de ces fichiers.
•
Vérifiez que vous disposez des informations nécessaires pour accéder à la base de données (mot
de passe et nom de connexion, par exemple).
1. Accédez au répertoire contenant le fichier SBO que vous souhaitez utiliser.
Par exemple, sous Microsoft Windows, les fichiers de configuration JDBC se trouvent dans le
répertoire connectionserver-install-dir\connectionServer\jdbc.
2. Utilisez un éditeur XML pour ouvrir le fichier SBO à modifier.
3. Ajoutez les informations du fichier .jar requises à la zone Chemin de la classe. Veillez à
inclure les noms de chemins complets lorsque vous spécifiez ces fichiers, par exemple :
<Path>C:\\JDBC Drivers\\MSSQLSERVER2008\\msutil.jar</Path>
Remarque :
Ces fichiers doivent être installés sur l'ordinateur hébergeant l'application.
4. Recherchez le paramètre Driver Capabilities et vérifiez qu'il est défini sur Procedure,
Queries ou les deux.
Remarque :
Dans le dernier cas, les paramètres sont séparés par une virgule.
Attention :
Si le paramètre n'est pas défini sur l'une de ces valeurs, le pilote JDBC n'est pas disponible depuis
l'Assistant de connexion.
5. Enregistrez le fichier SBO et fermez-le.
6. Exécutez l'Assistant de connexion.
Le pilote JDBC que vous avez configuré apparaît dans la liste des connexions disponibles.
7. Sélectionnez le pilote JDBC et utilisez l'Assistant pour configurer la connexion.
Lorsque vous effectuez cette tâche, la connexion est disponible.
Rubriques associées
• Conditions requises pour la connexion
• Fichiers de configuration d'accès aux données
56
2013-09-19
Création d'une connexion
5.3.2 Exemple de structure de fichiers SBO JDBC
L'exemple ci-dessous présente la section du fichier sqlsrv.sbo que vous devez modifier. Ce fichier
SBO est destiné à Microsoft SQL Server 2008.
<DataBase Active="Yes" Name="MS SQL Server 2008">
...
<JDBCDriver>
<ClassPath>
<Path>C:\\JDBC Drivers\\MSSQLSERVER2008\\msbase.jar</Path>
<Path>C:\JDBC Drivers\MSSQLSERVER2008\\msutil.jar</Path>
<Path>C:\\JDBC Drivers\\MSSQLSERVER2008\\mssqlserver.jar</Path>
</ClassPath>
...
</JDBCDriver>
...
</DataBase>
5.3.3 Création d'une connexion JDBC avec le paramètre Extensions
•
Procurez-vous le logiciel de pilote JDBC nécessaire pour la base de données et copiez les fichiers
sur votre système. Ces fichiers sont disponibles auprès du fournisseur de la base de données. Le
logiciel du pilote est généralement constitué d'un ou de plusieurs fichiers JAR.
•
Vérifiez que vous disposez des informations nécessaires pour accéder à la base de données (mot
de passe et nom de connexion, par exemple).
1. Accédez à la section suivante du guide pour rechercher les valeurs du paramètre Extensions.
2. Utilisez une ou plusieurs des valeurs du paramètre Extensions pour créer vos propres répertoires
de pilote.
Par exemple, les valeurs du paramètre Extensions pour le middleware MS SQL Server 2008 sont
sqlsrv2008, sqlsrv et jdbc dans le fichier sqlsrv.sbo. Vous pouvez créer l'un des répertoires
suivants :
• rép-install-serveurdeconnexion\connectionServer\jdbc\drivers\sqlsrv2008
• connectionserver-install-dir\connectionServer\jdbc\drivers\sqlsrv
• connectionserver-install-dir\connectionServer\jdbc\drivers\jdbc
3. Copiez les fichiers JAR dans les répertoires de votre choix.
4. Exécutez l'Assistant de connexion.
Le pilote JDBC que vous avez configuré apparaît dans la liste des connexions disponibles.
5. Sélectionnez le pilote JDBC et utilisez l'Assistant pour configurer la connexion.
Pour charger des pilotes JDBC, le serveur de connexion recherche les fichiers JAR dans chaque
répertoire, du plus spécifique au moins spécifique, jusqu'à ce qu'il les trouve. La connexion peut ensuite
être utilisée.
57
2013-09-19
Création d'une connexion
Exemple :
Par exemple, si vous stockez des fichiers JAR dans rép-install-serveurdeconnexion\conne
ctionServer\jdbc\drivers\sqlsrv uniquement, le serveur de connexion recherche d'abord
les pilotes dans le répertoire sqlsrv2008, s'aperçoit qu'il est vide, puis les recherche dans le répertoire
sqlsrv, trouve les fichiers JAR et charge le pilote.
Remarque :
Comme sqlsrv est la valeur Extensions de toutes les bases de données cibles MS SQL Server,
les fichiers JAR spécifiés dans ce répertoire sont chargés pour toutes les bases de données
MS SQL Server.
Rubriques associées
• Création d'une connexion JDBC avec le fichier SBO
• Fichiers de configuration d'accès aux données
5.3.4 Pour créer une connexion Generic JDBC
•
Se procurer le logiciel de pilote JDBC nécessaire pour la base de données. Vous devez installer le
fichier .jar sur l'ordinateur exécutant l'application SAP BusinessObjects.
•
Vérifiez que vous disposez des informations nécessaires pour accéder à la base de données (mot
de passe et nom de connexion, par exemple).
1. Accédez au répertoire contenant les fichiers jdbc.sbo et jdbc.prm.
Par exemple, sous Microsoft Windows, les fichiers de configuration se trouvent dans le répertoire
connectionserver-install-dir\connectionServer\jdbc.
2. Copiez le fichier .jar requis dans le répertoire connectionserver-install-dir\connectio
nServer\jdbc\drivers\jdbc.
Si celui-ci n'existe pas, vous devez le créer.
3. Exécutez l'Assistant de connexion.
Le pilote JDBC apparaît dans la liste des connexions disponibles sous Générique.
4. Sélectionnez le pilote JDBC et utilisez l'assistant pour configurer la connexion en fournissant les
informations suivantes :
• URL de JDBC
• Classe JDBC
• nom d'utilisateur
• password
A la fin de cette tâche, la connexion à la source de données est disponible pour être utilisée via JDBC.
58
2013-09-19
Création d'une connexion
Remarque :
Le fichier jdbc.prm contient uniquement les informations concernant les fonctions génériques d'une
base de données JDBC. Vous pouvez ajouter ou mettre à jour dans le fichier toute information spécifique
à une base de données personnalisée. Les modifications apportées au fichier jdbc.prm s'appliquent
à toutes les connexions JDBC génériques déjà créées ou qui le seront plus tard.
Rubriques associées
• Fichiers de configuration d'accès aux données
• A propos des fichiers PRM
5.3.5 Informations de référence sur l'emplacement des fichiers JAR
Le tableau suivant décrit les noms des dossiers dans lesquels les fichiers JAR des middleware doivent
être placés pour activer les connexions JDBC. La première colonne répertorie les noms des fournisseurs
de bases de données dans l'Assistant de connexion. La deuxième colonne répertorie les noms des
bases de données qui prennent en charge les connexions JDBC, conformément à la section DataBase
du fichier SBO correspondant. La troisième colonne répertorie les noms des dossiers que vous pouvez
créer, conformément aux valeurs du paramètre Extensions du fichier SBO.
Le paramètre Extensions est un élément enfant de l'élément DataBase correspondant au middleware
de base de données cible dans les fichiers SBO. S'il ne se trouve pas dans la section DataBase, cela
signifie que la valeur de paramètre est valide pour tous les middlewares configurés dans le fichier SBO.
Reportez-vous ensuite à la section Defaults du fichier. Sous Microsoft Windows, les fichiers de
configuration JDBC se trouvent dans le répertoire rép-install-connectionserver\connectio
nServer\jdbc.
Remarque :
Les pilotes JDBC Data Federator sont installés dans le cadre de la plateforme de BI dans le répertoire
rép-install-connectionserver\connectionServer\jdbc\drivers\datafederator. Les
pilotes JDBC SAP HANA 1.0 SPS 06 sont installés dans le répertoire rép-install-serveurdeco
nnexion\connectionServer\jdbc\drivers\newdb. Par conséquent, aucune configuration
supplémentaire n'est requise pour créer une connexion vers le serveur de requêtes Data Federator XI 3.0
ou une base de données SAP HANA.
59
2013-09-19
Création d'une connexion
Fournisseur
Base de données
Valeurs du paramètre Extensions
Derby 10 incorporé
derby10, derby, jdbc
Apache Hadoop Hive 0.7
apache, hive, hive07, jdbc
Apache Hadoop Hive 0.8
apache, hive, hive08, jdbc
Apache Hadoop Hive 0.9
apache, hive, hive09, jdbc
Apache Hadoop Hive 0.10
apache, hive, hive010, jdbc
Amazon EMR Hive 0.7
amazon, hive, emrhive07, jdbc
Amazon EMR Hive 0.8
amazon, hive, emrhive08, jdbc
PostgreSQL 8
postgresql8, postgresql, jdbc
GreenPlum4, PostgreSQL 9
postgresql9, postgresql, jdbc
Hewlett Packard
HP Neoview
neoview, jdbc
HSQLDB
HSQLDB 1.8 incorporé
hsqldb18, hsqldb, jdbc
DB2 v9
db2v9, db2udb, db2, jdbc
DB2 10 pour z/OS
db2mvs10, db2mvs, db2, jdbc
DB2 10 pour LUW
db2v10, db2udb, db2, jdbc
Informix Dynamic Server 11
ids11, informix, jdbc
Base de données Ingres 9
ingres9, ingres, jdbc
MS SQL Server 2008
sqlsrv2008, sqlsrv, jdbc
MS SQL Server 2012
sqlsrv2012, sqlsrv, jdbc
Apache
Greenplum
IBM
Ingres
Microsoft
60
2013-09-19
Création d'une connexion
Fournisseur
Base de données
Valeurs du paramètre Extensions
Netezza Server 4
netezza4, netezza, jdbc
Netezza Server 5
netezza5, netezza, jdbc
Netezza Server 6
netezza6, netezza, jdbc
Netezza Server 7
netezza7, netezza, jdbc
MySQL 5
mysql5, mysql, jdbc
Oracle 10
oracle10, oracle, jdbc
Oracle 11
oracle11, oracle, jdbc
Oracle Exadata
oracleexadata, oracle11, oracle, jdbc
Data Federator XI R3
datafederator3, datafederator, jdbc
Data Federator XI R4
datafederator4, datafederator, jdbc
MaxDB 7.7
maxdb7.7, maxdb, jdbc
Base de données SAP HANA 1.0
newdb, jdbc
Netezza
Oracle
SAP
61
2013-09-19
Création d'une connexion
Fournisseur
Base de données
Valeurs du paramètre Extensions
Sybase Adaptive Server Enterprise 15.5
sybase15, sybase, jdbc
Sybase IQ 15
iq15, asiq, jdbc
Sybase IQ 16
iq16, asiq, jdbc
Sybase SQL Anywhere 11
ssa11, ssa, jdbc
Sybase SQL Anywhere 12
ssa12, ssa, jdbc
Sybase SQL Anywhere 16
ssa16, ssa, jdbc
Teradata 12
teradata12, teradata, jdbc
Teradata 13
teradata13, teradata, jdbc
Teradata 14
teradata14, teradata, jdbc
Sybase
Teradata
Rubriques associées
• Connexions SAP HANA
• A propos des connexions au serveur de requêtes Data Federator XI 3.0
5.3.6 Pour rechercher la version d'un pilote JDBC
Cette section décrit comment trouver la version du pilote de votre connexion JDBC.
Vous pouvez trouver la version du pilote JDBC utilisé dans le fichier META-INF/MANIFEST.MF contenu
dans le fichier JAR du pilote.
•
62
Effectuez l'une des actions suivantes :
2013-09-19
Création d'une connexion
Option
Description
Pour extraire le fichier à l'aide de
WinRAR
a. Lancez l'application WinRAR.
b. Faites glisser le fichier JAR et déposez-le dans la fenêtre
de l'application.
c. Développez le dossier META-INF.
d. Faites glisser le fichier MANIFEST.MF depuis WinRAR
et déposez-le dans un dossier local.
e. Ouvrez le fichier et cherchez la valeur Bundle-Ver
sion.
Pour extraire le fichier à partir d'une a. Ouvrez une invite de commande.
b. Accédez au dossier où extraire le fichier :
invite de commande
cd driver_path
c. Exécutez la commande suivante :
JAR_path\jar.exe -xf driver_path\driver_name.jar METAINF/MANIFEST.MF
d. Ouvrez le fichier et cherchez la valeur Bundle-Ver
sion.
Par exemple, exécutez les commandes suivantes pour
extraire la version du pilote SAP HANA JDBC :
cd C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessOb
jects Enterprise XI 4.0\dataAccess\connectionServer\jdbc\dri
vers\newdb
"C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects
Enterprise XI 4.0\win64_x64\jdk\bin\jar.exe" -xf ngdbc.jar
META-INF/MANIFEST.MF
Remarque :
Mettez le chemin d'accès au fichier JAR entre guillemets
s'il contient des espaces.
5.4 Création de connexions JavaBean
Un pilote d'accès aux données utilisant une connexion JavaBean est installé avec la plateforme de BI.
Ce pilote se trouve dans le répertoire rép-install-connectionserver\connectionServer\dri
vers\java.
Les développeurs peuvent aussi créer des connexions JavaBean qui fournissent un accès aux sources
de données. Vous pouvez créer des connexions à l'aide de ces JavaBeans. Afin de créer une connexion
JavaBean, les développeurs à l'origine du programme fournissent les informations suivantes :
•
63
Les fichiers JAR nécessaires.
2013-09-19
Création d'une connexion
•
Les autres fichiers requis par JavaBean.
•
Tous les paramètres de configuration spécifiques requis par le pilote JavaBean.
Concernant les connexions JDBC, vous pouvez également créer une connexion JavaBean à l'aide la
fonctionnalité Extensions.
Remarque :
Avec un pilote JavaBean, les procédures d'extraction des données sont configurées en tant que
procédures stockées. Lorsque vous créez une connexion JavaBean à l'aide de l'Assistant de connexion,
vous devez cocher la case Filtrer les couches réseau des procédures stockées dans l'écran
Sélection du middleware de base de données. Si vous ne procédez pas ainsi, l'Assistant de connexion
n'affiche pas les pilotes JavaBean disponibles.
Rubriques associées
• Création de connexions JDBC
• Création d'une connexion JavaBean
• Création d'une connexion JavaBean avec le paramètre Extensions
5.4.1 Création d'une connexion JavaBean
1. Utilisez un éditeur XML pour ouvrir le fichier javabean.sbo à modifier.
Par exemple, sous Microsoft Windows, les fichiers de configuration se trouvent dans le répertoire
rép-install-connectionserver\connectionServer\javabean.
2. Ajoutez les informations du fichier .jar requises à la zone Chemin de la classe. Veillez à
inclure les noms de chemins complets lorsque vous spécifiez ces fichiers.
Remarque :
Ces fichiers doivent être installés sur l'ordinateur exécutant l'application SAP BusinessObjects.
Pour en savoir plus, reportez-vous aux informations sur la structure du fichier d'exemple java
bean.sbo.
3. Enregistrez le fichier et fermez-le.
4. Exécutez toutes les autres tâches de configuration spécifiées par le développeur de JavaBean.
5. Exécutez l'Assistant de connexion.
La source de données JavaBean que vous avez configurée doit apparaître dans la liste des
connexions disponibles.
6. Sélectionnez la source de données JavaBean et utilisez l'Assistant pour configurer la connexion.
A la fin de cette tâche, la connexion est disponible pour être utilisée avec l'application.
Rubriques associées
• Fichiers de configuration d'accès aux données
64
2013-09-19
Création d'une connexion
5.4.2 Exemple de structure de fichiers SBO JavaBean
Cette section contient un exemple de fichier SBO JavaBean.
<DataBase Active="Yes" Name="Excel Spreadsheet">
<JavaBean>
<ClassPath>
<Path>$ROOT$\\beans\\bean_excel.jar</Path>
</ClassPath>
<Parameter Name="JavaBean Class">com.businessobjects.beans.excel.Excel</Parameter>
<Parameter Name="URL Format">$DATASOURCE$</Parameter>
</JavaBean>
<Parameter Name="Family">Java Beans</Parameter>
<Parameter Name="Description File">bean_excel</Parameter>
<Parameter Name="Authentication Mode">Bypass</Parameter>
<Parameter Name="Extensions">bean_excel,javabean</Parameter>
</DataBase>
</DataBases>
5.4.3 Création d'une connexion JavaBean avec le paramètre Extensions
1. Accédez au répertoire contenant le fichier javabean.sbo.
Par exemple, sous Microsoft Windows, le fichier se trouve dans le répertoire rép-install-conne
ctionserver\connectionServer\javabean.
2. Ouvrez le fichier SBO à afficher.
3. Recherchez l'élément <Parameter Name="Extensions"> dans la section Defaults.
Remarque :
Si vous développez un pilote JavaBean à l'aide du DDK, recherchez le paramètre Extensions
dans l'élément <DataBase Active="Yes" Name="Excel Spreadsheet">.
4. Utilisez une ou plusieurs des valeurs du paramètre Extensions pour créer vos propres répertoires
de pilote.
Par exemple, la valeur du paramètre Extensions est javabean dans la section Defaults du
fichier. Vous pouvez ensuite créer le répertoire rép-install-connectionserver\connectio
nServer\javabean\drivers\javabean.
5. Copiez les fichiers JAR dans les répertoires de votre choix.
6. Fermez le fichier SBO.
7. Exécutez l'Assistant de connexion.
Le pilote JavaBean que vous avez configuré apparaît dans la liste des connexions disponibles.
8. Sélectionnez le pilote JavaBean et utilisez l'Assistant pour configurer la connexion.
65
2013-09-19
Création d'une connexion
Pour charger des pilotes JavaBean, le serveur de connexion recherche les fichiers JAR dans chaque
répertoire, du plus spécifique au moins spécifique, jusqu'à ce qu'il les trouve. La connexion peut ensuite
être utilisée.
Rubriques associées
• Création d'une connexion JavaBean
• Fichiers de configuration d'accès aux données
5.5 Création de connexions ODBC
Un ensemble de pilotes d'accès aux données est installé avec la plateforme de BI. Vous pouvez utiliser
ces pilotes d'accès aux données pour créer des connexions aux bases de données. Ces pilotes se
trouvent dans le répertoire rép-install-connectionserver\connectionServer\dri
vers\lib32 ou rép-install-connectionserver\connectionServer\drivers\lib64.
Le logiciel SAP BusinessObjects inclut également des fichiers de configuration pour l'utilisation de
pilotes ODBC comme moyen d'accès aux bases de données. Pour utiliser ces pilotes, procédez comme
suit :
1. Procurez-vous le logiciel du pilote ODBC auprès de votre fournisseur de base de données.
2. Modifiez les fichiers de configuration fournis.
La plupart des pilotes ODBC sont disponibles en mode Unicode et non-Unicode.
Pour obtenir la liste la plus récente des pilotes ODBC pris en charge, visitez le site
SAP Service MarketPlace à l'adresse http://service.sap.com/bosap-support ou contactez votre
représentant SAP.
Remarque :
La couche d'accès aux données fournit la connectivité ODBC générique qui permet de créer une
connexion à une source de données que la plateforme de BI ne prend pas explicitement en charge.
A propos des connexions Generic ODBC sous UNIX
Le système d'exploitation Windows est fourni avec un gestionnaire de pilotes ODBC standard. En
revanche, UNIX ne propose aucune méthode de gestion des pilotes. Le logiciel
SAP BusinessObjects Enterprise permet d'utiliser des gestionnaires de pilotes DataDirect ou unixODBC
pour les connexions Generic ODBC sous UNIX.
Avant de créer une connexion Generic ODBC sous UNIX pour une base de données spécifique, vous
devez identifier ce qui suit :
•
•
La version du pilote ODBC.
Si le pilote peut fonctionner avec le gestionnaire de pilotes DataDirect ou unixODBC.
Vous devez ensuite modifier les fichiers de configuration fournis et configurer la source de données
appropriée afin d'activer la connexion.
66
2013-09-19
Création d'une connexion
Rubriques associées
• Création d'une connexion Generic ODBC
• Création d'une connexion Generic ODBC3
5.5.1 Création d'une connexion Generic ODBC
La procédure suivante explique comment configurer une connexion Generic ODBC à une base de
données en partant du principe que :
• Le pilote est de type ODBC2
• Le pilote prend en charge le gestionnaire de pilotes unixODBC
1. Accédez au répertoire contenant les fichiers odbc.sbo et odbc.prm.
Les fichiers de configuration se trouvent dans le répertoire rép-install-connectionserver/co
nnectionServer/odbc.
2. Utilisez un éditeur XML pour ouvrir le fichier odbc.sbo à modifier.
3. Recherchez la section suivante :
<DataBases>
<DataBase Active="Yes" Name="Generic ODBC datasource">
<Libraries>
...
<Library Platform="Unix">dbd_wddodbc</Library>
<Library Platform="Unix">dbd_ddodbc</Library>
<!--Library Platform="Unix">dbd_wuxodbc</Library-->
<!--Library Platform="Unix">dbd_uxodbc</Library-->
</Libraries>
<Parameter Name="Charset Table" Platform="Unix">datadirect</Parameter>
...
</DataBases>
4. Commentez les deux premières lignes pour DataDirect et supprimez le commentaire d'une des deux
lignes suivantes. Veillez à placer la ligne modifiée en haut de la section, afin qu'elle soit lue en
premier. Commentez l'élément <Parameter Name="CharSet Table" Platform="Unix">.
Remarque :
•
•
•
•
dbd_wddodbc indique le pilote Unicode ODBC2 basé sur DataDirect
dbd_ddodbc indique le pilote non-Unicode ODBC2 basé sur DataDirect
dbd_wuxodbc indique le pilote Unicode ODBC2 basé sur unixODBC
dbd_uxodbc indique le pilote non-Unicode ODBC2 basé sur unixODBC
5. Enregistrez le fichier odbc.sbo, puis fermez-le.
6. Utilisez un éditeur XML pour ouvrir le fichier odbc.prm à modifier.
7. Ajoutez ou mettez à jour les informations spécifiques à la base de données.
Remarque :
Il est possible que le fichier odbc.prm ne contienne pas d'informations sur les fonctions spécifiques
de la base de données.
8. Enregistrez le fichier odbc.prm, puis fermez-le.
67
2013-09-19
Création d'une connexion
9. Installez les pilotes ODBC appropriés sur votre ordinateur UNIX.
10. Configurez la source de données en modifiant le fichier odbc.ini.
11. Enregistrez le fichier odbc.ini, puis fermez-le.
12. Exécutez l'Assistant de connexion.
Le pilote ODBC que vous avez configuré apparaît dans la liste des connexions disponibles sous
Générique.
13. Sélectionnez le pilote ODBC et utilisez l'Assistant pour configurer la connexion.
A la fin de cette tâche, la connexion à la source de données est disponible pour être utilisée via Generic
ODBC avec le gestionnaire de pilotes unixODBC.
Rubriques associées
• Fichiers de configuration d'accès aux données
5.5.2 Création d'une connexion Generic ODBC3
La procédure suivante explique comment configurer une connexion Generic ODBC à une base de
données en partant du principe que :
• Le pilote est de type ODBC3
• Le pilote prend en charge le gestionnaire de pilotes unixODBC
1. Accédez au répertoire contenant les fichiers odbc.sbo et odbc.prm.
Les fichiers de configuration se trouvent dans le répertoire rép-install-connectionserver/co
nnectionServer/odbc.
2. Utilisez un éditeur XML pour ouvrir le fichier odbc.sbo à modifier.
3. Recherchez la section suivante :
<DataBases>
<DataBase Active="Yes" Name="Generic ODBC3 datasource">
<Libraries>
...
<Library Platform="Unix">dbd_wddodbc3</Library>
<Library Platform="Unix">dbd_ddodbc3</Library>
<!--Library Platform="Unix">dbd_wuxodbc3</Library-->
<!--Library Platform="Unix">dbd_uxodbc3</Library-->
<!--Library Platform="Unix64">dbd_wux32odbc3</Library-->
<!--Library Platform="Unix64">dbd_ux32odbc3</Library-->
</Libraries>
<Parameter Name="Charset Table" Platform="Unix">datadirect</Parameter>
...
</DataBases>
4. Commentez les deux premières lignes pour DataDirect et supprimez le commentaire d'une des
quatre lignes suivantes. Veillez à placer la ligne modifiée en haut de la section, afin qu'elle soit lue
en premier. Commentez l'élément <Parameter name="CharSet Table" Platform="Unix">.
Remarque :
•
68
dbd_wddodbc3 indique le pilote Unicode ODBC3 basé sur DataDirect
2013-09-19
Création d'une connexion
•
•
•
•
•
dbd_ddodbc3 indique le pilote non-Unicode ODBC3 basé sur DataDirect
dbd_wuxodbc3 indique le pilote Unicode ODBC3 basé sur unixODBC
dbd_uxodbc3 indique le pilote non-Unicode ODBC3 basé sur unixODBC
dbd_wux32odbc3 indique le pilote Unicode ODBC3 basé sur unixODBC ayant une API 32 bits
au lieu de 64 bits (disponible uniquement sur les plateformes 64 bits)
dbd_ux32odbc3 indique le pilote non-Unicode ODBC3 basé sur unixODBC ayant une API
32 bits au lieu de 64 bits (disponible uniquement sur les plateformes 64 bits)
5. Enregistrez le fichier odbc.sbo, puis fermez-le.
6. Utilisez un éditeur XML pour ouvrir le fichier odbc.prm à modifier.
7. Ajoutez ou mettez à jour les informations spécifiques à la base de données.
Remarque :
Il est possible que le fichier odbc.prm ne contienne pas d'informations sur les fonctions spécifiques
de la base de données.
8. Enregistrez le fichier odbc.prm, puis fermez-le.
9. Installez les pilotes ODBC appropriés sur votre ordinateur UNIX.
10. Configurez la source de données en modifiant le fichier odbc.ini.
11. Enregistrez le fichier odbc.ini, puis fermez-le.
12. Exécutez l'Assistant de connexion.
Le pilote ODBC que vous avez configuré apparaît dans la liste des connexions disponibles sous
Générique.
13. Sélectionnez le pilote ODBC et utilisez l'Assistant pour configurer la connexion.
A la fin de cette tâche, la connexion à la source de données est disponible pour être utilisée via ODBC3
avec le gestionnaire de pilotes unixODBC.
Rubriques associées
• Fichiers de configuration d'accès aux données
69
2013-09-19
Création d'une connexion
70
2013-09-19
Informations de référence sur le pilote d'accès aux données
Informations de référence sur le pilote d'accès aux
données
6.1 Pilotes d'accès aux données
Ce chapitre fournit des informations détaillées sur certains pilotes d'accès aux données, qui permettent
de se connecter aux sources de données à l'aide de documents OData ou XML et à des bases de
données spécifiques telles que des systèmes SAP ERP de type ABAP. Il décrit principalement des
règles de mappage entre des modèles de données non triviaux et le modèle relationnel utilisé dans la
couche d'accès aux données.
Il ne concerne que les connexions qui seront créées dans l'outil de conception d'information.
Rubriques associées
• CSV OpenDriver
• Pilote OData
• Pilote SAP ERP
• Pilote XML
• Pilote de services Web
6.2 CSV OpenDriver
La couche d'accès aux données permet à la plateforme de BI de se connecter aux fichiers CSV (valeurs
séparées par des virgules) via la couche réseau BusinessObjects OpenConnectivity. Elle fournit un
pilote d'accès aux données nommé CSV OpenDriver afin d'accéder aux fichiers CSV.
L'Assistant de connexion fournit un workflow pour entrer les informations requises afin de se connecter
aux fichiers CSV. Les sources de données CSV sont visibles sous le SGBD Fichiers texte et la
couche réseau BusinessObjects OpenConnectivity.
Rétrocompatibilité
La rétrocompatibilité entre les versions SAP BusinessObjects Enterprise XI 3.x et la plateforme
SAP BusinessObjects 4.1 de Business Intelligence n'est prise en charge que pour les documents créés
à l'aide d'une connectivité ODBC.
71
2013-09-19
Informations de référence sur le pilote d'accès aux données
Lorsque l'utilisateur d'un rapport actualise dans Web Intelligence Rich Client un document basé sur
une connectivité BusinessObjects OpenConnectivity en mode 3-Tier qui a été créé avec la version XI 3.x,
l'exception suivante se produit :
Database error: (CS) "Specified network layer is invalid : BO OC". (IES 10901) (WIS 10901)
Comme les versions XI 3.x ne prennent pas en charge la connectivité JDBC en mode à trois niveaux,
BusinessObjects OpenConnectivity n'est pas reconnue comme une couche réseau lorsque l'utilisateur
tente d'actualiser un document dans la version 4.1.
6.2.1 Fonctionnalités CSV OpenDriver
Sachant que les fichiers texte ne fournissent aucune opération de base de données, le pilote d'accès
aux données implémente les fonctionnalités de requête suivantes :
•
•
•
•
•
Les opérations de base pour les instructions SELECT (WHERE, ORDER BY, GROUP BY et AS)
Les opérateurs de base qui figurent dans la clause WHERE sont : (=, <>, <, <=, >, >=, BETWEEN,
NOT BETWEEN, LIKE, NOT LIKE, IS NULL, IS NOT NULL, AND, OR)
L'utilisation de caractères génériques ("?") dans la clause WHERE
La clause DISTINCT de l'instruction SELECT
UNION et UNION ALL
Le pilote d'accès aux données prend également en charge les fonctions de regroupement MIN, MAX,
AVG, SUM et COUNT dans les instructions SELECT.
Restrictions relatives au pilote
Le pilote CSV OpenDriver n'implémente aucune fonctionnalité modifiant l'état du fichier CSV, par
exemple les instructions INSERT, UPDATE et ALTER. Le pilote d'accès aux données ne prend pas
non plus en charge les index ni les opérations JOIN sur les fichiers CSV.
Rubriques associées
• Disque local utilisé en tant que cache pour les opérations de tri
Le pilote d'accès aux données CSV OpenDriver et les pilotes OData, SAP ERP, XML et
de services Web peuvent utiliser le disque local en tant que cache pour les lignes triées.
6.2.2 CSV OpenDriver : Mappage de tables
Le pilote d'accès aux données fournit les fichiers CSV sous forme de tables dans l'outil de conception
d'information.
72
2013-09-19
Informations de référence sur le pilote d'accès aux données
Vous pouvez vous connecter à plusieurs fichiers si le paramètre Chemin d'accès ou modèle de
l'Assistant de connexion est défini sur un modèle, par exemple report_*.csv, rapproché par des
fichiers tels que report_2010-09-22.csv et report_2010-09-21.csv.
Rappel :
Vous ne pouvez pas vous connecter à plusieurs fichiers situés sur un serveur HTTP Le protocole HTTP
ne prend pas en charge l'utilisation des éléments génériques dans les modèles.
Le pilote applique l'un des processus suivants :
•
•
Si le paramètre Fusionner les fichiers est sélectionné dans l'Assistant de connexion, tous les
fichiers CSV sont mappés à une table unique. On présume qu'ils ont tous le même schéma. Il s'agit
du comportement par défaut du pilote d'accès aux données.
Si le paramètre n'est pas sélectionné, chaque fichier CSV est mappé à une table différente.
Mappage de tous les fichiers vers une table
Le nom de la table correspond au nom du modèle, par exemple report_*.csv. La table est dotée
d'une colonne supplémentaire sourcefile, qui contient le nom du fichier source pour chaque ligne
de table.
Si vous utilisez un fichier SQLDDL pour fournir le schéma, le nom de la table doit également correspondre
au modèle.
Si les fichiers ont des noms de colonne différents, les noms de colonne de la table résultante sont ceux
du premier fichier analysé par le pilote, sachant que les fichiers sont analysés dans l'ordre alphabétique.
Mappage d'un fichier vers une table
Le nom de chaque table correspond au nom de fichier de sa source de données.
Si vous utilisez un fichier SQLDDL pour fournir le schéma, le nom de la table dans l'instruction CREATE
doit correspondre au nom du fichier.
Indépendamment de la valeur du paramètre, le chemin d'accès au fichier est mappé au qualificateur
de table.
Exemple : Noms de colonne
Si le fichier report_1.csv contient les colonnes col1, ..., et col10 alors que le fichier re
port_2.csv contient les colonnes column1, ..., et column10, les colonnes de la table résultante
sont col1, ..., et col10.
Exemple : Qualificateur
Si C:\reports\report_1.csv est la source de données, le qualificateur est C:\reports\ et le
nom de table est report_1.csv.
Rubriques associées
• Emplacement du fichier CSV
• Détection du schéma CSV
73
2013-09-19
Informations de référence sur le pilote d'accès aux données
6.2.3 Emplacement du fichier CSV
CSV Les fichiers utilisés comme sources de données peuvent être des fichiers locaux ou distants. Pour
les fichiers de systèmes distants, les protocoles HTTP, FTP et SMB (également appelé CIFS) sont pris
en charge. La version actuelle prend également en charge les protocoles chiffrés HTTPS et FTPS
basés sur un certificat. CSV Les fichiers peuvent se trouver sur le CMS (Central Management Server)
de la plateforme de BI.
Remarque :
SMB désigne le protocole de partage de fichiers standard sous MS Windows. Etant donné que la
bibliothèque jCIFS fournit un accès au protocole, vous devez installer le fichier JAR jCIFS dans le
répertoire du serveur de connexion, à savoir rép-install-serveurdeconnexion\connection
Server\sharedLibraries\jcifs. Vous devez installer la version 1.3.15, disponible à l'adresse
suivante : http://jcifs.samba.org/.
Vous pouvez déterminer si la source de données est locale ou distante via le paramètre Type
d'emplacement de l'Assistant de connexion. Si la source de données est distante, vous devez définir
le protocole utilisé via le paramètre Protocole de l'Assistant. La valeur de Protocole doit correspondre
au protocole spécifié dans les valeurs de paramètre Chemin d'accès ou modèle et Fichier de schéma.
Exemple : Chemins d'accès au fichier CSV
•
•
•
•
C:\csv\report.csv ou file:///C:/csv/report.csv pour un fichier local
http://server:8080/path/report.csv pour un fichier accessible via HTTP
ftp://server/path/ pour des fichiers accessibles via FTP
smb://server:port/myshare/mydirectory pour des fichiers accessibles via SMB
6.2.4 Détection du schéma CSV
La couche d'accès aux données fournit les méthodes suivantes pour la détection du schéma d'un fichier
CSV :
•
•
•
•
Pas de détection
Détection automatique
Utilisation d'un fichier DDL (Data Definition Language)
Utilisation d'un fichier DDL SQL
Pour choisir la méthode à appliquer aux fichiers, utilisez le paramètre Détection du schéma dans
l'Assistant de connexion. Vous pouvez fournir le schéma en utilisant des fichiers de schéma (DDL ou
SQLDDL). Cela peut s'avérer utile pour les fichiers volumineux et complexes.
Les fichiers sont analysés dans l'ordre alphabétique.
74
2013-09-19
Informations de référence sur le pilote d'accès aux données
Remarque :
Les premières lignes d'un fichier CSV peuvent contenir des commentaires et être ignorées à l'aide du
paramètre Nombre initial de lignes de commentaires dans l'Assistant.
Pas de détection
Le pilote d'accès aux données ignore les lignes de commentaires, analyse la première ligne et détermine
le nombre de colonnes mais pas les types de colonne. Toutes les valeurs sont considérées comme
des chaînes et la taille des colonnes est définie sur 255 caractères, ce qui correspond à la longueur
standard du type de données VARCHAR. Une valeur supérieure à 255 est tronquée. Les colonnes
peuvent contenir des valeurs nulles.
Détection automatique
Rappel :
Cette méthode ne peut pas être appliquée à des fichiers CSV contenant des colonnes de longueur fixe.
Le pilote d'accès aux données analyse les fichiers corrects et obtient les informations suivantes :
•
noms de colonne
En règle générale, la première ligne contient les noms de colonne. Sinon, le pilote CSV OpenDriver
génère des noms de colonne au format column_0, column_1, …, column_n.
•
Types de colonne
Le pilote recherche les types de colonne en utilisant des modèles prédéfinis et des paramètres
utilisateur pour les types de données numérique, date et heure. Si une colonne contient des valeurs
de différents types, le pilote considère les valeurs de colonne comme des chaînes.
•
Tailles de colonne
La taille d'une colonne dépend de son type. Pour les valeurs numériques, la taille de la colonne
représente la longueur de la valeur la plus élevée dans la plage du type. Pour les autres valeurs, il
s'agit de la longueur de la valeur de la chaîne la plus longue trouvée lors de la détection.
Attention :
Pour permettre au pilote de trouver la chaîne la plus longue, l'optionLignes de test doit être définie
sur tous.
•
Caractère nul des colonnes
Le caractère nul est défini sur vrai s'il existe une valeur nulle dans la colonne et sur faux si toutes
les valeurs sont renseignées.
A moins de sélectionner toutes les lignes, vous sélectionnez le nombre de lignes que le pilote doit
analyser en définissant le paramètre Nombre de lignes de test dans l'Assistant de connexion.
Voir les recommandations dans le Guide de l'utilisateur de l'outil de conception d'information.
Utilisation de fichiers DDL
Le pilote d'accès aux données analyse le fichier DDL pour convertir les types de données SQL en type
de données du pilote.
75
2013-09-19
Informations de référence sur le pilote d'accès aux données
Le fichier DDL suit le modèle ci-dessous :
ColumnName[:ColumnType[(Length)]];
Par exemple :
col1:VARCHAR(20);
col2:DATE;
col3:INTEGER;
col4:INTEGER;
Le fichier DDL ne peut définir qu'un seul schéma de tables. Le pilote affecte le même schéma à chaque
fichier CSV utilisé comme source de données.
Utilisation de fichiers SQLDDL
Le pilote d'accès aux données analyse le fichier SQLDDL pour convertir les types de données SQL en
type de données du pilote.
Le fichier SQLDDL suit le modèle ci-dessous :
CREATE TABLE <Filename> (
(<ColumnName> <ColumnType> [NOT] NULL,)*
(<ColumnName> <ColumnType> [NOT] NULL)
);
Par exemple :
CREATE TABLE Clients (
id INTEGER NOT NULL,
name CHAR(20) NULL,
date DATE NULL,
PRIMARY KEY (id) )
Le fichier SQLDDL peut définir plusieurs schémas de tables. Le pilote peut affecter un schéma à
plusieurs tables.
Le pilote d'accès aux données analyse les instructions CREATE et ignore les autres, le cas échéant.
Si le fichier DDL ou SQLDD ne définit pas un type de colonne, le pilote considère les valeurs de colonne
comme des chaînes de 255 caractères. Une valeur supérieure à 255 est tronquée. Si le fichier DDL
ou SQLDD fournit un type mais pas sa longueur, le pilote utilise des longueurs standard, comme 10
pour les entiers. La précision et l'échelle sont obligatoires pour le type de données DECIMALE.
6.3 Pilote OData
La couche d'accès aux données permet à la plateforme de BI de se connecter aux sources de données
qui utilisent le protocole Open Data (OData). Elle fournit un pilote d'accès aux données nommé pilote
OData pour accéder aux sources de données en ligne via des sites Internet ou des intranets. Le pilote
OData prend en charge le protocole OData 2.0, dont le schéma est décrit en CSDL 2.0 (Conceptual
Schema Definition Language).
Le pilote OData permet à la plateforme de BI de se connecter aux services OData exposés par SAP
NetWeaver Gateway 2.0. SAP NetWeaver Gateway 2.0 permet aux utilisateurs d'application d'accéder
aux données des systèmes SAP Business Suite tels qu'ERP et CRM via HTTP.
76
2013-09-19
Informations de référence sur le pilote d'accès aux données
L'Assistant de connexion fournit un workflow pour saisir les informations requises afin de se connecter
aux sources de données OData. Les sources de données OData s'affichent sous le système de gestion
de bases de donnéesGeneric OData 2.0 et la couche réseau OData Connector.
Les fichiers de configuration du pilote se trouvent dans le répertoire rép-install-serveurdecon
nexion\connectionServer\odata. Le fichier odata.prm répertorie les fonctionnalités du pilote
d'accès aux données en termes de fonctions et d'opérations de base de données.
6.3.1 Fonctionnalités du pilote OData
Le pilote d'accès aux données prend en charge les fonctionnalités de requêtes suivantes :
•
•
•
Opérations de base de données basiques (SELECT, WHERE, ORDER BY, jointures structurées)
Opérateurs de filtrage de base dans la clause WHERE (=, !=, <, <=, >, >=, AND, OR, LIKE, NOT
LIKE, BETWEEN, NOT BETWEEN, IS NULL, IS NOT NULL)
Les requêtes imbriquées dans la clause FROM
Le pilote d'accès aux données prend en charge les opérations AS, DISTINCT et GROUP BY, bien
qu'elles ne puissent pas être exprimées dans le protocole OData 2.0. Le pilote exécute ces opérations
de manière interne.
Restriction :
La version actuelle du pilote OData ne prend pas en charge les fonctionnalités suivantes :
• Opérations UNION et UNION ALL
• Clause HAVING
• Opération DISTINCT dans les fonctions d'agrégation
• Sous-requêtes de la clause WHERE
Fonctions de base de données
Le pilote d'accès aux données prend en charge les fonctions de base de données AVG, MIN, MAX et
SUM, bien qu'elles ne puissent pas être exprimées dans le protocole OData 2.0. Le pilote exécute ces
opérations de manière interne. Le protocole OData 2.0 prend uniquement en charge la fonction COUNT,
qui correspond à l'opérateur $count.
Rubriques associées
• Pilote OData : Mappage des clés
• Pilote OData : Restrictions et comportements non triviaux
• Disque local utilisé en tant que cache pour les opérations de tri
77
2013-09-19
Informations de référence sur le pilote d'accès aux données
Le pilote d'accès aux données CSV OpenDriver et les pilotes OData, SAP ERP, XML et
de services Web peuvent utiliser le disque local en tant que cache pour les lignes triées.
6.3.2 Emplacement du service Northwind
Vous ne pouvez pas vous connecter aux services OData via HTTP. La version actuelle prend également
en charge les protocoles chiffrés HTTPS basés sur un certificat.
Exemple :
Les liens suivants font référence aux exemples des services OData via HTTP et HTTPS et à un
exemple du service SAP NetWeaver Gateway.
Rubriques associées
• http://services.odata.org/Northwind/Northwind.svc/
• https://api.datamarket.azure.com/Data.ashx/data.gov/Crimes/
• http://gw.esworkplace.sap.com/sap/opu/odata/sap/SALESORDERS/
6.3.3 Exemple de service OData
Une source de données OData fournit ses données selon un schéma basé sur l'EDM (Entity Data
Model). Le schéma est décrit à l'aide du format CSDL. Le CSDL est un format XML qui décrit la structure
et la sémantique des schémas Entity Data Model.
Les exemples suivants illustrent la structure d'un schéma basé sur CSDL. Ce schéma définit les
métadonnées d'une source de données OData qui fournit le service Northwind. L'URI du service est
http://services.odata.org/Northwind/Northwind.svc/. Pour en savoir plus sur les concepts qui régissent
un EDM, voir CSDL specification.
Rappel :
La version actuelle du pilote OData ne prend pas en charge les propriétés FunctionImports,
AnnotationElements, ReferentialConstraints, ni les propriétés dynamiques.
Exemple : Schéma du service Northwind
L'accès au schéma se fait à partir de http://services.odata.org/Northwind/Northwind.svc/$metadata.
78
2013-09-19
Informations de référence sur le pilote d'accès aux données
Remarque :
L'élément ComplexType fictif CustomerClothing et l'élément Property CustomerClothes ont été
ajoutés à l'exemple à des fins de documentation.
<Schema Namespace ="NorthwindModel">
...
<EntityType Name="Customer">
<Key>
<PropertyRef Name="CustomerID"/>
</Key>
<Property Name="CustomerID" Type="Edm.String" Nullable="false" MaxLength="5" Unicode="true" FixedLe
ngth="true"/>
<Property Name="CompanyName" Type="Edm.String" Nullable="false" MaxLength="40" Unicode="true" FixedLe
ngth="false"/>
<Property Name="ContactName" Type="Edm.String" Nullable="true" MaxLength="30" Unicode="true" FixedLe
ngth="false"/>
<Property Name="ContactTitle" Type="Edm.String" Nullable="true" MaxLength="30" Unicode="true" FixedLe
ngth="false"/>
<Property Name="CustomerClothes" Type="NorthwindModel.CustomerClothing" Nullable="false">
...
<NavigationProperty Name="Orders" Relationship="NorthwindModel.FK_Orders_Customers" FromRole="Customers"
ToRole="Orders"/>
<NavigationProperty Name="CustomerDemographics" Relationship="NorthwindModel.CustomerCustomerDemo" From
Role="Customers" ToRole="CustomerDemographics"/>
</EntityType>
<ComplexType Name="CustomerClothing">
<Property Name="Suit" Type="Edm.String" Nullable="false">
<Property Name="Shoes" Type="Edm.String" Nullable="true">
...
</ComplexType>
<Association Name="FK_Orders_Customers">
<End Role="Customers" Type="NorthwindModel.Customer" Multiplicity="0..1"/>
<End Role="Orders" Type="NorthwindModel.Order" Multiplicity="*"/>
<ReferentialConstraint>
...
</ReferentialConstraint>
</Association>
...
</Schema>
<Schema Namespace="ODataWeb.Northwind.Model">
<EntityContainer Name="NorthwindEntities" p7:LazyLoadingEnabled="true" m:IsDefaultEntityContainer="true">
...
<EntitySet Name="Customers" EntityType="NorthwindModel.Customer"/>
<EntitySet Name="Employees" EntityType="NorthwindModel.Employee"/>
<EntitySet Name="Order_Details" EntityType="NorthwindModel.Order_Detail"/>
<EntitySet Name="Orders" EntityType="NorthwindModel.Order"/>
<EntitySet Name="Products" EntityType="NorthwindModel.Product"/>
...
<AssociationSet Name="FK_Orders_Customers" Association="NorthwindModel.FK_Orders_Customers">
<End Role="Customers" EntitySet="Customers"/>
<End Role="Orders" EntitySet="Orders"/>
</AssociationSet>
<AssociationSet Name="FK_Employees_Employees" Association="NorthwindModel.FK_Employees_Employees">
<End Role="Employees" EntitySet="Employees"/>
<End Role="Employees1" EntitySet="Employees"/>
</AssociationSet>
...
</EntityContainer>
</Schema>
79
2013-09-19
Informations de référence sur le pilote d'accès aux données
6.3.4 Pilote OData : Mappage des espaces de noms, des propriétaires et des
qualificateurs
L'attribut Namespace du schéma est mappé à l'espace de nom du modèle.
L'EntityContainer est mappé au qualificateur de base de données. Le qualificateur par défaut est
l'EntityContainer avec l'attribut m:IsDefaultEntityContainer défini sur true.
Les éléments EntityContainer sont les enfants des éléments Schema. Comme différents éléments
Schema peuvent contenir le même EntityContainer, la valeur du qualificateur de base de données est
<Espace de nom_Schema>.<Nom_EntityContainer>.
La version actuelle du pilote expose un seul propriétaire, nommé entities.
Exemple :
L'espace de nom du service Northwind est ODataWeb.Northwind.Model.
Le qualificateur de base de données du service Northwind est ODataWeb.Northwind.Model.Nor
thwindEntities.
Le propriétaire de base de données du service Northwind est entities.
6.3.5 Pilote OData : Mappage des tables
Le pilote d'accès aux données fournit les flux OData sous forme de tables dans l'outil de conception
d'information.
Un EntitySet est mappé à une table. L'attribut Name de l'EntitySet est mappé au nom de la table.
Dans le schéma OData, un AssocationSet associe deux EntitySets. Un AssocationSet est mappé à
une table si la multiplicité des deux EntitySets est *. L'attribut Name de l'AssociationSet est mappé au
nom de la table. Si au moins une des multiplicités des EntityTypes est 1 ou 0..1, l'AssocationSet est
mappé à une clé étrangère.
Exemple : Mappage des EntitySets
Les EntitySets suivants du service Northwind sont mappés aux tables :
•
•
•
80
Customers
Orders
Products
2013-09-19
Informations de référence sur le pilote d'accès aux données
Exemple : Mappage des AssociationSet
Les AssociationSet suivants du service Northwind sont également mappés aux tables :
•
•
CustomerCustomerDemo
EmployeeTerritories
L'AssocationSet CustomerCustomerDemo est mappé à la table CustomerCustomerDemo, car
l'Association CustomerCustomerDemo associe les EntityTypes CustomerDemographic et Custo
mer aux multiplicités *.
<Association Name="CustomerCustomerDemo">
<End Role="CustomerDemographics" Type="NorthwindModel.CustomerDemographic" Multiplicity="*"/>
<End Role="Customers" Type="NorthwindModel.Customer" Multiplicity="*"/>
</Association>
Rubriques associées
• Pilote OData : Mappage des clés
6.3.6 Pilote OData : Mappage des colonnes
Un élément EntitySet est défini en tant qu'élément EntityType. Un élément EntityType est composé
d'une série de propriétés. Une propriété de type primitif est mappée à une colonne de la table qui
représente l'élément EntitySet. L'attribut Name de la propriété est mappé au nom de la colonne.
Une propriété de type complexe est mappée à un ensemble de colonnes de table. Une colonne
correspond à une sous-propriété. Les noms de colonne sont formés par concaténation des noms des
propriétés de types complexe et primitif séparés par une barre oblique (/). Ce mappage s'applique
également aux propriétés imbriquées de type complexe.
Exemple :
La table Orders contient la colonne OrderID, car l'élément EntityType Order possède la propriété
OrderID.
La table Customers contient les colonnes Address, CustomerClothes/Suit et Customer
Clothes/Shoes, car :
•
•
81
La propriété Address de l'élément EntityType Customer est de type primitif.
La propriété CustomerClothes de l'élément EntityType Customer est de type complexe ; il est
composé des propriétés Suit et Shoes de type primitif.
2013-09-19
Informations de référence sur le pilote d'accès aux données
6.3.7 Pilote OData : Mappage des clés
Mappage de clés primaires
La propriété Clé d'un élément EntityType est mappée à la clé primaire de la table qui mappe l'élément
EntitySet correspondant. Il peut s'agir d'une ou de plusieurs colonnes.
Exemple :
La table Customers possède une clé primaire sur la colonne CustomerID, car l'élément EntityType
Customer possède une propriété Key qui fait référence à la propriété CustomerID.
Mappage de clés étrangères
Le protocole OData utilise des NavigationProperties pour exposer les chemins de jointure d'un modèle
relationnel. Les NavigationProperties utilisent des Rôles définis dans des AssociationSets pour lier des
EntitySets selon leur multiplicité.
Le pilote OData représente des jointures bidirectionnelles sous forme de clés étrangères. Une jointure
bidirectionnelle peut être créée entre des tables si les EntityTypes des EntitySets représentant ces
tables contiennent des NavigationProperties qui utilisent le même AssocationSet pour lier des EntitySets.
Cela signifie que les deux extrémités d'un AssociationSet doivent posséder des NavigationProperties
dans les deux EntityTypes. Les associations qui ne remplissent pas cette condition ne sont pas exposées
en tant que clés étrangères.
Si la multiplicité des deux EntitySets est *, l'AssociationSet est mappé à une table. Si au moins une
des multiplicités des EntityTypes est 1 ou 0..1, l'AssociationSet est mappé à une clé étrangère de la
table qui représente l'EntitySet de la multiplicité *. Le modèle d'un nom de clé étrangère est
-idref-<NavigationProperty>-<Clé primaire>.
Rappel :
Les clés étrangères sont des colonnes masquées dans les tables de fondation de données par défaut,
car elles ne contiennent pas de données professionnelles. Vous pouvez cependant les afficher en
modifiant les propriétés de table et de colonne. Voir le Guide de l'utilisateur de l'outil de conception
d'information.
Attention :
SAP recommande aux utilisateurs d'application de ne pas interroger les colonnes -idref, car cela
peut réduire les performances du pilote.
Exemple : Clés étrangères d'un EntitySet
La table Orders possède les clés étrangères -idref-Customer-CustomerID, -idref-EmployeeEmployeeID et -idref-Shipper-ShipperID car :
•
L'EntityType Order possède les NavigationProperties suivantes.
<EntityType Name="Order">
...
82
2013-09-19
Informations de référence sur le pilote d'accès aux données
<NavigationProperty Name="Customer" Relationship="NorthwindModel.FK_Orders_Customers" FromRole="Orders"
ToRole="Customers"/>
<NavigationProperty Name="Employee" Relationship="NorthwindModel.FK_Orders_Employees" FromRole="Orders"
ToRole="Employees"/>
<NavigationProperty Name="Shipper" Relationship="NorthwindModel.FK_Orders_Shippers" FromRole="Orders"
ToRole="Shippers"/>
</EntityType>
•
Ces NavigationProperties font référence aux Associations FK_Orders_, qui lient l'EntityType Order
aux EntityTypes Customer, Employee et Shipper. Il existe une multiplicité 0..1 dans chaque
Association. Cela génère trois clés étrangères dans la table qui représente l'EntitySet Orders.
<Association Name="FK_Orders_Employees">
<End Role="Employees" Type="NorthwindModel.Employee" Multiplicity="0..1"/>
<End Role="Orders" Type="NorthwindModel.Order" Multiplicity="*"/>
</Association>
•
•
•
La colonne CustomerID qui figure dans -idref-Customer-CustomerID provient de la clé
primaire de la table Customers.
La colonne EmployeeID qui figure dans -idref-Employee-EmployeeID provient de la clé
primaire de la table Employees.
La colonne ShipperID qui figure dans -idref-Shipper-ShipperID provient de la clé primaire
de la table Shippers.
Exemple : Clés étrangères d'un AssocationSet
La table CustomerCustomerDemo possède les clés étrangères -idref-CustomerDemographicsCustomerTypeID et -idref-Customers-CustomerID car :
•
L'EntityType Customer possède une PropriétéNavigation CustomerDemographics.
<EntityType Name="Customer">
...
<NavigationProperty Name="CustomerDemographics" Relationship="NorthwindModel.CustomerCustomerDemo"
FromRole="Customers" ToRole="CustomerDemographics"/>
</EntityType>
•
L'EntityType CustomerDemographic possède une PropriétéNavigation Customers.
<EntityType Name="CustomerDemographic">
...
<NavigationProperty Name="Customers" Relationship="NorthwindModel.CustomerCustomerDemo" FromRole="Cus
tomerDemographics" ToRole="Customers"/>
</EntityType>
•
Les NavigationProperties font référence à l'Association CustomerCustomerDemo, qui lie les
EntityTypes Customer et CustomerDemographic. Cela génère deux clés étrangères dans la
table qui représente l'AssocationSet CustomerCustomerDemo.
<Association Name="CustomerCustomerDemo">
<End Role="CustomerDemographics" Type="NorthwindModel.CustomerDemographic" Multiplicity="*"/>
<End Role="Customers" Type="NorthwindModel.Customer" Multiplicity="*"/>
</Association>
•
•
83
La colonne CustomerID qui figure dans -idref-Customers-CustomerID provient de la clé
primaire de la table Customers.
La colonne CustomerTypeID qui figure dans -idref-CustomerDemographics-Customer
TypeID provient de la clé primaire de la table CustomerDemographics.
2013-09-19
Informations de référence sur le pilote d'accès aux données
6.3.8 Pilote OData : Mappage des éléments de documentation
Selon la disponibilité, les sous-éléments de Résumé ou DescriptionLongue de l'élément Documentation
sont mappés aux descriptions des entités du modèle relationnel.
Un sous-élément Documentation des éléments EntitySet et AssocationSet est affiché en tant que
description de table dans l'outil de conception d'information. Un sous-élément Documentation des
éléments Propriété ou PropriétéNavigation est affiché en tant que description de colonne. S'il n'existe
aucun élément Résumé ou DescriptionLongue, le champ Description reste vide.
Les descriptions ne sont pas localisées.
6.3.9 Pilote OData : Mappage des entités de types dérivés
L'exemple suivant illustre un élément EntitySet de type Employé.
<EntitySet Name="Employees" EntityType="Employee" />
Le diagramme suivant présente le concept d'héritage entre un type de base Employé, et deux types
dérivés, EmployéInterne et EmployéInterne. Les types dérivés héritent de toutes les propriétés
du type de base. Ils définissent également des propriétés supplémentaires, appelées propriétés directes.
Pour un élément EntitySet spécifique, le schéma de résultat est obtenu après la fusion d'un type général.
Le diagramme suivant affiche la table Employé telle que représentée dans le modèle relationnel.
84
2013-09-19
Informations de référence sur le pilote d'accès aux données
La table Employé du modèle relationnel contiendra des informations provenant de deux entités,
c'est-à-dire des colonnes du type parent et des types dérivés. Pour éviter tout conflit d'attribution de
nom, les colonnes déclarées dans les types dérivés ont pour préfixe le nom de l'élément EntityType.
Ils peuvent également contenir la valeur nulle.
6.3.10 Surveillance des performances du pilote OData
Il peut s'avérer utile de considérer les comportements suivants du pilote OData pour améliorer les
performances de la connexion lors de l'exécution de la requête.
Exécution des opérations côté client ou fournisseur
Lors de la création d'une connexion, vous pouvez exécuter certaines opérations de la requête SQL au
niveau du pilote ou du fournisseur. Le tableau suivant présente les paramètres de l'Assistant de
connexion qui contrôlent ce comportement.
Si un paramètre est sélectionné, le fournisseur de services OData traite l'opération correspondante s'il
peut la prendre en charge. Il s'agit du comportement par défaut Dans le cas inverse, c'est le pilote
OData qui traite l'opération.
Attention :
SAP recommande de ne pas utiliser le pilote d'accès aux données pour exécuter ces opérations, car
celui-ci risquerait de réduire les performances de connexion. Comme l'intégralité de l'ensemble de
données doit être transférée au client, le temps de réponse s'accroît. Utilisez-le uniquement si le
fournisseur de services OData ne prend pas en charge l'opération ou la prend en charge partiellement
.
85
Paramètre
Opération
Incidence sur les performances
Sélection de colonnes
SELECT
(Sélectionner)
Si le paramètre est désélectionné, le pilote OData traite la projection SQL, ce qui augmente de manière significative le trafic
de données.
2013-09-19
Informations de référence sur le pilote d'accès aux données
Paramètre
Opération
Incidence sur les performances
Vous pouvez exécuter certaines opérations de filtrage au niveau
du pilote si les normes OData ne les prennent pas en charge.
Cependant, les filtres au niveau du fournisseur réduisent généralement la durée d'exécution de la requête.
Conditions de filtres
prises en charge
WHERE
(Où)
Tri
ORDER
BY (Trier
selon)
La couche d'accès aux données applique la logique suivante
pour améliorer les performances : toute condition de filtrage
compatible avec les normes OData est poussée vers le fournisseur OData. Le pilote OData exécute tout autre filtre incompatible que la clause WHERE peut contenir. Reportez-vous à
l'exemple suivant.
Le fournisseur OData exécute l'opération ORDER BY si aucune
expression DISTINCT ou GROUP BY n'est utilisée dans la requête. Si une requête contient une expression DISTINCT ou
GROUP BY, le pilote doit exécuter l'opération de tri, ce qui accroît la durée d'exécution.
Remarque :
•
•
•
L'opération ORDER BY dépend du paramètre SBO Bucket Split Size lorsqu'elle est exécutée
par le pilote.
L'opérateur BETWEEN est mappé aux fonctions de comparaison OData, puis exécuté par le
fournisseur OData.
Les opérateurs LIKE et NOT LIKE sont généralement exécutés sur le client. Ils sont cependant
convertis en fonctions OData startsWith et endsWith, si un seul modèle % est respectivement
placé à la fin ou au début de la valeur de filtre.
Exemple : Prise en charge des expressions de filtre
La requête suivante contient deux conditions de filtre dans la clause WHERE :
SELECT * FROM T1 WHERE col1='San Francisco' AND col2 LIKE 'S%n'
Le fournisseur OData peut traiter la première partie de la clause, mais pas la seconde. Le pilote OData
exécute ensuite col2 LIKE 'S%n', tandis que le fournisseur exécute col1='San Francisco'.
Exemple : Mappage des fonctions startsWith et endsWith
La requête SQL suivante renvoie les employés Sales qui habitent sur des boulevards.
SELECT * FROM EMPLOYEES WHERE EMPLOYEES."Title" LIKE 'Sales %' AND EMPLOYEES."Address" LIKE '% Blvd.'
Elle correspond à l'URL suivante :
http://services.odata.org/Northwind/Northwind.svc/Employees?$filter=startswith(Title,'Sales')&endswith(Ad
dress,'Blvd.')
86
2013-09-19
Informations de référence sur le pilote d'accès aux données
Exécution des fonctions d'agrégation
La fonction de base de données COUNT est la seule fonction d'agrégation prise en charge par le protocole
OData 2.0. Les autres fonctions de regroupement et d'agrégation déclenchées par la clause GROUP
BY sont exécutées sur le client. Cependant, si le pilote effectue des calculs qui modifient le résultat
avant que le total ne soit calculé, la fonction COUNT doit également être exécutée sur le client. Cela
peut réduire les performances de la connexion.
Définition du paramètre d'expiration de la connexion
Vous pouvez choisir la valeur du paramètre Expiration de la connexion dans l'Assistant de connexion
afin d'ajuster les performance du pilote. Cela spécifie la durée, exprimée en secondes, durant laquelle
une connexion reste active en cas d'absence de réponse de la source de données.
Vous devez choisir la meilleure valeur de paramètre pour obtenir les meilleures performances. Par
exemple, si vous vous connectez à une source de données dont le délai de réponse est élevé, vous
choisirez une valeur élevée d'Expiration de la connexion pour attendre la réponse du serveur et éviter
qu'une erreur soit détectée de façon précoce. Si votre source de données est habituellement rapide,
vous choisirez une valeur réduite afin de ne pas attendre trop longtemps qu'une erreur soit détectée
si le serveur ne répond pas.
Utilisation du métamodèle du cache
Le paramètre Métamodèle du cache est sélectionné par défaut dans l'Assistant de connexion. Cela
vous permet d'extraire le modèle de métadonnées une seule fois pendant la durée de la connexion
dans le pool de connexions, et non pas lors de l'exécution de chaque requête. Cela permet d'améliorer
les performances de la connexion.
Remarque :
Vous devez activer la mise en pool des connexions si le modèle de métadonnées est mis en cache.
Rubriques associées
• Fonctionnalités du pilote OData
6.3.11 Pilote OData : Restrictions et comportements non triviaux
Tri des algorithmes
L'opération de tri des algorithmes peut différer d'un fournisseur de services à l'autre. Cela peut mener
à des résultats différents lorsque l'opération ORDER BY est utilisée dans la requête.
Comme le pilote OData peut exécuter des opérations de tri à l'aide de son propre algorithme, l'utilisation
d'opérations combinées telles qu'ORDER BY, GROUP BY et DISTINCT peut également entraîner des
ordres de tri différents.
Mappage du paramètre Max Rows (Nombre maximal de lignes)
La fonction OData $top est mappée au paramètre Max Rows (Nombre maximal de lignes) de l'Editeur
de requête, uniquement si les opérations de requêtes ne modifient pas le nombre de lignes. Les résultats
87
2013-09-19
Informations de référence sur le pilote d'accès aux données
de la requête peuvent être erronés si un filtre est appliqué, ce qui supprime certaines lignes du résultat
$top attendu.
Exemple :
La requête OData suivante renvoie les 15 premières lignes de la table Orders :
http://services.odata.org/Northwind/Northwind.svc/Orders?$top=15
La requête suivante renvoie les 15 premières lignes pour lesquelles la ville d'expédition est "Reims".
Cette opération ne renvoie que 5 lignes :
http://services.odata.org/Northwind/Northwind.svc/Orders?$top=15&$filter=ShipCity eq 'Reims'
Restrictions relatives à la fonction COUNT
Un nombre de lignes figurant dans une table de l'outil de conception d'information compte de manière
sémantique les lignes contenant des valeurs non nulles pour les colonnes définies : Certains services
Azure renvoient uniquement le nombre total de lignes d'une table. Cela peut entraîner une certaine
divergence entre les résultats de requête attendus et ceux obtenus.
Restrictions relatives aux services SAP NetWeaver Gateway
Si le fournisseur de services NetWeaver Gateway ne prend pas en charge les filtres de toutes les
colonnes, vous ne devez pas sélectionner l'option Conditions de filtres prises en charge lors de la
création de la connexion. S'il ne prend pas en charge le tri de toutes les colonnes, vous ne devez pas
sélectionner l'option Tri lors de la création de la connexion.
Le schéma peut indiquer ces restrictions de tri et de filtrage à l'aide des métadonnées sap:filterable
et sap:sortable. Dans la version actuelle, le pilote OData ne mappe pas ces attributs.
Il est possible que certains fournisseurs n'offrent pas de fonctionnalité d'analyse de table complète sur
toutes les tables. Cela peut causer des erreurs d'exécution, par exemple si une des tables utilisées
dans une opération JOIN ne peut pas être analysée.
SAP vous recommande de créer des connexions directement au système SAP ERP pour éviter tout
problème avec les requêtes ad hoc.
6.3.12 Pilote OData : Configuration de la taille maximale de la colonne
Pour certaines propriétés, le paramètre MaxLength peut avoir la valeur Max. Par exemple :
<Property Name="Synopsis" Type="Edm.String" Nullable="true" MaxLength="Max" Unicode="true" FixedLe
ngth="false"/>
Comme le pilote OData ne peut pas reconnaître cette valeur non numérique, il doit être configuré. Le
fichier de configuration cs.cfg fournit les paramètres suivants :
•
•
88
Binary Max Length pour définir la taille maximale des colonnes de table de type binaire.
String Max Length pour définir la taille maximale des colonnes de table de type chaîne.
2013-09-19
Informations de référence sur le pilote d'accès aux données
Rubriques associées
• Binary Max Length
• String Max Length
6.3.13 Authentification des sources OData
L'accès à certaines sources de données requiert une authentification. Une application peut s'authentifier
auprès d'une source de données OData à l'aide des méthodes suivantes :
•
•
Authentification basique HTTP, qui utilise un nom d'utilisateur et un mot de passe. Les références
de connexion ne sont pas chiffrées.
Un jeton d'accès GET qui représente une paire {clé, valeur} ajoutée à l'URI du service. La valeur et
la clé du jeton peuvent varier selon le service. Définissez le jeton via des paramètres personnalisés
à l'aide des Paramètres d'authentification personnalisés de l'Assistant de connexion. Utilisez le
modèle suivant : <clé>=<valeur>.
Remarque :
La couche d'accès aux données ne fournit aucune trace pour les paramètres d'authentification
personnalisés, car ils contiennent des informations de sécurité. Ils sont remplacés par <PARA
MS_AUTH_PERSONNALISES> dans les traces du pilote OData. Envisagez cependant l'utilisation d'autres
niveaux de suivi tels que l'option Activer le suivi des travaux dans la CMC pour afficher les paramètres.
Exemple : Jeton d'accès
http://wine.cloudapp.net/Regions?apikey=<valeur de clé d'API>.
Authentification des sources de données Microsoft Azure
Vous vous connectez à un jeu de données Microsoft Azure à l'aide de l'authentification de base HTTP.
Dans l'Assistant de connexion, saisissez la clé de compte en tant que mot de passe. Le mot de passe
peut rester vide.
6.3.14 Suivi des activités du pilote OData
La couche d'accès aux données effectue le suivi du pilote OData avec les niveaux de gravité PATH et
DEBUG. Les traces PATH contiennent les entrées et sorties de chaque méthode utilisée lors de la
planification et l'exécution de la requête. Cela vous permet de déterminer si le pilote OData ou le
fournisseur OData a exécuté l'opération de requête et de localiser la cause du problème.
Les informations contenues dans l'URI (les références de la source de données, les références du
serveur proxy et les paramètres d'authentification personnalisés) sont vidées dans les traces du pilote.
89
2013-09-19
Informations de référence sur le pilote d'accès aux données
6.4 Pilote SAP ERP
La couche d'accès aux données permet à la plateforme de BI de se connecter aux systèmes SAP ERP
via la couche réseau SAP JCo (Java Connector) 3.x. Elle fournit un pilote d'accès aux données afin
d'accéder aux objets ERP suivants :
•
•
•
InfoSets
Requêtes SAP
Fonctions ABAP
Pour en savoir plus sur les systèmes ERP pris en charge, voir la Product Availability Matrix.
Les connectivités SAP ERP prennent en charge la connexion unique sur toutes les plateformes. Pour
en savoir plus sur l'authentification, voir le Guide d'administration de la plateforme SAP BusinessObjects
Business Intelligence.
Les connectivités SAP ERP prennent également en charge les paramètres régionaux de visualisation
préférés (PVL) pour tous les modes d'authentification. Vous désactivez l'utilisation des PVL en cochant
l'option Enregistrer la langue lors de la création de la connexion.
Les fichiers de configuration du pilote se trouvent dans le répertoire rép-install-connectionser
ver\connectionServer\jco. Le fichier jco.prm répertorie les fonctionnalités du pilote d'accès
aux données en termes d'opérations de base de données.
L'Assistant de connexion fournit un workflow pour entrer les informations requises afin de se connecter
aux systèmes SAP ERP.
Rubriques associées
• Prise en charge de la connexion unique
6.4.1 Fonctionnalités du pilote SAP ERP
Le pilote d'accès aux données prend en charge les fonctionnalités de requêtes suivantes :
•
•
•
•
•
•
90
Les opérations de base (SELECT, WHERE, ORDER BY, GROUP BY et AS)
Les opérateurs de base (=, !=, <, <=, >, >=, BETWEEN, NOT BETWEEN, IN, NOT IN, AND, OR)
dont les opérandes peuvent être des noms de colonne ou des valeurs constantes
La clause DISTINCT de l'instruction SELECT
Les valeurs constantes dans l'instruction SELECT
LIKE et NOT LIKE acceptent les caractères d'échappement
Les requêtes imbriquées dans la clause FROM
2013-09-19
Informations de référence sur le pilote d'accès aux données
La couche d'accès aux données effectue les opérations de tri de manière interne.
Remarque :
Le pilote d'accès aux données ne permet pas de trier les colonnes par index dans les instructions SQL.
Seule l'instruction ORDER BY suivie de noms de colonne est une clause valide. Le paramètre OR
DER_BY_SUPPORTS_COLUMN_INDEX est défini sur NO dans le fichier jco.prm.
Rubriques associées
• Disque local utilisé en tant que cache pour les opérations de tri
Le pilote d'accès aux données CSV OpenDriver et les pilotes OData, SAP ERP, XML et
de services Web peuvent utiliser le disque local en tant que cache pour les lignes triées.
• ORDER_BY_SUPPORTS_COLUMN_INDEX
6.4.2 Pilote SAP ERP : Accès aux requêtes SAP et InfoSets
A propos des InfoSets et des requêtes SAP
Dans le système SAP ERP, les InfoSets et les requêtes SAP sont organisés dans une zone de travail
locale ou globale. Les objets de la zone de travail locale sont uniquement accessibles par le client SAP
ERP utilisé, ceux de la zone de travail globale le sont par tous les clients. Une requête SAP est créée
dans un groupe d'utilisateurs et lui appartient.
Pour en savoir plus sur les zones de travail et les groupes d'utilisateurs, reportez-vous à la documentation
SAP ERP.
Mappage d'objets
Le pilote d'accès aux données fournit les InfoSets et les requêtes SAP à l'outil de conception d'information
sous forme de tables. Les InfoSets et les requêtes SAP sont constitués d'une série de champs, qui
sont mappés à des colonnes de table. Les champs sont utilisés dans les instructions SELECT.
Au niveau du pilote, les zones de travail sont mappées aux qualificateurs. Le qualificateur par défaut
correspond à la zone de travail locale.
Les groupes d'utilisateurs sont mappés aux propriétaires. Les groupes d'utilisateurs d'une zone de
travail sont ensuite placés sous un qualificateur qui représente celle-ci.
Les InfoSets d'une zone de travail sont placés sous un qualificateur qui la représente et sous un
propriétaire fictif nommé INFOSET. Les requêtes SAP d'une zone de travail sont placées sous un
qualificateur qui représente celle-ci. Les requêtes SAP d'un groupe d'utilisateurs sont placées sous le
propriétaire qui représente ce groupe d'utilisateurs.
L'organisation des InfoSets et des requêtes SAP dans une zone de travail est illustrée ci-dessous :
91
2013-09-19
Informations de référence sur le pilote d'accès aux données
Les champs sont mappés à des colonnes de table. Un InfoSet ou une requête SAP contient des champs
qui servent à la fois à la projection et à la sélection. Ils contiennent également des champs de sélection
non utilisés pour la projection. Lorsque vous créez une connexion avec l'Assistant de connexion, vous
déterminez si ces champs de sélection sont représentés en tant que colonnes de table. Le paramètre
Mapper des champs de sélection dans les colonnes de table assure cette fonctionnalité. S'il est
sélectionné, le champ est mappé en tant que colonne d'entrée facultative. Sinon, le champ de sélection
est ignoré et aucun filtrage n'est possible sur celui-ci.
Remarque :
Il n'existe aucun mappage spécifique pour les champs de sélection obligatoires. L'utilisateur de
l'application doit effectuer des requêtes sur ces champs avec des filtres.
Colonnes d'entrée
Les colonnes d'entrée d'une table sont des colonnes pour lesquelles une condition d'égalité (opérateur
=) doit être donnée lorsque l'utilisateur de l'application effectue des requêtes sur la table. Seules les
conditions d'égalité sont autorisées pour les colonnes d'entrée. Les conditions IN sont interdites.
Dans l'outil de conception d'information, l'utilisateur peut visualiser les colonnes d'entrée comme
obligatoires ou facultatives. Une colonne d'entrée obligatoire est une colonne pour laquelle il est
obligatoire de définir une valeur. Une colonne d'entrée facultative est une colonne pour laquelle il n'est
pas obligatoire de définir une valeur.
Si l'utilisateur ne définit pas de valeur pour une colonne d'entrée facultative dans une requête, le serveur
de connexion renvoie soit :
•
•
92
aucune valeur si la colonne d'entrée facultative ne comporte pas de valeur par défaut ;
la valeur par défaut si la colonne d'entrée facultative en comporte une.
2013-09-19
Informations de référence sur le pilote d'accès aux données
Capacités du pilote
Lorsque l'utilisateur de l'application interroge un InfoSet, certaines opérations de base de données sont
transmises au système SAP ERP (SELECT, WHERE, tri uniquement avec les colonnes ORDER BY,
AS) alors que les autres sont gérées en interne par le pilote (autre filtrage avec WHERE, GROUP BY,
DISTINCT et tri uniquement avec les fonctions agrégées ORDER BY).
Lorsque l'utilisateur de l'application interroge une requête SAP, certaines opérations sont également
transmises au système ERP. Ce sont SELECT, WHERE, ORDER BY (uniquement si la requête SAP
contient déjà le même tri) et AS.
Pour en savoir plus sur les opérations gérées directement par le système, voir la documentation de
votre système SAP ERP.
6.4.3 Pilote SAP ERP : Accès aux fonctions ABAP
Rappel :
Le pilote SAP ERP permet de créer des connexions vers les fonctions ABAP validées et non validées.
Concepts des fonctions ABAP
Les fonctions ABAP sont constituées d'une série de paramètres pouvant être des paramètres d'entrée
utilisés dans les appels de fonction ou bien des paramètres de sortie contenus dans les réponses aux
appels. Dans la terminologie SAP, les paramètres d'entrée s'appellent paramètres d'importation et les
paramètres de sortie sont les paramètres d'exportation. Certains paramètres peuvent être à la fois
d'entrée et de sortie. Ils sont appelés paramètres modifiables. Outre les paramètres d'importation,
d'exportation et modifiables, il existe également des paramètres de table qui peuvent être considérés
comme un type de paramètres modifiables.
Un paramètre de fonction ABAP peut appartenir aux types suivants :
•
•
•
Champ de type primitif ABAP
Structure, qui est une suite de plusieurs champs
Table, qui peut être constituée de champs, de structures ou même de tables
Mappage d'objets
Le pilote d'accès aux données fournit les fonctions ABAP sous forme de tables à l'outil de conception
d'information. Au niveau du pilote, les groupes de fonctions ABAP sont mappés aux propriétaires et
les fonctions ABAP sont mappées à un qualificateur nommé ABAPFunction. Cela signifie que chaque
fonction ABAP est placée sous un propriétaire spécifique, qui correspond à un groupe de fonctions
dans le système SAP ERP.
Les paramètres d'importation, modifiables et de table utilisés comme entrée sont mappés aux colonnes
d'entrée. Les paramètres d'exportation, modifiables et de table utilisés comme sortie sont mappés dans
des tables. Les colonnes d'entrée peuvent être obligatoires ou facultatives. La couche d'accès aux
données considère ces paramètres comme attributs de clé primaire ne pouvant pas être nuls.
Le pilote mappe les paramètres de fonction ABAP de la manière suivante :
93
2013-09-19
Informations de référence sur le pilote d'accès aux données
•
•
•
Un paramètre obligatoire est mappé à une colonne d'entrée obligatoire. L'utilisateur doit définir une
valeur pour cette colonne.
Un paramètre facultatif comportant une valeur par défaut est mappé à une colonne d'entrée
facultative. L'utilisateur n'a pas à définir de valeur pour cette colonne. Dans ce cas, la valeur renvoyée
au serveur de connexion par la source de données est la valeur par défaut.
Un paramètre facultatif sans valeur par défaut est également mappé à une colonne d'entrée
facultative. Le serveur de connexion renvoie les valeurs suivantes de type de données de chaîne,
selon le type SQL de la colonne d'entrée :
Type SQL
Valeur
SQL_INTEGER
0
SQL_Char, SQL_VarChar, SQL_Binary
Chaîne vide.
SQL_Double, SQL_Float, SQL_Numeric
0.0
SQL_Date
00010101
SQL_Time
000000
Un autre type
Chaîne vide.
Remarque :
Le pilote ajoute une colonne <nom de colonne>-ID à la table dans laquelle la fonction ABAP est
mappée et une autre colonne <nom_de_colonne>-IDREF à la table si elle contient une référence à
une autre table.
Renommage de colonne
Les noms de colonne sont modifiés au niveau du pilote. Le tableau suivant présente les préfixes ajoutés
aux colonnes.
94
2013-09-19
Informations de référence sur le pilote d'accès aux données
Entrée ou sortie
Paramètre
Préfixe
Entrée
Importation
-IMPORT_
Entrée
Modifiable
-IMPORT_CH_
Entrée
Table
-IMPORT_CH_
Sortie
Modifiable
-EXPORT_CH_
Sortie
Table
-EXPORT_CH_
Remarque :
Lorsqu'un paramètre de table de sortie (A) est constitué d'une autre table (B), les deux tables sont
renommées respectivement -EXPORT_CH_A et -EXPORT_CH_A.B.
Capacités du pilote
Toutes les opérations de base de données (SELECT, WHERE, ORDER BY, GROUP BY, AS, etc.)
sont gérées en interne par le pilote, alors que les conditions d'égalité sur les colonnes d'entrée sont
transmises au système SAP ERP.
Rappel :
Le pilote accepte uniquement les tables comportant une seule ligne comme paramètres d'entrée. Elles
sont équivalentes aux structures d'entrée.
•
Lors de la création d'une connexion dans l'Assistant de connexion, l'utilisateur détermine si un
paramètre modifiable de type table ou un paramètre de table est considéré à la fois comme étant
d'entrée et de sortie. Le paramètre Mapper les paramètres de table dans les colonnes d'entrée
comporte cette fonctionnalité. S'il est coché, le paramètre est à la fois d'entrée et de sortie. Dans
ce cas, il ne peut y avoir qu'une structure en tant qu'entrée. S'il n'est pas coché, le paramètre est
considéré uniquement comme paramètre de sortie.
•
Le pilote considère les champs d'une structure d'entrée facultative comme des colonnes d'entrée
facultatives. Les colonnes d'entrée sont considérées comme facultatives dans leur globalité,
c'est-à-dire que, si une colonne comporte une valeur, les autres doivent également en comporter
une. L'utilisateur de l'application doit vérifier que toutes les colonnes comportent une valeur.
•
Certains paramètres de fonction ABAP peuvent comporter des valeurs dont la taille est indiquée
comme étant égale à zéro par le système SAP ERP. Le pilote utilise le paramètre String Max
Length du fichier cs.cfg pour définir une longueur maximale de chaîne pour les colonnes de table
mappées à ces paramètres.
Rubriques associées
• String Max Length
95
2013-09-19
Informations de référence sur le pilote d'accès aux données
6.4.4 Restrictions relatives au pilote SAP ERP
•
•
Il est impossible d'interroger des objets ERP basés sur des programmes ABAP nécessitant un
traitement SAPGUI, car ils sont inaccessibles via les appels de fonctions à distance.
L'API JCo ne prend pas en charge la fonction Array Fetch C'est-à-dire que les données de résultat
sont renvoyées en une seule fois. Pour limiter le nombre de lignes de résultat et éviter un problème
de capacité de mémoire, l'utilisateur de l'application doit filtrer les données de manière appropriée.
Indépendamment de cette restriction, le serveur de connexion applique toujours la fonction Array
Fetch.
Remarque :
L'utilisateur d'application peut également définir une valeur sur Max Rows dans l'Editeur de requête.
Cependant, le système SAP ERP ne prend pas en compte le paramètre Max Rows si l'univers défini
a plusieurs sources ou si la requête requiert des calculs après extraction des données (SELECT
DISTINCT, ORDER BY et GROUP BY).
•
Le paramètre ERP Max Rows du fichier de configuration jco.sbo permet à l'utilisateur de
l'application d'interroger sans filtre un InfoSet ou une table de requête SAP qui ne contient que des
colonnes de type de données numérique. L'utilisateur peut également interroger une table contenant
des colonnes de types de données numériques et DATS. Ce paramètre est également utilisé lorsque
Max Rows n'est pas transmis au système SAP ERP. ERP Max Rows peut être utilisé avec les
univers à source unique ou à plusieurs sources. Définissez ERP Max Rows sur une valeur appropriée
pour éviter les problèmes de capacité mémoire.
Remarque :
Dans le cas d'un univers à plusieurs sources, vous pouvez également définir une valeur pour le
paramètre Max Rows dans l'Editeur de requête de l'outil d'administration Data Federation. Pour en
savoir plus, voir le Guide de l'outil d'administration de Data Federator.
Rubriques associées
• Taille de l'Array fetch
• ERP Max Rows
6.5 Pilote XML
La couche d'accès aux données permet à la plateforme de BI de se connecter aux documents XML en
tant que sources de données.
Les documents XML sont basés sur des schémas XML. Un schéma XML est un document XML qui
définit les métadonnées d'une source de données XML.
96
2013-09-19
Informations de référence sur le pilote d'accès aux données
L'Assistant de connexion fournit un workflow pour entrer les informations requises afin de se connecter
aux sources de données XML. Les sources de données XML se trouvent sous le SGBD XML Files
et la couche réseau XML File Connector.
Les fichiers de configuration du pilote se trouvent dans le répertoire rép-install-serveurdecon
nexion\connectionServer\xml. Le fichier xml.prm répertorie les fonctionnalités du pilote d'accès
aux données en termes de fonctions et d'opérations de base de données.
6.5.1 Fonctionnalités du pilote XML
Les pilotes d'accès aux données prennent en charge les fonctionnalités de requêtes suivantes :
•
•
•
•
Opérations de base de données basiques (SELECT, WHERE, ORDER BY, GROUP BY, DISTINCT)
Alias de colonne dans la clause ORDER BY (AS)
Les requêtes imbriquées dans la clause FROM
Opérateurs de filtrage ( =, !=, <, <=, >, >=, AND, OR, BETWEEN, NOT BETWEEN, IN, NOT IN,
LIKE, NOT LIKE, IS NULL, IS NOT NULL)
Le pilote d'accès aux données ne prend pas en charge les opérations JOIN.
Le pilote d'accès aux données prend en charge les fonctions de regroupement MIN, MAX, AVG, SUM et
COUNT dans les instructions SELECT.
Rubriques associées
• Disque local utilisé en tant que cache pour les opérations de tri
Le pilote d'accès aux données CSV OpenDriver et les pilotes OData, SAP ERP, XML et
de services Web peuvent utiliser le disque local en tant que cache pour les lignes triées.
6.5.2 Emplacement du fichier XML
Les documents XML utilisés comme sources de données peuvent être des documents locaux ou
distants. Pour les fichiers de systèmes distants, les protocoles HTTP, FTP et SMB sont pris en charge.
La version actuelle prend également en charge les protocoles chiffrés HTTPS et FTPS basés sur un
certificat.
Remarque :
SMB désigne le protocole de partage de fichiers standard sous MS Windows. Etant donné que la
bibliothèque jCIFS fournit un accès au protocole, vous devez installer le fichier JAR jCIFS dans le
répertoire du serveur de connexion, à savoir rép-install-serveurdeconnexion\connection
Server\sharedLibraries\jcifs. Vous devez installer la version 1.3.15, disponible à l'adresse
suivante : http://jcifs.samba.org/.
97
2013-09-19
Informations de référence sur le pilote d'accès aux données
Vous pouvez déterminer si la source de données est locale ou distante via le paramètre Type
d'emplacement de l'Assistant de connexion. Si la source de données est distante, vous pouvez
également définir le protocole utilisé via le paramètre Protocole de l'Assistant. La valeur du paramètre
Protocole doit correspondre au protocole spécifié dans les valeurs de paramètre Chemin d'accès ou
modèle.
Exemple : Chemin d'accès du fichier XML
•
•
•
•
C:\xml\report.xml ou file:///C:/xml/report.xml pour un fichier local
http://server:8080/path/report.xml pour un fichier accessible via HTTP
ftp://server/path/ pour des fichiers accessibles via FTP
smb://server:port/myshare/mydirectory pour des fichiers accessibles via SMB
Rubriques associées
• Emplacement du fichier CSV
6.5.3 Exemple de document et de schéma XML
Les exemples suivants illustrent la structure d'un document XML nommé clubdemo.xml et basé sur
le schéma clubdemo.xsd.
Exemple : Document clubdemo.xml
<?xml version="1.0" encoding="UTF-8"?>
<ClubDemo xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="clubdemo.xsd">
<Countries>
<Country name="France"/>
<Country name="US"/>
</Countries>
<Customers>
<Customer ID="204">
<Name type="first">Christine</Name>
<Name type="last">Martin</Name>
<Age>25</Age>
<Address>12, allee Victor Hugo</Address>
<ZIP>75016</ZIP>
<City>Paris</City>
<Country name="France"/>
<Invoice>1234</Invoice>
</Customer>
<Customer ID="103">
<Name type="first">Peter</Name>
<Name type="last">Travis</Name>
<Age>34</Age>
<Address>7835 Hartford Drive</Address>
<ZIP>06108</ZIP>
<City>Springfield</City>
<Country name="US"/>
<Invoice>23204</Invoice>
</Customer>
<Customer ID="106">
<Name type="first">William</Name>
<Name type="last">Baker</Name>
98
2013-09-19
Informations de référence sur le pilote d'accès aux données
<Age>64</Age>
<Address>2890 Grant Avenue</Address>
<ZIP>20020</ZIP>
<City>Washington DC</City>
<Country name="US"/>
<Invoice>35306</Invoice>
<Invoice>44106</Invoice>
</Customer>
</Customers>
</ClubDemo>
Exemple : Schéma clubdemo.xsd
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="ClubDemo">
<xs:complexType>
<xs:sequence>
<xs:element ref="Countries"/>
<xs:element ref="Customers"/>
</xs:sequence>
</xs:complexType>
<xs:key name="countkey">
<xs:selector xpath="Countries/Country"/>
<xs:field xpath="@name"/>
</xs:key>
<xs:key name="custkey">
<xs:selector xpath="Customers/Customer"/>
<xs:field xpath="@ID"/>
</xs:key>
<xs:keyref name="custkeyref" refer="countkey">
<xs:selector xpath="Customers/Customer"/>
<xs:field xpath="Country/@name"/>
</xs:keyref>
</xs:element>
<xs:element name="Countries">
<xs:complexType>
<xs:sequence>
<xs:element ref="Country" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="Country">
<xs:complexType>
<xs:attribute name="name" type="xs:string"/>
</xs:complexType>
</xs:element>
<xs:element name="Customers">
<xs:complexType>
<xs:sequence>
<xs:element ref="Customer" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="Customer">
<xs:complexType>
<xs:sequence>
<xs:element name="Name" maxOccurs="2">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="type" type="xs:string"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="Age" type="xs:integer"/>
<xs:element name="Address" type="xs:string"/>
<xs:element name="ZIP" type="xs:string"/>
<xs:element name="City" type="xs:string"/>
99
2013-09-19
Informations de référence sur le pilote d'accès aux données
<xs:element name="Country">
<xs:complexType>
<xs:attribute name="name" type="xs:string"/>
</xs:complexType>
</xs:element>
<xs:element name="Invoice" type="xs:integer" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="ID" type="xs:integer"/>
</xs:complexType>
</xs:element>
</xs:schema>
6.5.4 Pilote XML : Mappage de plusieurs fichiers
Vous pouvez vous connecter à plusieurs fichiers si le paramètre Chemin d'accès ou modèle de
l'Assistant de connexion est défini sur un modèle, par exemple clubdemo_*.xml, auquel répondent
des fichiers tels que clubdemo_1.xml et clubdemo_2.xml.
Rappel :
Vous ne pouvez pas vous connecter à plusieurs fichiers situés sur un serveur HTTP Le protocole HTTP
ne prend pas en charge l'utilisation des éléments génériques dans les modèles.
Si le paramètre Fusionner les fichiers est sélectionné dans l'Assistant de connexion, des tables
identiques provenant de plusieurs fichiers XML sont fusionnées en une seule table. Le nom du
qualificateur de table est le chemin d'accès complet du modèle. Exemple : C:\files\xml\clubde
mo_*.xml. On présume que tous les fichiers ont le même schéma.
Si le paramètre n'est pas sélectionné, les tables ne sont pas fusionnées car elles n'appartiennent pas
au même qualificateur. Chaque document XML est alors mappé à un qualificateur de base de données.
Le nom du qualificateur est le chemin d'accès complet du modèle. Exemple : C:\files\xml\club
demo_1.xml. Dans ce cas, chaque fichier XML peut posséder son propre schéma.
Aucune donnée n'est mappée aux propriétaires de base de données.
6.5.5 Pilote XML : Mappage des tables
Le pilote d'accès aux données fournit les fichiers XML sous forme de tables dans l'outil de conception
d'information.
La racine du document XML est mappée à une table.
Les éléments possédant une valeur maxOccurs supérieure à 1 sont mappés à des tables.
Le nom de la table mappée à un élément est la concaténation des noms d'élément entre la racine et
l'élément, séparés par une barre oblique /).
100
2013-09-19
Informations de référence sur le pilote d'accès aux données
Exemple :
Le document clubdemo.xml est mappé aux tables suivantes :
•
•
•
•
•
ClubDemo
ClubDemo/Countries/Country
ClubDemo/Customers/Customer
ClubDemo/Customers/Customer/Invoice
ClubDemo/Customers/Customer/Name
Rubriques associées
• Exemple de document et de schéma XML
6.5.6 Pilote XML : Mappage des colonnes
Les objets suivants situés sous un élément XML sont mappés aux colonnes de la table qui représente
cet élément :
•
•
•
•
Attributs
Les éléments associés à simpleType ou complexType avec un élément simpleContent
Les textes inclus dans un élément mixte, c'est-à-dire dont le type définit mixed=true
any et anyAttribute
Si la colonne représente un attribut, son nom sera composé des éléments suivants : les noms de tous
les éléments commençant par l'élément d'une valeur maxOccurs supérieure à 1 (non compris) jusqu'à
et y compris l'élément hébergeant cet attribut. Le nom de l'attribut possède le préfixe @, pour éviter tout
conflit de nom avec d'autres éléments.
Si la colonne représente un élément, son nom sera la concaténation des noms de tous les éléments
commençant par l'élément d'une valeur maxOccurs supérieure à 1 (non compris).
Si la colonne représente le même élément que sa table, son nom est celui de l'élément.
Le séparateur utilisé dans les concaténations est la barre oblique /).
Les noms d'éléments ont pour préfixe un tiret (-) lorsqu'ils représentent des éléments parent utilisés
dans des chemins d'accès pour créer des clés étrangères.
Les exemples de mappage suivants font référence au sujet de l'exemple de schéma et document XML.
Exemple :
La table ClubDemo contient la colonne suivante :
•
101
-id
2013-09-19
Informations de référence sur le pilote d'accès aux données
Exemple :
La table ClubDemo/Countries/Country possède les colonnes suivantes :
•
•
@name
-Countries/-ClubDemo/-id
Exemple :
La table ClubDemo/Customers/Customer possède les colonnes suivantes :
•
•
•
•
•
•
•
Age
Adresse
ZIP
Ville
Country/@name
@ID
-Customers/-ClubDemo/-id
Exemple :
La table ClubDemo/Customers/Customer/Invoice possède les colonnes suivantes :
•
•
•
-id
Invoice
-Customers/@ID
Exemple :
La table ClubDemo/Customers/Customer/Name possède les colonnes suivantes :
•
•
•
•
-id
Name
@type
-Customer/@ID
Dans le schéma XML, name, type et ID sont respectivement les noms d'attribut des éléments Country,
Name et Customer. Les colonnes Invoice et Name représentent respectivement les éléments Invoice
et Name. Pour en savoir plus sur la signification des noms de colonne, voir la rubrique relative au
mappage des clés primaires et étrangères.
Rubriques associées
• Exemple de document et de schéma XML
• Pilote XML : Mappage des clés primaires et étrangères
• Pilote XML : Mappage des éléments anyType et simpleType
102
2013-09-19
Informations de référence sur le pilote d'accès aux données
6.5.7 Pilote XML : Mappage des clés primaires et étrangères
Clés primaires
Les règles suivantes s'appliquent au mappage des clés primaires :
•
•
Le pilote génère la clé primaire de la table qui mappe l'élément racine du document. La colonne
associée se nomme -id et sa valeur est le nom du document.
Un attribut ou un élément de type "xs:ID" est mappé à une colonne qui représente une clé primaire.
Si le schéma XML définit une clé avec <xs:key>, les règles suivantes s'appliquent :
•
•
Si la clé est définie au niveau racine et si le sélecteur contient un élément possédant une valeur
maxOccurs supérieure à 1, la clé est mappée à la clé primaire de la table correspondante.
Si la clé n'est pas définie au niveau racine, la clé primaire de la table représente une combinaison
de la clé primaire de l'élément parent et du champ de la clé.
Si le schéma ne définit aucune clé primaire pour un élément de sélecteur possédant une valeur
maxOccurs supérieure à 1, une colonne nommée -id est ajoutée à la table en tant que clé primaire.
Exemple : Elément racine du document
L'élément ClubDemo est la racine du document clubdemo.xml. La colonne -id est créée et définie
en tant que clé primaire de la table ClubDemo. La valeur de la colonne -id est clubdemo.xml.
Exemple : Clé explicite
L'ensemble de clés suivant défini au niveau racine spécifie la colonne @name de la table ClubDe
mo/Countries/Country en tant que clé primaire :
<xs:key name="countkey">
<xs:selector xpath="Countries/Country"/>
<xs:field xpath="@name"/>
</xs:key>
La table ClubDemo/Customers/Customer a la colonne @ID comme clé primaire, car le schéma
définit la clé explicite custkey :
<xs:key name="custkey">
<xs:selector xpath="Customers/Customer"/>
<xs:field xpath="@ID"/>
</xs:key>
Exemple : Aucune clé explicite
La table ClubDemo/Customers/Customer/Invoice a une colonne -id comme clé primaire, car
le schéma ne définit aucune clé pour cet élément.
103
2013-09-19
Informations de référence sur le pilote d'accès aux données
Clés étrangères
Si le schéma XML définit une référence de clé avec <xs:keyref>, et si celle-ci est définie au même
niveau que la clé référencée, alors la référence de clé est mappée à une clé étrangère de la table
correspondante.
Pour chaque table qui correspond à un élément non racine, la clé étrangère est conçue à partir des
colonnes de clé primaire de sa table parent et du chemin d'accès inverse (de l'élément vers ses parents).
Cela permet d'effectuer le mappage des relations entre les éléments parent et enfant.
Restriction :
Bien que les fondations de données présentent des clés étrangères, le pilote XML ne prend pas en
charge les opérations JOIN.
Exemple : Keyref
La table ClubDemo/Customers/Customer possède les clés étrangères suivantes :
•
Country/@name, qui est le champ de la keyref suivante :
<xs:keyref name="custkeyref" refer="countkey">
<xs:selector xpath="Customers/Customer"/>
<xs:field xpath="Country/@name"/>
</xs:keyref>
•
Notez que countkey est la clé explicite définie pour une table qui n'est pas une table parent.
-Customers/-ClubDemo/-id, qui est créée depuis le chemin d'accès inverse vers sa table
parent et la clé primaire de la table parent.
Exemple : Aucune keyref
La table ClubDemo/Customers/Customer/Invoice a une colonne -Customer/@ID définie
comme clé étrangère, qui est créée à partir de la colonne de clé primaire de la table parent et le
chemin d'accès inverse à sa table parent.
Rubriques associées
• Exemple de document et de schéma XML
• Pilote XML : Mappage des colonnes
6.5.8 Pilote XML : Mappage des éléments mixtes
L'ensemble du contenu d'un élément mixte est mappé à une colonne de table. Cela inclut ses enfants
et toutes les données entre les enfants.
Les attributs d'un élément mixte sont mappés aux colonnes, quelle que soit la méthode de mappage
de l'élément.
104
2013-09-19
Informations de référence sur le pilote d'accès aux données
Exemple :
Dans cet exemple, l'élément documentation possède un complexType composé de trois éléments
enfant :(name, datatype et location).
<documentation>
The <name>XML driver</name> allows you to retrieve <datatype>XML</datatype> data
from documents located on a <location>remote server</location>.
</documentation>
La couche d'accès aux données mappe ces éléments comme suit :
•
•
L'élément documentation est mappé à une colonne de table.
Le contenu de l'élément documentation se transforme en données de colonne, y compris ses
enfants et toutes les données entre ces derniers. Dans cet exemple, la colonne contient la ligne
suivante :
The <name>XML driver</name> allows you to retrieve <datatype>XML</datatype> data from documents located
on a <location>remote server</location>.
6.5.9 Pilote XML : Mappage des éléments récursifs
Le schéma suivant définit des éléments récursifs :
<xs:element name="parent">
<xs:complexType>
<xs:sequence>
<xs:element ref="child" minOccurs="0" maxOccurs="5"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="child">
<xs:complexType>
<xs:sequence>
<xs:element ref="parent" minOccurs="0" maxOccurs="2"/>
</xs:sequence>
</xs:complexType>
</xs:element>
Le pilote XML mappe le premier élément parent et l'élément child aux tables et ignore le parent
child.
6.5.10 Pilote XML : Mappage des éléments any et anyAttribute
Exemple : Schéma XSD avec élément any
<xs:element name="documentation">
<xs:complexType>
<xs:sequence>
<xs:element name="name" type="xs:string"/>
<xs:element name="datatype" type="xs:string"/>
105
2013-09-19
Informations de référence sur le pilote d'accès aux données
<xs:any minOccurs="0" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>
</xs:element>
•
•
Les éléments name et datatype sont mappés aux colonnes
L'élément any est mappé à la colonne -any
Exemple : Fichier XML avec élément any
<documentation>
<name>Data Access Guide</name>
<datatype>XML</datatype>
<audience>
<type>External</type>
<name>Administrator</name>
</audience>
</documentation>
Les données de la colonne -any représentent le nom d'élément et son contenu. Dans cet exemple,
il contient la ligne suivante :
<audience><type>External</type><name>Administrator</name></audience>
Restriction :
Si l'élément any possède une valeur maxOccurs supérieure à 1, le pilote XML est uniquement mappé
à la colonne -any, le premier élément obtenu lors de l'analyse du document XML. Les autres noms
d'éléments sont ignorés.
Dans l'exemple suivant, <format>PDF</format> est ignoré.
<documentation>
<name>Data Access Guide</name>
<datatype>XML</datatype>
<audience>
<type>External</type>
<name>Administrator</name>
</audience>
<format>PDF</format>
</documentation>
Exemple : Schéma XSD avec élément anyAttribute
<xs:element name="documentation">
<xs:complexType>
<xs:sequence>
<xs:element name="name" type="xs:string"/>
<xs:element name="datatype" type="xs:string"/>
</xs:sequence>
<xs:anyAttribute/>
</xs:complexType>
</xs:element>
•
•
Les éléments name et datatype sont mappés aux colonnes
L'élément anyAttribute est mappé à la colonne -@anyAttribute
Exemple : Fichier XML avec élément anyAttribute
<documentation myAttribute="ConnectionServer">
<name>Data Access Guide</name>
<datatype>XML</datatype>
</documentation>
106
2013-09-19
Informations de référence sur le pilote d'accès aux données
<documentation myAttribute="DataFederator">
<name>Data Federator User Guide</name>
<datatype>any</datatype>
</documentation>
Les données de la colonne -@anyAttribute représentent le nom d'attribut de l'élément et sa valeur.
Dans cet exemple, les données de la colonne contiennent les deux lignes suivantes :
myAttribute="ConnectionServer"
myAttribute="DataFederator"
6.5.11 Pilote XML : Mappage des éléments anyType et simpleType
Les sections suivantes illustrent comment anyType et des ajustements spécifiques de simpleType
dans des schémas XML sont mappés.
Mappage du type anyType
Tout le contenu d'un élément de type anyType est mappé à une colonne de table.
Exemple : anyType
Dans l'exemple Club Demo, l'élément Address suivant est mappé à la colonne Address.
<xs:element name"Address" type="xs:anyType"/>
Mappage des listes de valeurs
Indépendamment du type de données de base de la valeur, une liste de valeurs est toujours mappée
à VARCHAR.
Exemple : Liste des types de données
Le type de données de base est un nombre entier. Le type de données de la liste d'entiers est
VARCHAR.
<intvalues>100 34 56 -23 1567</intvalues>
Mappage des restrictions à un type
La valeur d'un élément peut être restreinte à une certaine plage. Cela n'a aucun impact sur la conversion
du type de données.
Exemple : Restriction
<xs:element name="age">
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="100"/>
</xs:restriction>
107
2013-09-19
Informations de référence sur le pilote d'accès aux données
</xs:simpleType>
</xs:element>
Mappage des unions de types
Les données XML auxquelles l'union est mappée sont de type chaîne, c'est-à-dire des types de données
CHAR ou VARCHAR dans des fondations de données.
Exemple : Union de types
<xs:element name="jeans_size">
<xs:simpleType>
<xs:union memberTypes="xs:string xs:int"/>
</xs:simpleType>
</xs:element>
6.5.12 Pilote XML : Configuration de la taille maximale de la colonne
Le fichier de configuration cs.cfg fournit les paramètres suivants :
•
•
•
Binary Max Length pour définir la taille maximale des colonnes de table de type binaire.
Integer Max Length pour définir la taille maximale des colonnes de table de type integer (nombre
entier), nonPositiveInteger (entier non positif ), negativeInteger (entier négatif), noNegativeInteger
(entier non négatif) et positiveInteger (entier positif).
String Max Length pour définir la taille maximale des colonnes de table de type chaîne ou de
type suivant : anyURI, QName, NOTATION, duration, gYearMonth, gYear, gMonthDay, gDay,
gMonth, TYPE_NORMALIZEDSTRING, token, language, Name, NCName, XSD_TYPE_ID, IDREF,
IDREFS, ENTITY, ENTITIES
Rubriques associées
• Binary Max Length
• Integer Max Length
• String Max Length
6.6 Pilote de services Web
La couche d'accès aux données permet à la plateforme de BI de se connecter aux services disponibles
sur Internet via HTTP ou FTP. Elle fournit un pilote d'accès aux données nommé pilote de services
Web pour communiquer avec les services Web à l'aide de messages SOAP 1.1.
108
2013-09-19
Informations de référence sur le pilote d'accès aux données
Les services Web sont définis dans des documents qui décrivent les types de données, les messages
et les liaisons avec WSDL (Web Services Description Language) 1.1.
Le pilote de services Web prend en charge les services Web de la liaison SOAP 1.1 et du style docu
ment ou rpc contenant le corps literal. Par exemple :
<wsdl:operation ...>
<soap:operation ... style="document"/>
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
...
</wsdl:operation>
ou
<wsdl:operation ...>
<soap:operation ... style="rpc"/>
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
...
</wsdl:operation>
Rappel :
Le pilote ne prend pas en charge les autres services et versions du protocole SOAP de styles autres
que document et rpc.
L'Assistant de connexion fournit un workflow pour entrer les informations requises afin de se connecter
aux services Web. Les services Web se trouvent sous le SGBD Web Services (WSDL 1.1) et la
couche réseau Web Services Connector.
Les fichiers de configuration du pilote se trouvent dans le répertoire rép-install-serveurdecon
nexion\connectionServer\xml. Le fichier xml.prm répertorie les fonctionnalités du pilote d'accès
aux données en termes de fonctions et d'opérations de base de données.
6.6.1 Fonctionnalités du pilote de services Web
Les pilotes XML et de services Web partagent les mêmes fonctionnalités.
Rubriques associées
• Fonctionnalités du pilote XML
6.6.2 Emplacement des services Web
L'emplacement des services Web est défini à l'aide du paramètre URL du service Web dans l'Assistant
de connexion, à l'aide des informations suivantes :
•
109
Nom d'utilisateur et mot de passe s'ils sont requis pour l'authentification
2013-09-19
Informations de référence sur le pilote d'accès aux données
•
•
Adresse du serveur proxy
Nom d'utilisateur et mot de passe du proxy s'ils sont requis pour l'authentification
La version actuelle prend également en charge les protocoles chiffrés HTTPS et FTPS basés sur un
certificat.
Rappel :
Le pilote de services Web prend uniquement en charge le document de définition de services Web et
les services associés hébergés sur le même serveur HTTP.
Exemple :
http://wsf.cdyne.com/WeatherWS/Weather.asmx?WSDL
6.6.3 Exemple de définition de services Web
L'exemple suivant illustre le document ClubDemo.wsdl qui définit le service Web CustomerService
du style document. Le modèle d'URL de ce service Web est http://ws.myexample.com/ClubDe
mo/ClubDemo.wsdl.
Exemple :
Le document WSDL définit les détails suivants :
•
•
•
•
•
•
•
Le service CustomerService
Le port Customer
La liaison GetCustomer
Le type de port CustomerType
L'opération GetCustomerList
Le message d'entrée GetCustomerListByCountryRequest, qui contient l'élément Country
Le message de sortie GetCustomerListByCountryResponse, qui contient l'élément GetCus
tomerListReturn du type complexe Customer
<wsdl:definitions targetNamespace="http://ws.myexample.com/ClubDemo/"
xmlns:apachesoap="http://xml.apache.org/xml-soap"
xmlns:impl="http://ws.myexample.com/ClubDemo/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">
<wsdl:types>
<schema targetNamespace="http://ws.myexample.com/ClubDemo/">
<complexType name="Customer">
<sequence>
<element name="Name" maxOccurs="2">
<complexType>
<simpleContent>
<extension base="xsd:string">
<attribute name="type" type="xsd:string"/>
</extension>
</simpleContent>
</complexType>
110
2013-09-19
Informations de référence sur le pilote d'accès aux données
</element>
<element name="Age" type="xsd:integer"/>
<element name="Address" type="xsd:string"/>
<element name="ZIP" type="xsd:string"/>
<element name="City" type="xsd:string"/>
<element name="Country">
<complexType>
<attribute name="name" type="xsd:string"/>
</complexType>
</element>
<element name="Invoice" type="xsd:integer" maxOccurs="unbounded"/>
</sequence>
<attribute name="ID" type="xsd:integer"/>
</complexType>
<element name="GetCustomerListByCountry">
<element name="Country">
<complexType>
<attribute name="name" type="xsd:string"/>
</complexType>
</element>
</element>
<element name="GetCustomerListResponse">
<complexType>
<sequence>
<element name="GetCustomerListReturn" type="impl:Customer" maxOccurs="unbounded"/>
</sequence>
</complexType>
<key name="custkey">
<selector xpath="GetCustomerListReturn"/>
<field xpath="@ID"/>
</key>
</element>
</schema>
</wsdl:types>
<wsdl:message name="GetCustomerListByCountryRequest">
<wsdl:part name="request" element="impl:GetCustomerListByCountry"></wsdl:part>
</wsdl:message>
<wsdl:message name="GetCustomerListByCountryResponse">
<wsdl:part name="response" element="impl:GetCustomerListResponse"></wsdl:part>
</wsdl:message>
<wsdl:portType name="CustomerType">
<wsdl:operation name="GetCustomerList">
<wsdl:documentation>Gets Information on ClubDemo Customers</wsdl:documentation>
<wsdl:input message="impl:GetCustomerListByCountryRequest"/>
<wsdl:output message="impl:GetCustomerListByCountryResponse"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="GetCustomer" type="impl:CustomerType">
<soap:binding transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="GetCustomerList">
<soap:operation soapAction="http://ws.myexample.com/ClubDemo/" style="document"/>
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="CustomerService">
<wsdl:port name="Customer" binding="impl:GetCustomer">
<soap:address location="http://ws.myexample.com/ClubDemo/"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
111
2013-09-19
Informations de référence sur le pilote d'accès aux données
6.6.4 Mappage des règles pour les services Web
Le pilote de services Web utilise les mêmes règles de mappage de table et de colonne que le pilote
XML. Il prend également en charge les règles suivantes spécifiques aux services Web.
Qualificateurs
La couche d'accès aux données peut se connecter à un service Web à la fois. Le service est mappé
au qualificateur de base de données. Dans l'exemple ClubDemo, le nom du qualificateur est le nom
du service CustomerService.
Propriétaires
L'attribut port est mappé au propriétaire de base de données. Dans cet exemple, le propriétaire est
Customer.
Tables
Dans la couche d'accès aux données, chaque opération est représentée en tant qu'élément racine.
Chaque message de sortie représente un élément enfant d'une opération. Le pilote de services Web
présente les messages de sortie sous forme de tables.
Les noms de table sont formés par concaténation des éléments suivants : noms de l'opération, du
message de sortie et des éléments XML contenus dans la réponse, séparés par une barre oblique /).
Exemple :
Dans l'exemple ClubDemo, les tables sont les suivantes :
•
•
•
•
GetCustomerList/GetCustomerListByCountryResponse/GetCustomerListResponse
GetCustomerList/GetCustomerListByCountryResponse/GetCustomerListRespo
nse/GetCustomerListReturn
GetCustomerList/GetCustomerListByCountryResponse/GetCustomerListRespo
nse/GetCustomerListReturn/Name
GetCustomerList/GetCustomerListByCountryResponse/GetCustomerListRespo
nse/GetCustomerListReturn/Invoice
Colonnes et colonnes d'entrée
Les règles de mappage XML définies pour les colonnes s'appliquent aussi aux services Web.
Le pilote de services Web accepte uniquement les tables possédant une seule ligne en tant que
messages d'entrée. Chaque entrée de cette table est mappée à une colonne d'entrée de la table de
résultats. Le pilote mappe tous les messages d'entrée, même s'ils sont définis comme facultatifs dans
le document WSDL.
Restriction :
Le pilote ne prend pas en charge les éléments any et anyAttribute dans les colonnes d'entrée.
112
2013-09-19
Informations de référence sur le pilote d'accès aux données
Dans les exemples suivants, la colonne GetCustomerListByCountryRequest/GetCustomerLi
stByCountry est une colonne d'entrée. Les autres noms de colonne résultent des règles de mappage
des éléments XML. Pour en savoir plus, voir la section relative au pilote XML.
Exemple :
Les colonnes de la table GetCustomerList/GetCustomerListByCountryResponse/GetCus
tomerListResponse sont les suivantes :
•
•
-id
GetCustomerListByCountryRequest/GetCustomerListByCountry
Exemple :
Les colonnes de la table GetCustomerList/GetCustomerListByCountryResponse/GetCus
tomerListResponse/GetCustomerListReturn sont les suivantes :
•
•
•
•
•
•
•
•
Age
Adresse
ZIP
Ville
Country/@name
@ID
-GetCustomerListResponse/-id
GetCustomerListByCountryRequest/GetCustomerListByCountry
Exemple :
Les colonnes de la table GetCustomerList/GetCustomerListByCountryResponse/GetCus
tomerListResponse/GetCustomerListReturn/Name sont les suivantes :
•
•
•
•
•
-id
Nom
@type
-GetCustomerListReturn/@ID
GetCustomerListByCountryRequest/GetCustomerListByCountry
Exemple :
Les colonnes de la table GetCustomerList/GetCustomerListByCountryResponse/GetCus
tomerListResponse/GetCustomerListReturn/Invoice sont les suivantes :
•
•
•
•
113
-id
Invoice
-GetCustomerListReturn/@ID
GetCustomerListByCountryRequest/GetCustomerListByCountry
2013-09-19
Informations de référence sur le pilote d'accès aux données
Clés primaires et clés étrangères
Les règles de mappage XML définies pour les clés primaire et étrangère s'appliquent aussi aux services
Web. En outre, une colonne d'entrée fait toujours partie de la définition d'une clé primaire.
Restriction :
Bien que les fondations de données présentent des clés étrangères, le pilote de services Web ne prend
pas en charge les opérations JOIN.
Exemple : Clés primaires
La colonne -id de la table GetCustomerList/GetCustomerListByCountryResponse/GetCu
stomerListResponse est générée car le schéma ne définit aucune clé primaire.
Le schéma définit une clé primaire explicite pour la colonne @ID de la table GetCustomerList/Get
CustomerListByCountryResponse/GetCustomerListResponse/GetCustomerListReturn.
La colonne d'entrée GetCustomerListByCountryRequest/GetCustomerListByCountry est
utilisée comme clé primaire.
Exemple : Clés étrangères
Les colonnes -GetCustomerListResponse/@ID et -GetCustomerListReturn/@ID sont
conçues à partir du chemin d'accès inverse de la table parent et la clé primaire de la table parent.
Types de tableaux de données
Les services Web prennent en charge les types de données au format d'un tableau créé à partir d'une
série de types primitifs ou complexes. Un élément de ce type est mappé à une table composée d'une
seule ligne. Il est mappé sous forme de nom de colonne ou de table sous la forme : -arrayElement.
Le type des données du tableau ne définit pas le nom de l'élément et accepte n'importe quel nom.
Pour en savoir plus, voir le lien ci-dessous.
Exemple : Types de tableaux de données
arrayType="xsd:int[2]" est un type de données d'un élément possédant deux occurrences et
dont la valeur est un nombre entier. Par exemple, le type complexe suivant s'applique à l'élément
CustomerIDs et le définit en tant que parent d'un élément CustomerID qui accepte les valeurs de
nombres entiers :
<complexType name="ArrayOfIntegers">
<complexContent>
<restriction base="soapenc:Array">
<attribute ref="soapenc:arrayType" wsdl:arrayType="xsd:int[2]"/>
</restriction>
</complexContent>
</complexType>
<element name="CustomerIDs" type="ArrayOfIntegers">
<CustomerID>103</CustomerID>
<CustomerID>204</CustomerID>
</element>
114
2013-09-19
Informations de référence sur le pilote d'accès aux données
Rubriques associées
• Details on arrays in SOAP 1.1 note
• Pilote XML : Mappage des colonnes
• Pilote XML : Mappage des clés primaires et étrangères
6.6.5 Pilote du service Web : Configuration de la taille maximale de la colonne
Tout comme le pilote XML, le pilote de services Web utilise également les paramètres Binary Max
Length, Integer Max Length et String Max Length du fichier cs.cfg pour traiter des valeurs
volumineuses de ces types de données.
Rubriques associées
• Binary Max Length
• Integer Max Length
• String Max Length
6.7 Disque local utilisé en tant que cache pour les opérations de tri
Le pilote d'accès aux données CSV OpenDriver et les pilotes OData, SAP ERP, XML et de services
Web peuvent utiliser le disque local en tant que cache pour les lignes triées.
Les pilotes d'accès aux données effectuent des opérations de tri (ORDER BY, GROUP BY et DISTINCT)
comme suit :
•
•
Dans la mémoire principale si les données à trier sont peu volumineuses
En écrivant les données dans un répertoire temporaire sur le disque local
Les lignes triées sont écrites sur le disque, soit lorsque la mémoire principale libre est trop faible, soit
lorsque le nombre de lignes défini à l'aide du paramètre SBO Bucket Split Size est atteint.
Le disque local est utilisé en tant que cache et les données sont écrites dans le dossier du répertoire
par défaut de votre ordinateur. Vous pouvez configurer le chemin de répertoire dans le fichier cs.cfg
avec le paramètre Temp Data Dir si le système d'exploitation ne spécifie aucun dossier temporaire.
Rubriques associées
• CSV OpenDriver
• Pilote OData
• Pilote SAP ERP
• Pilote XML
115
2013-09-19
Informations de référence sur le pilote d'accès aux données
• Pilote de services Web
• Paramètre Bucket Split Size
• Temp Data Dir
116
2013-09-19
Informations de référence sur la connexion
Informations de référence sur la connexion
7.1 Connexions HIVE
Les sections suivantes décrivent comment créer des connexions aux bases de données HIVE. Dans
cette version, vous pouvez créer des connexions à différentes versions des bases de données HIVE
simultanément.
7.1.1 Pour créer une connexion à Apache Hadoop HIVE
La couche d'accès aux données permet à la plateforme de BI de se connecter aux bases de données
Apache Hadoop HIVE 0.7.1, 0.8.0, 0.9.0, et 0.10 via JDBC sur toutes les plateformes.
1. Pour créer une connexion au serveur Apache Hive Thrift, placez les ensembles de fichiers JAR
suivants dans le répertoire rép-install-serveurdeconnexion\connectionSer
ver\jdbc\drivers\hadoop_version, où hadoop_version est hive07, hive08, hive09
ou hive010.
117
2013-09-19
Informations de référence sur la connexion
Version de base de données
Apache Hadoop HIVE
Fichiers JAR
hadoop-0.20.1-core.jar ou hadoop-core-0.20.2.jar
hive-exec-0.7.1.jar
hive-jdbc-0.7.1.jar
hive-metastore-0.7.1.jar
hive-service-0.7.1.jar
0.7.1
libfb303.jar
log4j-1.2.16.jar
commons-logging-1.0.4.jar
slf4j-api-1.6.1.jar
slf4j-log4j12-1.6.1.jar
hadoop-0.20.1-core.jar ou hadoop-core-0.20.2.jar
hive-exec-0.8.0.jar
hive-jdbc-0.8.0.jar
hive-metastore-0.8.0.jar
hive-service-0.8.0.jar
0.8.0
libfb303.jar
log4j-1.2.16.jar
commons-logging-1.0.4.jar
slf4j-api-1.6.1.jar
slf4j-log4j12-1.6.1.jar
118
2013-09-19
Informations de référence sur la connexion
Version de base de données
Apache Hadoop HIVE
Fichiers JAR
hadoop-0.20.1-core.jar ou hadoop-core-0.20.2.jar
hive-exec-0.9.0.jar
hive-jdbc-0.9.0.jar
hive-metastore-0.9.0.jar
hive-service-0.9.0.jar
0.9.0
libfb303.jar
log4j-1.2.16.jar
commons-logging-1.0.4.jar
slf4j-api-1.6.1.jar
slf4j-log4j12-1.6.1.jar
hadoop-0.20.1-core.jar ou hadoop-core-0.20.2.jar
hive-exec-0.10.0.jar
hive-jdbc-0.10.0.jar
hive-metastore-0.10.0.jar
hive-service-0.10.0.jar
0.10.0
libfb303.jar
log4j-1.2.16.jar
commons-logging-1.0.4.jar
slf4j-api-1.6.1.jar
slf4j-log4j12-1.6.1.jar
2. Exécutez l'Assistant de connexion.
3. Sélectionnez la version du pilote Apache Hadoop HIVE à utiliser.
4. Utilisez l'Assistant pour configurer la connexion.
Vous avez créé une connexion à la base de données Apache Hadoop HIVE.
119
2013-09-19
Informations de référence sur la connexion
Remarque :
Les connexions créées depuis la plateforme de BI 4.1 continuent à fonctionner dans cette version. Le
nom de base de données Apache Hadoop HIVE est un alias de Apache Hadoop Hive 0.7. Le
dossier hive correspondant aux fichiers JAR est toujours pris en charge.
Rubriques associées
• Informations de référence sur l'emplacement des fichiers JAR
7.1.2 Pour créer une connexion à Amazon EMR HIVE
La couche d'accès aux données permet à la plateforme de BI de se connecter aux bases de données
Amazon Elastic MapReduce (EMR) HIVE 0.7 et 0.8 via JDBC sur toutes les plateformes.
1. Configurez un tunnel SSH au nœud principal Amazon.
Pour en savoir plus, voir la documentation d'Amazon.
2. Téléchargez les fichiers JAR requis sur le site Web d'Amazon et placez-les dans le répertoire répinstall-serveurdeconnexion\connectionServer\jdbc\drivers\hiveemrhive_ver
sion, où emrhive_version est emrhive07 ou emrhive08.
3. Dans l'Assistant de connexion, spécifiez localhost pour le serveur et 10002 pour le port dans le
champ Serveur (hôte:port).
Vous avez créé une connexion à la base de données Amazon EMR HIVE.
Remarque :
Les connexions créées depuis la plateforme de BI 4.1 continuent à fonctionner dans cette version. Le
nom de base de données Amazon EMR HIVE est un alias d'Amazon EMR Hive 0.7. Le dossier
hive correspondant aux fichiers JAR est toujours pris en charge.
Rubriques associées
• Creating an SSH tunnel to the master node
• HIVE 0.7.1 JAR file download website
• HIVE 0.8.1 JAR file download website
• Informations de référence sur l'emplacement des fichiers JAR
7.2 Connexions IBM DB2 : Clés de référence mappées à une valeur nulle
Restriction :
En raison d'une restriction au niveau du pilote de base de données, les noms clés de référence d'IBM
DB2 10 pour les tables de bases de données z/OS sont mappés à une valeur nulle.
120
2013-09-19
Informations de référence sur la connexion
7.3 Connexions IBM Informix
Les sections suivantes décrivent les actions à effectuer en cas de problèmes avec des connexions IBM
Informix.
Rubriques associées
• Problèmes de valeurs de date avec différents fuseaux horaires
• Echec de connexion lorsque le mode Transaction n'est pas pris en charge
7.3.1 Problèmes de valeurs de date avec différents fuseaux horaires
Dans l'outil de conception d'information, il est possible que les requêtes relatives à IBM Informix Dynamic
Server 11 via JDBC renvoient des valeurs de type de données non valides si le serveur et l'outil client
se trouvent dans des fuseaux horaires différents. Pour éviter ce problème, vous devez affecter au JVM
une valeur de fuseau horaire identique à celle du niveau de serveur de base de données.
1. Quittez l'outil de conception d'information.
2. Accédez au répertoire rép-install-pbi\win32_x86.
3. Ouvrez le fichier InformationDesignTool.ini pour le modifier.
4. Ajoutez la ligne suivante à la fin du fichier :
-Duser.timezone=server_timezone_value
où server_timezone_value est la valeur de fuseau horaire définie sur le serveur de base de
données. Par exemple : GMT.
5. Enregistrez le fichier.
6. Relancez l'application.
Lorsque vous terminez cette tâche, les connexions à une base de données IBM Informix via JDBC sont
correctement configurées.
7.3.2 Echec de connexion lorsque le mode Transaction n'est pas pris en charge
La couche d'accès aux données permet aux opérations SQL d'être exécutées en tant que bloc de
transaction par défaut. Si l'Informix Dynamic Server ne prend pas en charge les transactions, des
échecs de connexion peuvent survenir. Pour éviter ce problème, vous devez spécifier, dans le fichier
de configuration, que le mode transaction n'est pas disponible.
121
2013-09-19
Informations de référence sur la connexion
1. Quittez l'outil client.
2. Ouvrez le fichier informix.sbo pour le modifier.
Il se trouve dans le répertoire rép-install-serveurdeconnexion\connectionServer\jdbc.
3. Ajoutez la ligne suivante sous la section Database appropriée :
<Parameter Name="Transactional Available">No</Parameter>
4. Enregistrez le fichier.
5. Redémarrez le service et l'application.
A l'issue de cette tâche, les connexions à IBM Informix sont correctement configurées.
Rubriques associées
• Mode de transaction disponible
7.4 Connexions MS Analysis Services
Attention :
Les connexions à MS Analysis Service via XMLA n'utilisent pas Connection Server.
Cette section ne concerne que les connexions qui seront crées dans l'outil de conception d'information.
Dans l'outil de conception d'information, les utilisateurs peuvent créer des connexions à MS Analysis
Services sur HTTP via un pilote XMLA.
Pour configurer ces connexions, vous devez d'abord activer l'accès HTTP. Pour en savoir plus, voir le
site Web Microsoft TechNet.
Rubriques associées
• http://technet.microsoft.com/en-us/library/cc917711.aspx
• http://technet.microsoft.com/en-us/library/cc917712.aspx
7.5 Connexions MS SQL Server : Définition des options de JVM
Après avoir installé le pilote JDBC pour MS SQL Server sous UNIX et configuré le fichier jdbc.sbo,
définissez les informations de JVM dans le fichier cs.cfg.
1. Ouvrez le fichier cs.cfg pour le modifier.
122
2013-09-19
Informations de référence sur la connexion
2. Ajoutez le chemin d'accès au fichier suivant dans la section JavaVM afin de remplacer la configuration
de JVM par défaut :
<LibraryName JNIVersion="JNI_VERSION_1_4">$BOBJEDIR/jdk/jre/lib/i386/server/libjvm.so</LibraryName>
3. Ajoutez une des options suivantes dans la section JavaVM :
Option
Description
Solaris ou Linux
<Options>
<Option>-Xmx512m</Option>
</Options>
AIX
<Options>
<Option>-Xmx511m</Option>
</Options>
Remarque :
Vous pouvez allouer 512 Mo ou plus à la JVM sous Solaris ou Linux, mas pas plus de 511 Mo sous
AIX.
4. Enregistrez le fichier.
7.6 Connexions Oracle
Les sections suivantes fournissent des informations de configuration relatives aux connexions Oracle.
Rubriques associées
• Connexions aux clusters de serveurs Oracle
• Pour définir la valeur de paramètre CURSOR_SHARING Oracle
7.6.1 Connexions aux clusters de serveurs Oracle
Les connexions aux clusters des serveurs Oracle qui fonctionnent en mode de basculement sont prises
en charge via JDBC. Le pilote choisit un de ces serveurs et, s'il n'est pas disponible, le suivant est
utilisé. Une erreur de connexion se produit si tous les serveurs sont indisponibles.
Dans l'Assistant de connexion, saisissez le nom de l'hôte et le numéro de port du serveur séparés par
un point-virgule dans Serveur(s) (hôte:port{,hôte:port}) pour créer une connexion JDBC. Saisissez
les informations pour un ou plusieurs serveurs si vous souhaitez tirer parti du mécanisme de
basculement.
123
2013-09-19
Informations de référence sur la connexion
7.6.2 Pour définir la valeur de paramètre CURSOR_SHARING Oracle
Les bases de données Oracle 10 et supérieures utilisent le paramètre CURSOR_SHARING. Les outils
de reporting de la plateforme de BI et de SAP BusinessObjects ne prennent en charge que la valeur
EXACT pour CURSOR_SHARING.
Si vous utilisez la valeur FORCE, des problèmes de performances des outils de reporting peuvent
survenir.
•
Effectuez l'une des actions suivantes :
Option
Description
Pour définir la valeur CURSOR_SHARING
sur la connexion d'univers
a. Ouvrez la connexion d'univers pour la modifier.
b. Cliquez sur Suivant pour passer à l'écran "Paramètres personnalisés".
c. Cliquez sur Ajouter un paramètre.
d. Saisissez ConnectInit et cliquez sur OK.
e. Saisissez "alter session set CURSOR_SHARING=EXACT" à titre de valeur ConnectInit.
f. Cliquez sur Terminer.
Pour définir la valeur CURSOR_SHARING
sur toutes les connexions Oracle
a. Naviguez jusqu'au répertoire où est stocké le fichier oracle.prm : connectionserver-ins
tall-dir\connectionServer\Oracle.
b. Ouvrez le fichier dans un éditeur XML.
c. Sous la section Configuration, ajoutez le paramètre suivant :
<Parameter Name="CURSOR_SHARING">EXACT</Parameter>
d. Enregistrez le fichier.
e. Redémarrez les services de connectivité et de
reporting depuis la CMC.
Remarque :
Pour la définition de CURSOR_SHARING, voir la documentation Oracle.
7.7 Connexions Oracle EBS
124
2013-09-19
Informations de référence sur la connexion
La couche d'accès aux données fournit un nouveau pilote pour connecter les applications SAP
BusinessObjects à Oracle E-Business Suite (EBS) via l'interface OCI (Oracle Call Interface). Cela
permet aux applications d'accéder aux données des vues et procédures stockées d'EBS. OCI peut
uniquement être utilisé pour connecter le pilote à Oracle EBS.
Lors de la création d'une connexion dans l'outil de conception d'univers ou dans l'outil de conception
d'information, vous choisissez d'abord le mode d'authentification qui est donné par l'utilisateur de
l'application si ce dernier fournit un nom d'utilisateur et un mot de passe lors de sa connexion à la
plateforme de BI, ou par la connexion unique si l'utilisateur se connecte avec des références Oracle
EBS. Vous choisissez ensuite l'application Oracle EBS, la responsabilité et le groupe de sécurité, qui
définissent la source de données de votre univers.
La plateforme de BI fournit la connexion unique pour Oracle EBS à l'aide d'un plug-in d'authentification.
La connexion unique est activée lorsque le plug-in est correctement installé et configuré. La connexion
unique permet à l'utilisateur de l'application de se connecter à la zone de lancement BI avec les
références de connexion Oracle EBS. Les mêmes références sont utilisées par le serveur de connexion
pour accéder à la source de données Oracle EBS. Pour en savoir plus sur le plug-in d'authentification,
reportez-vous au Guide d'administration de la plateforme SAP BusinessObjects Business Intelligence.
7.8 Connexions Oracle Essbase
Attention :
En raison d'une restriction dans le middleware Essbase pour les univers .unv, un déploiement spécifique
du serveur de la plateforme de BI est requis pour prendre en charge à la fois les univers .unv et .unx
basés sur Essbase. Pour déployer un serveur prenant en charge à la fois les univers Essbase .unv
et .unx, configurez un système avec les deux clusters suivants sur deux ordinateurs distincts :
•
•
Dans un environnement 64 bits, installez les logiciels suivants sur le premier cluster (Cluster1) : la
plateforme de BI 64 bits, le CMS (Central Management Server), les serveurs Web Intelligence, un
serveur de connexion 64 bits et tous les pilotes de middleware 64 bits.
Dans un environnement 32 bits, installez les logiciels suivants sur le second cluster (Cluster2) : le
serveur de connexion 32 bits et les pilotes de middleware 32 bits (y compris le pilote Essbase 32 bits
pour les univers .unv).
Au moment de l'exécution, le serveur de connexion utilise Cluster2 pour les univers .unv. Le client
OLAP, qui sert les univers .unx, utilise le middleware 64 bits disponible dans Cluster1.
7.9 Connexions Oracle RAC
La couche d'accès aux données permet à la plateforme de BI de se connecter aux RAC (Real Application
Clusters) Oracle via JDBC.
125
2013-09-19
Informations de référence sur la connexion
Pour créer une connexion à partir de votre application via l'Assistant de connexion, vous devez fournir
l'entrée de la source de données Oracle RAC. Son format est le suivant :
<host>:<port>,<host>:<port>,...,<host>:<port>
Le nombre de paires d'hôtes et de ports dépend du nombre d'ordinateurs impliqués dans le cluster.
Exemple :
pmrac1.us.oracle.com:1521,pmrac2.us.oracle.com:1521
7.10 Connexions salesforce.com : Configuration de l'environnement
Vous devez d'abord configurer votre environnement pour faire fonctionner les connexions salesforce.com
dans l'outil de conception d'univers ou l'outil de conception d'information.
1. Arrêtez le service de connectivité de la CMC et l'application client.
2. Exécutez regedit.exe dans la ligne de commande MS Windows pour ouvrir l'Editeur de registre.
3. Accédez à la source de données ODBC Salesforce sous HKEY_LOCAL_MACHINE > SOFTWARE
> ODBC > ODBC.INI > <SALESFORCE_DSN_NAME>, où SALESFORCE_DSN_NAME est le nom de
la source de données salesforce.com.
4. Cliquez avec le bouton droit de la souris sur le nom de source de données et sélectionnez Nouvelle
> Valeur de chaîne.
5. Saisissez CheckJVMChanged.
6. Cliquez deux fois sur la propriété, puis saisissez 0.
7. Fermez l'Editeur de registre.
Vous devez ensuite suivre les étapes ci-dessous afin de terminer la configuration.
Rubriques associées
• Fonctionnement des connexions salesforce.com dans l'outil de conception d'information
• Fonctionnement des connexions salesforce.com dans l'outil de conception d'univers
7.10.1 Fonctionnement des connexions salesforce.com dans l'outil de conception
d'information
1. Quittez l'outil de conception d'information.
2. Copiez le fichier de pilote sforce.jar dans le répertoire rép-installpbi\win32_x86\jdk\jre6\lib\ext.
126
2013-09-19
Informations de référence sur la connexion
3. Accédez au répertoire rép-install-pbi\win32_x86.
4. Ouvrez le fichier InformationDesignTool.ini pour le modifier.
5. Ajoutez la ligne suivante à la fin du fichier :
-Dosgi.parentClassloader=ext
6. Enregistrez le fichier.
7. Relancez l'application.
A la fin de cette tâche, les connexions à salesforce.com sont correctement configurées.
7.10.2 Fonctionnement des connexions salesforce.com dans l'outil de conception
d'univers
1. Quittez l'outil de conception d'information.
2. Ouvrez le fichier cs.cfg pour le modifier.
3. Dans la section JavaVM, ajoutez le chemin suivant :
<ClassPath>
<Path>C:\Program Files (x86)\Progress\DataDirect\Connect_for_ODBC_61\java\lib\sforce.jar</Path>
</ClassPath>
4. Enregistrez le fichier.
5. Ouvrez le fichier openaccess.sbo pour le modifier.
Il se trouve dans le répertoire rép-install-connectionserver\connectionServer\odbc.
6. Ajoutez la ligne suivante sous la section Database :
<Parameter Name="Transactional Available">No</Parameter>
7. Enregistrez le fichier.
8. Redémarrez le service et l'application.
A la fin de cette tâche, les connexions à salesforce.com sont correctement configurées.
Rubriques associées
• Mode de transaction disponible
7.11 Connexions SAP BW
127
2013-09-19
Informations de référence sur la connexion
La couche d'accès aux données permet à la plateforme de BI d'accéder à la source de données SAP
BW.
Les connexions à SAP BW via BAPI sont des connexions OLAP.
La présente version permet de créer des univers .unv reposant sur SAP BW. Les connexions SAP
BW peuvent fonctionner indifféremment avec un serveur de connexion 32 bits ou un serveur de
connexion 64 bits.
7.11.1 Pour activer les connexions SAP BW 64 bits
Vous pouvez utiliser les connexions SAP BW avec une serveur de connexion 64 bits pour créer des
univers .unv.
Vous pouvez installer le pilote SAP BW 64 bits sur une plateforme SAP BusinessObjects BI.
• Suivez la procédure ci-après en fonction du type d'installation que vous réalisez :
• Si vous réalisez une installation complète de cette version, les connexions SAP BW utiliseront
le serveur de connexion 64 bits.
• Si vous réalisez une installation de correctif sur une plateforme existante, les connexions SAP
BW continueront à utiliser le serveur de connexion 32 bits. Pour utiliser le serveur de connexion
64 bits, procédez comme suit :
a. Recherchez le programme d'installation de la plateforme SAP BusinessObjects Business
Intelligence 4.1.
b. Cliquez avec le bouton droit de la souris et sélectionnez Désinstaller/Modifier.
c. Dans l'écran "Sélectionner les fonctionnalités" de la boîte de dialogue "Installation de la plateforme
SAP BusinessObjects BI", sélectionnez l'option SAPBW64 sous Accès à la base de données.
d. Cliquez sur Suivant et terminez l'installation.
Vous avez installé le pilote SAP BW 64 bits sur la plateforme. Vous pouvez à présent créer des
connexions SAP BW utilisant le serveur de connexion 64 bits.
7.12 Connexions SAP ERP : Echec de chargement du pilote
Le message d'erreur suivant peut s'afficher dans SAP BusinessObjects Web Intelligence :
Database error: (CS) "Java Exception : java.lang.NoClassDefFoundError:
com/sap/bip/jco/JCoManager : cannot initialize class because prior initialization attempt failed"
Cela signifie que le pilote SAP ERP ne se charge pas car le serveur de traitement Web Intelligence est
incapable trouver le fichier sapjco3.dll.
128
2013-09-19
Informations de référence sur la connexion
Pour faire fonctionner les connexions SAP ERP, vous devez copier le fichier depuis le répertoire du
serveur de la plateforme de BI (rép-install-pbi\win64_x64) dans le répertoire MS Windows
(C:\WINDOWS\system32). Redémarrez ensuite le serveur de traitement Web Intelligence.
7.13 Connexions SAP HANA
La couche d'accès aux données permet à la plateforme de BI de se connecter à la base de données
SAP HANA 1.0 SPS 06 via ODBC et JDBC sur toutes les plateformes. La version actuelle prend
également en charge les connexions OLAP à la base de données SAP HANA sous MS Windows, Linux
et AIX.
Taille de l'Array fetch
La valeur par défaut de la taille de l'Array fetch est 1 000 pour les connexions SAP HANA.
Attention :
Compte tenu du fait qu'une valeur élevée pour la taille de l'Array fetch nécessite davantage
de mémoire, cette configuration peut affecter la performance du système.
Basculement
Les connexions aux clusters des serveurs SAP HANA qui fonctionnent en mode de basculement sont
prises en charge via ODBC et JDBC. Le pilote choisit un de ces serveurs et, s'il n'est pas disponible,
le suivant est utilisé. Une erreur de connexion se produit si tous les serveurs sont indisponibles.
Paramètres régionaux de visualisation préférés
Les connectivités SAP HANA prennent en charge les paramètres régionaux de visualisation préférés
(PVL) pour tous les modes d'authentification, via JDBC et ODBC. Les PVL permettent à l'utilisateur de
récupérer des données localisées si la base de données stocke des données en plusieurs langues.
Connexion unique à une base de données
La plateforme de BI fournit la connexion unique à la base de données soit via Windows AD à l'aide de
Kerberos, soit via le protocole SAML sur les plateformes MS Windows et Linux. La connexion unique
à l'aide de Kerberos est disponible pour les connexions JDBC et ODBC. La connexion unique à l'aide
du protocole SAML est disponible pour les connexions JDBC uniquement.
Si les implémentations de type Kerberos et SAML sont disponibles dans votre environnement, la
plateforme utilise le protocole SAML en priorité. Si un problème survient lors de l'utilisation du protocole
SAML, la plateforme utilise Kerberos à la place. Cette logique apparaît de manière transparente à
l'utilisateur d'application. Pour désactiver l'utilisation du protocole SAML, définissez le paramètre Skip
SAML SSO sur True dans le fichier de configuration newdb.sbo approprié.
La plateforme de BI fournit également la connexion unique à la base de données soit via Windows AD
à l'aide de Kerberos, soit via le protocole SAML dans les connexions OLAP.
Une fois les utilisateurs connectés à la plateforme de BI depuis une application SAP BusinessObjects,
ils peuvent effectuer des actions nécessitant un accès à la base de données, par exemple actualiser
des documents Web Intelligence, sans fournir leurs références de connexion à la base de données.
129
2013-09-19
Informations de référence sur la connexion
Prise en charge d'UNIX
A partir de la version 4.1, la couche d'accès aux données permet à la plateforme de BI de se connecter
à la base de données SAP HANA via ODBC sur des plateformes UNIX 64 bits.
Utilisation de SSL
Les connexions relationnelles et OLAP à SAP HANA peuvent utiliser le protocole SSL.
Rubriques associées
• Skip SAML SSO
7.13.1 Création d'une connexion SAP HANA
Création d'une connexion JDBC
Les pilotes JDBC SAP HANA 1.0 SPS 06 sont installés dans le cadre de la plateforme de BI dans le
répertoire rép-install-serveurdeconnexion\connectionServer\jdbc\drivers\newdb.
Par conséquent, il n'est pas nécessaire d'effectuer de configuration supplémentaire pour créer une
connexion à la base de données SAP HANA.
Sélectionnez l'une des options suivantes dans l'Assistant de connexion pour créer une connexion
JDBC :
•
Un seul serveur
Saisissez le nom de l'hôte SAP HANA et le numéro d'instance dans les champs Nom de l'hôte et
Numéro d'instance.
•
Plusieurs serveurs (basculement)
Saisissez le nom d'hôte et le numéro de port du serveur séparés par un point-virgule dans Serveur
(hôte:port{;hôte:port}). Saisissez les informations pour un ou plusieurs serveurs si vous souhaitez
tirer parti du mécanisme de basculement.
La convention pour le numéro de port est la suivante :
3##15
où ## est le numéro d'instance HANA.
Exemple :
Si vous vous connectez à l'instance 0, saisissez soit le numéro d'instance 00, soit le numéro de port
30015 dans l'Assistant. Si vous vous connectez à l'instance 1, saisissez soit le numéro d'instance
01, soit le numéro de port 30115.
130
2013-09-19
Informations de référence sur la connexion
Utilisation de SSL
Sélectionnez Utiliser SSL dans l'Assistant de connexion pour créer une connexion OLAP ou JDBC
qui utilise le protocole SSL pour se connecter au serveur SAP HANA.
Remarque :
Pour utiliser SSL via ODBC sous MS Windows, ouvrez l'Administrateur de source de données ODBC,
puis sélectionnez SSL lorsque vous configurez le DSN.
Rubriques associées
• Création de connexions JDBC
7.13.2 Modification d'une connexion SAP HANA
Une connexion SAP HANA ouverte à des fins de modification peut s'afficher sous Serveur unique ou
Plusieurs serveurs (basculement) dans l'Assistant de connexion. Pour modifier la connexion, effectuez
l'une des actions suivantes :
•
•
Si elle apparaît dans Serveur unique, modifiez le nom de l'hôte et le numéro d'instance de la source
de données.
Si elle apparaît dans Plusieurs serveurs (basculement), modifiez le nom de l'hôte et le numéro
de port du serveur.
7.13.3 Avant de configurer la connexion unique pour les connexions SAP HANA
Rappel :
Cette section traite de la configuration de la connexion unique via Windows AD à l'aide de Kerberos
pour les connexions SAP HANA.
Avant de configurer les options Java VM requises, vous devez créer les fichiers de configuration bs
cLogin.conf JAAS et krb5.ini Kerberos pour préparer votre application à l'authentification Windows
AD. Pour en savoir plus, voir le Guide d'administration de la plateforme SAP BusinessObjects Business
Intelligence.
Rubriques associées
• Pour configurer la connexion unique pour l'outil de conception d'information
• Pour configurer la connexion unique pour Web Intelligence
• Pour configurer la connexion unique pour Web Intelligence Rich Client
• Avant de configurer la connexion unique pour les connexions SAP HANA
131
2013-09-19
Informations de référence sur la connexion
7.13.4 Pour configurer la connexion unique pour l'outil de conception d'information
Les étapes suivantes permettent d'activer la connexion unique à la base de données SAP HANA via
JDBC à partir de l'outil de conception d'information.
• Effectuez l'une des actions suivantes :
132
2013-09-19
Informations de référence sur la connexion
Option
Description
Pour configurer la connexion unique pour a. Quittez l'outil de conception d'information.
des connexions locales via JDBC
b. Ouvrez le fichier InformationDesignTool.ini
pour le modifier.
Ce fichier se trouve dans le répertoire rép-ins
tall-pbi\win32_x86.
c. Ajoutez les lignes suivantes :
-Djava.security.auth.login.config=C:\<location>\bscLo
gin.conf
-Djava.security.krb5.conf=C:\<location>\Krb5.ini
où <location> est le répertoire des fichiers de
configuration sur l'ordinateur où est exécuté le
serveur de connexion.
d. Enregistrez le fichier.
e. Redémarrez l'outil de conception d'information.
Pour configurer la connexion unique pour
L'objectif est de configurer l'Adaptive Connectivity
des connexions situées sur le CMS via
Service.
JDBC
a. Ouvrez la CMC.
b. Sous "Services de connectivité", arrêtez l'Adaptive
Connectivity Service hébergé par l'Adaptive Processing Server.
c. Allez à la page "Propriétés".
d. Ajoutez les options suivantes à la propriété "Paramètres de ligne de commande" :
-Djava.security.auth.login.config=C:\<location>\bscLo
gin.conf
-Djava.security.krb5.conf=C:\<location>\Krb5.ini
où <location> est le répertoire des fichiers de
configuration sur l'ordinateur sur lequel est exécuté
le serveur de connexion.
e. Cliquez sur Enregistrer.
f. Redémarrez le service à partir de la CMC.
Rappel :
Vous devez également configurer l'Adaptive Connectivity Service pour activer la connexion unique au Web
Intelligence Rich Client en mode Connexion. Ces
étapes permettent aussi de configurer la connexion
unique pour tous les autres services Java tels que les
services de fédération de données. Les services de
fédération de données sont utilisés pour interroger
les univers à sources multiples basés sur une connexion SAP HANA.
133
2013-09-19
Informations de référence sur la connexion
7.13.5 Pour configurer la connexion unique pour Web Intelligence
Les étapes suivantes permettent d'activer la connexion unique à la base de données SAP HANA via
JDBC pour SAP BusinessObjects Web Intelligence.
Remarque :
Cette procédure s'applique à l'interface Java ou HTML de SAP BusinessObjects Web Intelligence
lancée par l'utilisateur de l'application depuis la zone de lancement BI.
Rappel :
Cette configuration concerne uniquement les services de reporting Web Intelligence hébergés par le
serveur de traitement Web Intelligence.
1. Ouvrez la CMC.
2. Sous "Services Web Intelligence", arrêtez le service de reporting hébergé par le serveur de traitement
Web Intelligence.
3. Ouvrez le fichier cs.cfg pour le modifier.
4. Dans la section JavaVM, ajoutez les options Java VM suivantes :
<Options>
<Option>-Djava.security.auth.login.config=C:\<location>\bscLogin.conf</Option>
<Option>-Djava.security.krb5.conf=C:\<location>\Krb5.ini</Option>
<Options>
où <location> est le répertoire des fichiers de configuration sur l'ordinateur sur lequel est exécuté
le serveur de connexion.
5. Enregistrez le fichier.
6. Redémarrez le service à partir de la CMC.
7.13.6 Pour configurer la connexion unique pour Web Intelligence Rich Client
Les étapes suivantes permettent d'activer la connexion unique à la base de données SAP HANA via
JDBC à partir de l'application Web Intelligence Rich Client.
•
Suivez l'une des procédures ci-dessous :
• Si vous vous connectez à Web Intelligence Rich Client à partir d'un document WID ou du menu
Démarrer de Windows :
a. Fermez votre document et quittez Web Intelligence Rich Client.
b. Créez les variables d'environnement suivantes :
• java.security.auth.login.config=C:\<location>\bscLogin.conf
• java.security.krb5.conf=C:\<location>\Krb5.ini
où <location> est le répertoire des fichiers de configuration sur l'ordinateur sur lequel est
exécuté le serveur de connexion.
c. Redémarrez Web Intelligence Rich Client.
134
2013-09-19
Informations de référence sur la connexion
•
Si vous utilisez Web Intelligence Rich Client en mode connecté depuis la zone de lancement BI
(également appelé mode HTTP), vous devez configurer l'Adaptive Connectivity Service. Suivez
les étapes décrites pour configurer la connexion unique pour l'outil de conception d'information.
Rubriques associées
• Pour configurer la connexion unique pour l'outil de conception d'information
7.13.7 Pour configurer la JVM (Java Virtual Machine) pour l'instrumentation
Vous pouvez surveiller l'activité des pilotes SAP HANA si vous installez CA Wily Introscope avec la
plateforme de BI. Cette instrumentation fournit un support de traçage de bout en bout pour les connexions
SAP HANA via ODBC et JDBC.
Le traçage SAP HANA est activé par défaut sur la plateforme. Vous devez toutefois configurer la JVM
pour pouvoir utiliser le pont JNI.
1. Ouvrez le fichier cs.cfg pour le modifier.
2. Ajoutez les chemins d'accès suivants aux fichiers JAR dans la section JavaVM afin de charger les
classes requises :
<ClassPath>
<Path>"bip-install-dir\java\lib\TraceLog.jar;bip-install-dir\java\lib\external\com.sap.js.passport.api.jar"
</Path>
</ClassPath>
3. Ajoutez les options suivantes dans la section JavaVM :
<Options>
<Option>-javaagent:bip-install-dir\java\wily\Agent.jar</Option>
<Option>-Dcom.wily.introscope.agentProfile=bip-install-dir\java\wily\IntroscopeAgent_CSJNI.profile</Option>
<Option>-Dcom.wily.introscope.agent.agentName=CSJNIEngine</Option>
</Options>
4. Enregistrez le fichier.
5. Ouvrez le fichier IntroscopeAgent_CSJNI.profile pour le modifier.
Il se trouve dans le répertoire rép_install_pbi\java\wily.
6. Remplacez localhost par le nom de l'hôte d'Introscope Agent à la ligne suivante :
introscope.agent.enterprisemanager.transport.tcp.host.DEFAULT=localhost
7. Enregistrez le fichier.
7.14 Connexions SAP MaxDB
135
2013-09-19
Informations de référence sur la connexion
Sous ODBC, veillez à utiliser le pilote SAP MaxDB ODBC version 7.7.07 (numéro de version 07 ou
supérieur). SAP MaxDB fournit des pilotes ASCII et Unicode pour MS Windows et UNIX. La version
ASCII du pilote ODBC se connecte toujours au noyau de la base de données à l'aide d'ASCII. La version
Unicode du pilote ODBC se connecte aux noyaux des bases de données ASCII via les noyaux des
bases de données ASCII et Unicode à l'aide d'UCS2.
SAP MaxDB ne nécessite pas de gestionnaire de pilotes spécifique sous UNIX. Cependant, et si cela
s'avère nécessaire, il peut être configuré de façon à fonctionner avec les gestionnaires de pilotes
suivant :
•
•
unixODBC 2.0.9 ou supérieur
iODBC 3.0.5 ou supérieur
Sous JDBC, veillez à utiliser la dernière version du pilote sapdbc.jar. Pour en savoir plus sur le pilote
SAP MaxDB JDBC, consultez le fichier de configuration maxdb.sbo.
7.15 Connexions SAP NetWeaver BW
Les connexions relationnelles à SAP NetWeaver BW n'utilisent pas le serveur de connexion. Ces
connexions passent par un connecteur dédié et utilise une façade spécifique dans SAP NetWeaver
BW.
Pour des informations détaillées sur la configuration et l'ajustement des connexions à
SAP NetWeaver BW, voir le Guide de l'outil d'administration de fédération de données.
7.15.1 Configuration requise pour la connexion de Data Federator à SAP NetWeaver
BW
Pour vous connecter à SAP NetWeaver BW, vous devez utiliser une version compatible avec SAP
NetWeaver BW ainsi que les notes SAP appropriées :
• La version minimale requise est SAP NetWeaver BI 7.01 SP06.
Remarque :
le nom officiel SAP NetWeaver BW a changé d'une version à l'autre. Avant la version 7.3, ce nom
était SAP NetWeaver BI.
•
La note SAP requise est : https://service.sap.com/sap/support/notes/1460273.
Pour en savoir plus sur les versions de SAP NetWeaver BW prises en charge, voir la Product Availability
Matrix (matrice de disponibilité des produits).
136
2013-09-19
Informations de référence sur la connexion
7.15.2 Conditions pour le fonctionnement de connexions dans l'outil de conception
d'information
Une application externe telle que l'outil de conception d'information peut se connecter à SAP NetWeaver
BW si la passerelle SAP le permet.
Pour faire en sorte que les connexions fonctionnent dans l'outil de conception d'information, veillez à
ce que les paramètres de sécurité de passerelle SAP correspondant aux programmes externes soient
correctement configurés. Pour en savoir plus, voir la documentation en ligne de la passerelle SAP.
Rubriques associées
• Security Parameters - Connectivity - SAP Library
7.15.3 Conditions pour l'accès à des univers à plusieurs sources de SAP NetWeaver
BW
Les utilisateurs d'applications doivent disposer d'autorisations pour accéder à des univers à plusieurs
sources reposant sur la base de données SAP NetWeaver BW.
Pour en savoir plus sur les autorisations nécessaires aux utilisateurs des applications de requêtes et
de reporting pour accéder aux univers à plusieurs sources sur SAP NetWeaver BW, voir la note
SAP 1465871.
Rubriques associées
• SAP Note #1465871
7.16 Connexions SAS
Les connexions au SAS n'utilisent pas Connection Server. Elles utilisent un connecteur JDBC adapté
aux ensembles de données SAS/SHARE.
Pour configurer ces connexions, vous devez installer le pilote JDBC compatible.
Pour en savoir plus sur la configuration des connecteurs SAS, consultez le Guide de l'outil
d'administration de fédération de données.
137
2013-09-19
Informations de référence sur la connexion
7.16.1 Installation de pilotes pour les connexions SAS
Afin d'utiliser un connecteur SAS, vous devez installer un pilote qui laisse le moteur de recherche de
fédération de données se connecter au serveur SAS/SHARE.
Un serveur SAS/SHARE est un serveur qui vous permet de vous connecter aux ensembles de données
SAS. Pour plus d'informations concernant le SAS/SHARE, visitez le site Web SAS/SHARE.
Le répertoire dans lequel vous devez copier les fichiers JAR du pilote JDBC SAS sur l'ordinateur où la
plateforme de BI est installée est le suivant : rép-install-boe/java/pjs/services/DataFede
ratorService/resources/drivers/sas.
Vous devez créer les dossiers drivers/sas sous le dossier resources.
Pour en savoir plus sur les versions de SAS prises en charge, voir la Product Availability Matrix (matrice
de disponibilité des produits).
Rubriques associées
• http://www.sas.com/products/share/index.html
7.17 Connexions Teradata : Mappage de la base de données Teradata au propriétaire
actuel
La section suivante fournit des informations de configuration relatives aux connexions Teradata.
Une base de données Teradata prend en charge les propriétaires de table, mais pas les qualificateurs.
Le serveur de connexion renvoie l'utilisateur actuel en tant que propriétaire actuel des sources de
données Teradata. Il est cependant possible de configurer la source de données afin de mapper un
utilisateur à la base de données d'un autre utilisateur. Dans ce cas, vous pouvez configurer le pilote
Teradata afin de mapper le propriétaire actuel à la base de données à l'aide du paramètre Replace
Current Owner With Database (Remplacer le propriétaire actuel par la base de données). Ce
paramètre ne peut être utilisé qu'avec les connexions ODBC.
Rubriques associées
• Replace Current Owner With Database
138
2013-09-19
Création d'une connexion au serveur de requêtes Data Federator XI 3.0
Création d'une connexion au serveur de requêtes Data
Federator XI 3.0
8.1 A propos des connexions au serveur de requêtes Data Federator XI 3.0
Vous pouvez établir des connexions à des tables déployées sur le serveur de requêtes
Data Federator XI 3.0 afin d'utiliser ces tables avec une application SAP BusinessObjects.
Ce chapitre décrit les paramètres de configuration que vous devez définir dans le serveur de requêtes
Data Federator XI 3.0 et Connection Server pour créer des connexions.
Vous pouvez créer des connexions au serveur de requêtes Data Federator XI 3.0 uniquement en
utilisant l'outil de conception d'univers. Ce chapitre indique également la configuration à paramétrer
dans l'Assistant de connexion pour pouvoir créer des connexions.
Connexions JDBC
Aucun paramètre supplémentaire n'est nécessaire pour créer des connexions JDBC. Le pilote JDBC
Data Federator est inclus dans la plateforme SAP BusinessObjects Business Intelligence 4.0 et est
configuré pour s'exécuter en parfaite intégration avec le serveur de requêtes Data Federator XI 3.0.
Connexions ODBC
Avec les connexions ODBC, la configuration dépend de l'application SAP BusinessObjects que vous
utilisez. Le processus diffère si vous créez une connexion à utiliser avec Web Intelligence Rich Client.
Attention :
SAP recommande d'utiliser une connectivité JDBC pour connecter les applications SAP BusinessObjects
au serveur de requêtes Data Federator XI 3.0. La connectivité JDBC est disponible sur toutes les
plateformes (Microsoft Windows, systèmes d'exploitation UNIX et Linux).
Le middleware ODBC Data Federator peut uniquement être utilisé sous Microsoft Windows. L'utilisation
d'une passerelle ODBC-JDBC OpenAccess a par ailleurs une incidence sur les performances.
Rubriques associées
• Configuration de l'Assistant de connexion pour une connexion JDBC ou ODBC Data Federator
• Configuration des connexions ODBC Data Federator
• Configuration des connexions Web Intelligence Rich Client à l'aide du middleware ODBC Data Federator
139
2013-09-19
Création d'une connexion au serveur de requêtes Data Federator XI 3.0
8.2 Configuration de l'Assistant de connexion pour une connexion JDBC ou ODBC
Data Federator
Pour créer une connexion au serveur de requêtes Data Federator XI 3.0, les informations suivantes
sont nécessaires. Contactez votre administrateur Data Federator pour obtenir ces informations :
• Nom de serveur et port sur lequel le serveur de requêtes Data Federator est exécuté.
•
Nom du catalogue sur le serveur de requêtes Data Federator
Dans l'Assistant de connexion, il s'agit du nom de la base de données à laquelle vous vous connectez.
•
Détails d'authentification pour l'installation du serveur de requêtes Data Federator qui sert le catalogue
auquel vous vous connectez
Dans l'écran Sélection du middleware de base de données de l'Assistant de connexion, utilisez le
middleware SAP BusinessObjects, Data Federator, Pilotes JDBC ou Pilotes ODBC pour créer la
connexion.
Pour configurer une connexion ODBC au serveur de requêtes Data Federator XI 3.0, vous devez
procéder à quelques configurations supplémentaires. Si vous utilisez Web Intelligence Rich Client, les
changements de configuration requis diffèrent de ceux requis par d'autres applications
SAP BusinessObjects.
8.3 Configuration des connexions ODBC Data Federator
Cette section décrit les paramètres supplémentaires du serveur de requêtes Data Federator XI 3.0 et
les changements à apporter à la configuration de Connection Server pour les connexions ODBC à
toutes les applications SAP BusinessObjects, à l'exception de Web Intelligence Rich Client.
Les informations de configuration de cette section se réfèrent aux chemins suivants :
• rép-install-pilotes-data-federator\OaJdbcBridge : répertoire d'installation racine du
middleware ODBC Data Federator. Votre administrateur a choisi ce répertoire lors de l'exécution
du programme d'installation des pilotes Data Federator.
140
•
rép-install-pilotes-data-federator\JdbcDriver : répertoire d'installation racine du
middleware JDBC Data Federator. Votre administrateur a choisi ce répertoire lors de l'exécution du
programme d'installation de Data Federator.
•
rép-install-bo : répertoire d'installation racine de vos applications SAP BusinessObjects.
2013-09-19
Création d'une connexion au serveur de requêtes Data Federator XI 3.0
Remarque :
Le cas échéant, vous pouvez modifier les fichiers dans un éditeur XML. Après avoir apporté les
modifications présentées ci-dessous à la configuration, vous devez redémarrer le système pour que
les changements prennent effet.
Rubriques associées
• Configuration du middleware ODBC Data Federator
• Configuration du serveur de connexion pour une connexion ODBC Data Federator
8.3.1 Configuration du middleware ODBC Data Federator
Remarque :
Cette rubrique s'applique à toutes les applications SAP BusinessObjects qui utilisent le serveur de
connexion, excepté Web Intelligence Rich Client.
Pour configurer le middleware ODBC Data Federator, vous devez modifier le fichier openrda.ini
situé dans le répertoire suivant :
• rép-install-pilotes-data-federator\OaJdbcBridge\bin\iwinnt
Définissez les paramètres dans la section [JavaIp] comme suit :
•
CLASSPATH=rép-install-pilotes-data-federator\OaJdbcBridge\oajava\oas
ql.jar;rép-install-pilotes-data-federator\JdbcDriver\thindriver.jar;répinstall-bo\SAP BusinessObjects Enterprise XI 4.0\java\lib\ConnectionSer
ver.jar
•
JVM_DLL_NAME=rép-install-bo\javasdk\jre\bin\client\jvm.dll
•
JVM_OPTIONS=-DODBCMode=true -Dbusinessobjects.connectivity.directory=répinstall-bo\SAP BusinessObjects Enterprise XI 4.0\dataAccess\connectionSer
ver
Remarque :
Vérifiez le fichier openrda.ini pour vous assurer que ce chemin n'est pas défini au moyen du
paramètre Djava.endorsed.dirs. Si c'est le cas, vous devez supprimer le chemin du paramètre
Djava.endorsed.dirs.
8.3.2 Configuration du serveur de connexion pour une connexion ODBC Data Federator
141
2013-09-19
Création d'une connexion au serveur de requêtes Data Federator XI 3.0
Remarque :
Cette rubrique s'applique à toutes les applications SAP BusinessObjects qui utilisent le serveur de
connexion, excepté Web Intelligence Rich Client.
Pour configurer le serveur de connexion, modifiez le fichier de configuration : rép-install-connec
tionserver\connectionServer\cs.cfg
Pour configurer le fichier cs.cfg, définissez les paramètres situés sous la balise JavaVM de la manière
suivante :
<ClassPath>
<Path>\\data-federator-drivers-install-dir\\OaJdbcBridge\\oajava\\oasql.jar</Path>
<Path>\\data-federator-drivers-install-dir\\JdbcDriver\\thindriver.jar</Path>
</ClassPath>
8.4 Configuration des connexions Web Intelligence Rich Client à l'aide du
middleware ODBC Data Federator
Si vous créez des connexions Web Intelligence Rich Client utilisant le middleware ODBC Data Federator,
vous devez effectuer les changements de configuration décrits dans cette section. Si la configuration
n'est pas correctement modifiée, la connexion génère des erreurs. Ce type de connexion n'est pris en
charge que par les environnements Windows.
Rappel :
Les détails ci-dessous concernent Web Intelligence Rich Client uniquement.
Pour créer des connexions qui utilisent le middleware ODBC Data Federator, vous devez modifier les
configurations suivantes :
• Middleware ODBC
•
Serveur de connexion
•
Clé de registre RichClient de Windows
Les informations de configuration de cette section se réfèrent aux chemins suivants :
• rép-install-pilotes-data-federator\OaJdbcBridge : répertoire d'installation racine du
middleware ODBC Data Federator. Votre administrateur a choisi ce répertoire lors de l'exécution
du programme d'installation des pilotes Data Federator.
•
rép-install-pilotes-data-federator\JdbcDriver : répertoire d'installation racine du
middleware JDBC Data Federator. Votre administrateur a choisi ce répertoire lors de l'exécution du
programme d'installation de Data Federator.
•
rép-install-bo : répertoire d'installation racine de vos applications SAP BusinessObjects.
Remarque :
Le cas échéant, vous pouvez modifier les fichiers dans un éditeur XML.
142
2013-09-19
Création d'une connexion au serveur de requêtes Data Federator XI 3.0
Rubriques associées
• Configuration du middleware ODBC Data Federator pour une connexion à Web Intelligence Rich
Client
• Configuration du serveur de connexion pour une connexion Web Intelligence Rich Client à
Data Federator
• Définition de la clé de registre Windows RichClient
• Configuration du serveur de connexion pour les connexions de Web Intelligence Rich Client ou de
l'outil de conception d'univers à Data Federator
8.4.1 Configuration du middleware ODBC Data Federator pour une connexion à Web
Intelligence Rich Client
Pour configurer le middleware ODBC Data Federator, vous devez modifier le fichier openrda.ini
situé dans le répertoire suivant :
• rép-install-pilotes-data-federator\OaJdbcBridge\bin\iwinnt
Pour configurer le fichier openrda.ini, définissez les paramètres de la section [JavaIp] comme
suit :
• CLASSPATH=rép-install-pilotes-data-federator\OaJdbcBridge\oajava\oas
ql.jar;rép-install-pilotes-data-federator\JdbcDriver\thindriver.jar;répinstall-bo\SAP BusinessObjects Enterprise XI 4.0\java\lib\ConnectionSer
ver.jar
•
JVM_DLL_NAME=rép-install-bo\javasdk\jre6\bin\client\jvm.dll
Remarque :
Web Intelligence Rich Client nécessite JDK 6.
•
JVM_OPTIONS=-DODBCMode=true -Dbusinessobjects.connectivity.directory=répinstall-bo\SAP BusinessObjects Enterprise XI 4.0\dataAccess\connectionSer
ver
Remarque :
Vérifiez le fichier openrda.ini pour vous assurer que ce chemin n'est pas défini au moyen du
paramètre Djava.endorsed.dirs. Si c'est le cas, vous devez supprimer le chemin du paramètre
Djava.endorsed.dirs.
143
2013-09-19
Création d'une connexion au serveur de requêtes Data Federator XI 3.0
8.4.2 Configuration du serveur de connexion pour une connexion Web Intelligence
Rich Client à Data Federator
Pour configurer Connection Server pour une connexion Web Intelligence Rich Client à Data Federator,
vous devez modifier le fichier de configuration : rép-install-connectionserver\connection
Server\cs.cfg
Pour configurer le fichier cs.cfg, définissez les paramètres situés sous la balise JavaVM de la manière
suivante :
<ClassPath>
<Path>\\data-federator-drivers-install-dir\\OaJdbcBridge\\oajava\\oasql.jar</Path>
<Path>\\data-federator-drivers-install-dir\\JdbcDriver\\thindriver.jar</Path>
</ClassPath>
8.4.3 Définition de la clé de registre Windows RichClient
Pour modifier la clé de registre Windows RichClient, utilisez l'outil regedit, par exemple.
1. Dans le registre, cherchez la clé HKEY_LOCAL_MACHINE\SOFTWARE\SAP
BusinessObjects\Suite XI 4.0\default\WebIntelligence\RichClient.
2. Dans cette clé, ajoutez les valeurs suivantes à classpath. Comme pour toutes les valeurs de clé
de registre, elles doivent être séparées par un point-virgule.
• rép-install-pilotes-data-federator\OaJdbcBridge\oajava\oasql.jar
•
rép-install-pilotes-data-federator\JdbcDriver\thindriver.jar
3. Dans la clé RichClient\JVMOptions, ajoutez la valeur suivante à l'entrée 6 (si 5 entrées existent
déjà) :
•
ODBCMode=true
8.4.4 Configuration du serveur de connexion pour les connexions de Web Intelligence
Rich Client ou de l'outil de conception d'univers à Data Federator
Il est possible d'utiliser une seule configuration pour créer une connexion ODBC à Data Federator à
partir de l'outil de conception d'univers et de Web Intelligence Rich Client. Outre les paramètres de
configuration décrits précédemment, suivez l'une des séries d'instructions ci-dessous :
144
2013-09-19
Création d'une connexion au serveur de requêtes Data Federator XI 3.0
•
Procédez comme suit :
1. Exécutez l'outil regedit.
2. Dans le registre, cherchez la clé HKEY_LOCAL_MACHINE\SOFTWARE\SAP BusinessObje
cts\Suite XI 4.0\default\ConnectionServer\Configuration.
3. Dans cette clé, ajoutez la valeur suivante à l'entrée JVM Library : rép-install-bo\java
sdk\jre6\bin\client\jvm.dll.
•
Procédez comme suit :
1. Ouvrez le fichier cs.cfg pour le modifier.
2. Recherchez la balise JavaVM.
3. Définissez LibraryName sur le chemin de répertoire JVM spécifié dans le fichier openrda.ini :
...
<JavaVM>
<LibraryName JNIVersion="JNI_VERSION_1_4">\\bo-install-dir\\javasdk\\jre6\\bin\\client\\jvm.dll</Li
braryName>
</JavaVM>
Attention :
L'outil de conception d'univers et la passerelle OpenEdge doivent indiquer le même chemin d'accès
au répertoire JVM.
145
2013-09-19
Création d'une connexion au serveur de requêtes Data Federator XI 3.0
146
2013-09-19
Configuration des paramètres globaux d'accès aux données
Configuration des paramètres globaux d'accès aux
données
9.1 A propos des paramètres globaux
Vous pouvez configurer les valeurs des paramètres globaux qui s'appliquent à toutes les connexions.
Vous pouvez ainsi améliorer les performances ou résoudre certains problèmes de connexion.
Les paramètres globaux d'accès aux données se trouvent dans le fichier cs.cfg. Il s'agit du fichier
XML qui contient les paramètres de configuration du serveur de connexion et les paramètres de
configuration par défaut qui s'appliquent à tous les pilotes d'accès aux données.
Pour remplacer ces paramètres globaux, vous pouvez modifier les paramètres dans le fichier de
configuration SBO de chaque pilote.
Rubriques associées
• Configuration des paramètres du pilote
9.2 A propos du fichier de configuration cs.cfg
Dans Microsoft Windows, le fichier cs.cfg est stocké à l'emplacement suivant :
•
rép-install-connectionserver \connectionServer
Dans le fichier cs.cfg, vous pouvez configurer les paramètres des sections suivantes uniquement :
•
Fonctionnalités
Cette section définit les paramètres qui permettent de spécifier l'utilisation du serveur de connexion
local ou distant.
•
Paramètres
Cette section définit les paramètres de configuration globale du serveur de connexion, y compris
les pilotes à charger lors du démarrage en mode Bibliothèque.
•
147
JavaVM
2013-09-19
Configuration des paramètres globaux d'accès aux données
Cette section définit la bibliothèque par défaut de la machine virtuelle Java (JVM) utilisée par la
couche d'accès aux données.
•
Paramètres par défaut du pilote
Cette section définit les paramètres qui s'appliquent à tous les pilotes d'accès aux données. Ils
peuvent être remplacés pour un pilote donné par des paramètres correspondants dans les fichiers
de configuration <pilote>.sbo, où <pilote> est le nom du pilote d'accès aux données auquel
correspond le fichier SBO.
•
Traces
Cette section définit les paramètres qui permettent l'enregistrement de l'activité de connexion via
Connection Server dans des fichiers journaux.
La dernière section, Paramètres régionaux, définit le jeu de caractères du système d'exploitation
pour chaque langue disponible. Vous ne devez pas modifier les paramètres de cette section.
9.3 A propos du fichier de configuration OlapClient.cfg
Dans Microsoft Windows, le fichier OlapClient.cfg est stocké à l'emplacement suivant :
•
rép-install-pbi\win32_x86
Dans le fichier OlapClient.cfg, vous pouvez uniquement configurer les paramètres de la section
OlapClient.
Rubriques associées
• Activation des journaux et des traces pour le client OLAP
9.4 Pour afficher et modifier le fichier cs.cfg
1. Recherchez le répertoire où se trouve le fichier cs.cfg. Par exemple, sous Microsoft Windows :
rép-install-connectionserver\connectionServer\cs.cfg où rép-install-conne
ctionserver est l'emplacement d'installation du logiciel de serveur de connexion.
2. Ouvrez le fichier cs.cfg dans un éditeur XML.
3. Développez les sections concernées.
4. Pour définir les paramètres, ajoutez de nouveaux paramètres et de nouvelles valeurs ou modifiez
les valeurs existantes.
5. Vérifiez que le document est valide par rapport au DTD, puis enregistrez le fichier et fermez-le.
148
2013-09-19
Configuration des paramètres globaux d'accès aux données
Rappel :
Vous devez redémarrer le serveur de connexion après avoir modifié le fichier cs.cfg.
9.5 Configuration des paramètres globaux
La section Paramètres du fichier cs.cfg définit les paramètres qui s'appliquent à l'ensemble des
pilotes et qui ne peuvent pas être personnalisés pour des pilotes individuels d'accès aux données.
Pour afficher ou modifier des paramètres, ouvrez le fichier cs.cfg dans un éditeur XML et allez à la
section Paramètres. Dans le fichier, chaque paramètre est défini dans la balise suivante :
<Parameter Name="parameter">value</Parameter>
où parameter est le nom du paramètre et value est la valeur attribuée au paramètre.
Chaque paramètre figure avec les informations suivantes :
•
Exemple de la façon dont le paramètre apparaît dans le fichier XML
•
Description du paramètre
•
Valeurs possibles qui peuvent être définies pour le paramètre (si applicable)
•
Valeur par défaut pour le paramètre
Remarque :
Certains paramètres peuvent uniquement être modifiés depuis la Central Management Console (CMC).
Pour en savoir plus, reportez-vous au Guide d'administration de la plateforme SAP BusinessObjects
de Business Intelligence.
9.5.1 Charset List Extension
<Parameter Name="CharSet List Extension">crs</Parameter>
Description
Remarque :
Ne modifiez pas ce paramètre.
Définit l'extension des fichiers de jeux de caractères.
Par défaut
149
crs
2013-09-19
Configuration des paramètres globaux d'accès aux données
9.5.2 Config File Extension
<Parameter Name="Config File Extension">sbo</Parameter>
Description
Remarque :
Ne modifiez pas ce paramètre.
Définit l'extension des fichiers de configuration générale.
Par défaut
sbo
9.5.3 Description Extension
<Parameter Name="Description Extension">cod</Parameter>
Description
Remarque :
Ne modifiez pas ce paramètre.
Définit l'extension des fichiers de description des connexions.
Par défaut
cod
9.5.4 Ignore Driver Load Failure
<Parameter Name="Ignore Driver Load Failure">Yes</Parameter>
150
2013-09-19
Configuration des paramètres globaux d'accès aux données
Description
Détermine l'action effectuée en cas d'échec du chargement. Ce paramètre permet de choisir entre une connexion utilisable même si certains
pilotes sont défaillants ou une erreur fatale sans aucune fonctionnalité
si le chargement d'un pilote échoue.
Remarque :
Ce paramètre est ignoré en mode Déploiement du serveur.
Yes : le serveur de connexion génère un message d'avertissement lorsque le chargement d'un pilote échoue.
Valeurs
No : le serveur de connexion génère une erreur fatale si le chargement
d'un pilote échoue.
Par défaut
Yes
Rubriques associées
• Load Drivers On Startup
9.5.5 Load Drivers On Startup
<Parameter Name="Load Drivers On Startup">No</Parameter>
Attention :
Load Drivers On Startup ne s'applique qu'au mode Bibliothèque.
Description
Détermine le mode de chargement des bibliothèques.
•
Yes : tous les pilotes installés sont chargés lors de la phase d'initialisation.
•
No : les pilotes sont chargés à la demande.
Valeurs
Par défaut
151
No
2013-09-19
Configuration des paramètres globaux d'accès aux données
9.5.6 Max Pool Time
<Parameter Name="Max Pool Time">-1</Parameter>
Attention :
Max Pool Time est disponible pour le mode Bibliothèque uniquement.
Vous pouvez changer le délai d'expiration de la connexion pour le mode Serveur sur le page "Propriétés"
du serveur dans la CMC. Voir le Guide d'administration de la plateforme SAP BusinessObjects Business
Intelligence. La valeur s'applique aux installations du serveur de connexion de type serveur autonome.
Pour en savoir plus sur le déploiement du serveur de connexion sur un nœud dédié, voir le Guide de
planification de la plateforme SAP BusinessObjects Business Intelligence.
Description
Détermine la période de temps maximale pendant laquelle une connexion peut rester inactive dans le pool de connexions. Il s'agit d'une
limite supérieure pour les durées de vie des connexions. Un pool de
connexions est un mécanisme utilisé par les pilotes d'accès aux données
pour réutiliser les connexions à la base de données afin de tirer le
meilleur parti des ressources système.
Vous pouvez définir Max Pool Time uniquement pour le mode de
déploiement Bibliothèque. La valeur s'applique aux nœuds où le serveur
de connexion est installé avec des produits serveurs.
-1 : pas de délai d'expiration, la connexion est maintenue pendant toute
la durée de la session.
Valeurs
0 : connexion non gérée par le pool.
>0 : durée d'inactivité (en minutes).
Par défaut
-1
Rubriques associées
• Pools de connexions
9.5.7 Configuration de l'extension de fichier
152
2013-09-19
Configuration des paramètres globaux d'accès aux données
<Parameter Name="Setup File Extension">setup</Parameter>
Description
Par défaut
Remarque :
Ne modifiez pas ce paramètre.
Définit l'extension des fichiers de configuration du pilote d'accès aux
données.
setup
9.5.8 SQL External Extension
<Parameter Name="SQL External Extension">rss</Parameter>
Description
Remarque :
Ne modifiez pas ce paramètre.
Définit l'extension des fichiers SQL externes.
Par défaut
rss
9.5.9 SQL Parameter Extension
<Parameter Name="SQL Parameter Extension">prm</Parameter>
Description
Remarque :
Ne modifiez pas ce paramètre.
Définit l'extension des fichiers de paramètres SQL.
Par défaut
153
prm
2013-09-19
Configuration des paramètres globaux d'accès aux données
9.5.10 Strategies Extension
<Parameter Name="Strategies Extension">stg</Parameter>
Description
Remarque :
Ne modifiez pas ce paramètre.
Définit l'extension des fichiers de stratégie.
Par défaut
stg
9.5.11 Validate Configuration Files
<Parameter Name="Validate Configuration Files">No</Parameter>
Déclenche la validation des fichiers de configuration (SBO, COD et
PRM) par rapport au schéma XML.
Description
Remarque :
Vous pouvez uniquement valider les fichiers de configurations en utilisant les connectivités basées sur Java.
Par défaut
No
9.5.12 Validation des flux XML
<Parameter Name="Validate XML Streams">No</Parameter>
154
2013-09-19
Configuration des paramètres globaux d'accès aux données
Déclenche la validation des flux XML analysés dans l'implémentation
de Connection Server par rapport au schéma XML (par exemple : définition de connexion).
Description
Par défaut
Remarque :
Vous pouvez uniquement valider les flux en utilisant les connectivités
basées sur Java.
No
9.6 Définition du mode de déploiement
La section Capabilities permet de spécifier le mode de déploiement du Connection Server à utiliser
au moment de l'exécution.
Sous la section Capabilities, le nom Local signifie que les services de connectivité sont fournis
en local, en tant que bibliothèque en cours intégrée dans le processus client. Le nom Distant signifie
que le serveur de connexion est fourni sur un serveur distant.
Vous pouvez activer ces modes de déploiement indépendamment en définissant l'attribut Actif.
L'attribut EnableJNI est spécifique à la fonctionnalité Local et permet d'utiliser Java Native Interface
(JNI).
Remarque :
Une JNI bidirectionnelle incorporée dans le serveur de connexion permet aux API d'utiliser le noyau
du serveur de connexion développé dans une autre langue. Cela signifie que vous pouvez vous servir
de l'API Java pour utiliser le noyau natif et inversement.
Exemple : Valeurs par défaut
La configuration suivante permet d'utiliser le mode de déploiement Bibliothèque avec JNI et le mode
de déploiement serveur.
<Capabilities>
<Capability Name="Local" EnableJNI="Yes" Active="Yes"/>
<Capability Name="Remote" Active="Yes"/>
</Capabilities>
Exemple : Serveur de connexion en mode serveur
La configuration suivante vous permet d'utiliser le serveur de connexion en mode serveur uniquement.
<Capabilities>
<Capability Name="Local" EnableJNI="Yes" Active="No"/>
155
2013-09-19
Configuration des paramètres globaux d'accès aux données
<Capability Name="Remote" Active="Yes"/>
</Capabilities>
Dans ce mode, seuls les pilotes installés sur le système backend de la plateforme de BI peuvent être
utilisés pour créer des connexions.
Si une instance de serveur est en cours d'exécution, vous pouvez créer une connexion locale basée
sur un pilote installé sur le système backend de la plateforme. Si vous arrêtez l'instance de serveur,
vous ne pourrez créer aucune connexion, car ce paramètre ne vous permet pas d'utiliser un pilote
installé sur l'ordinateur client.
Rubriques associées
• Services de connectivité
9.7 Configuration du mode de déploiement
Les paramètres définis dans la section Settings du fichier cs.cfg contrôlent le mode de déploiement.
Mode Bibliothèque
Les paramètres de la section <Library> contrôlent le mode bibliothèque.
Mode serveur
Vous gérez ce mode depuis la CMC de votre installation SAP BusinessObjects Enterprise. Les
paramètres affichés sur la page "Propriétés" du serveur contrôlent l'accès CORBA. Pour en savoir plus,
voir le Guide d'administration de la plateforme SAP BusinessObjects Business Intelligence.
9.8 Configuration des pilotes à charger
Par défaut, le serveur de connexion charge tous les pilotes disponibles. Vous pouvez toutefois
sélectionner les sources de données devant être fournies par le serveur de connexion.
Mode bibliothèque
Retirez les commentaires de la section ActiveDataSources sous Bibliothèque dans le fichier
cs.cfg et spécifiez les couches réseau et les bases de données à charger. Par exemple :
<Library>
<ActiveDataSources>
<NetworkLayer Name="ODBC">
<DataBase Name="MS SQL Server.*$"/>
</NetworkLayer>
<NetworkLayer Name="Oracle OCI">
<DataBase Name="Oracle 10"/>
</NetworkLayer>
156
2013-09-19
Configuration des paramètres globaux d'accès aux données
</ActiveDataSources>
</Library>
Remarque :
Les noms de bases de données peuvent être des expressions régulières à condition d'être des chaînes
ASCII pures. Les formats utilisent la syntaxe GNU regexp. Utilisez le format .* pour remplacer un
caractère quelconque. Pour en savoir plus sur les expressions régulières, voir le site Web PERL, à
l'adresse http://www.perl.com/doc/manual/html/pod/perlre.html#Regular_Expressions.
Mode serveur
Sélectionnez les sources de données dans la section Sources de données actives des propriétés du
serveur dans la CMC.
Attention :
Pour éviter les échecs de connexion, vous devez vous assurer que votre environnement fournit tous
les middlewares nécessaires ou vous devez définir les couches réseau et les bases de données dont
vous avez besoin dans la section Sources de données actives.
Grâce à la spécialisation de serveur, ce paramétrage permet d'aborder les scénarios de déploiement
complexe impliquant plusieurs serveurs de connexion en mode Serveur. Pour en savoir plus sur les
scénarios de déploiement complexes, voir le Guide d'administration de la plateforme SAP
BusinessObjects Business Intelligence.
9.8.1 Définition d'une connectivité par ordinateur
Dans le cas de scénarios de déploiement complexes, vous pouvez être amené à configurer une
connectivité par type d'ordinateur, par exemple, pour connecter des applications incluses dans la
plateforme de BI à une base de données MS SQL Server installée sous Microsoft Windows et à une
base de données Oracle installée sur un ordinateur UNIX.
Pour éviter les échecs de connexion, vous devez choisir l'une des options suivantes :
•
Si vous effectuez une installation personnalisée de la plateforme de BI, indiquez les connectivités
à déployer pour chaque type de base de données requis. Vous effectuez cela quand vous
sélectionnez des fonctionnalités à installer.
•
Lors de la configuration du serveur de connexion dans le fichier cs.cfg, définissez la section Ac
tiveDataSources sur le mode Bibliothèque (élément parent Bibliothèque) comme vous le
faites pour le mode Serveur dans la CMC. Etant donné que les applications tentent d'abord d'établir
des connexions via des pilotes installés localement, vous devez configurer de la même façon le
filtre de pilote pour les deux modes.
9.9 Configuration des protocoles d'accès CORBA
157
2013-09-19
Configuration des paramètres globaux d'accès aux données
Pour définir les protocoles d'accès CORBA, vous devez utiliser la CMC de votre installation de la
plateforme de BI. Les protocoles définissent des valeurs que le serveur de connexion utilise pour traiter
les requêtes émanant de clients CORBA ou de clients HTTP.
Pour en savoir plus sur la CMC, voir le Guide d'administration de la plateforme SAP BusinessObjects
Business Intelligence.
9.10 Activation des journaux et des traces des pilotes et du serveur de connexion
SAP fait la distinction entre deux types de messages :
•
•
Un message de trace analyse le système en détail du point de vue d'un développeur en tant que
procédure exceptionnelle.
Un message de journal est un enregistrement permanent des événements et du statut d'un système.
Les messages de journaux et de traces sont respectivement destinés aux administrateurs et aux
développeurs. Vous pouvez activer des journaux et des traces pour toutes les connectivités prises en
charge par la couche d'accès aux données (exemple : ODBC, JDBC, Javabean, OLE DB, OCI et JCo).
Le processus de journalisation et de suivi du serveur de connexion s'appuie sur le service de
journalisation et de suivi du journal de suivi SAP BusinessObjects. Il permet de journaliser et de suivre
les processus suivants :
Historiques
•
•
•
Démarrage et arrêt des instances du serveur de connexion
Initialisation de la connexion unique
Chargement du pilote
Traces
•
•
•
•
•
•
Configuration et initialisation du serveur de connexion
Création et exécution des travaux et du dictionnaire
Chargement et activité du pilote
Démarrage et arrêt des instances du serveur de connexion
Initialisation et activité des services des instances du serveur de connexion
Initialisation de la connexion unique
9.10.1 A propos du fichier de configuration _trace.ini
Les niveaux de journalisation et de suivi sont définis dans le fichier de configuration _trace.ini. Par
exemple, vous pouvez définir les informations suivantes dans le fichier BO_trace.ini :
sap_log_level = log_info;
sap_trace_level = trace_debug;
158
2013-09-19
Configuration des paramètres globaux d'accès aux données
if
(process == "cms")
{
log_level = error; // but only log errors for the CMS
}
Contenu du fichier
Dans l'exemple ci-dessus, les balises définies sont les suivantes :
•
•
•
sap_log_level, qui définit le niveau de journalisation
sap_trace_level, qui définit le niveau de suivi
Une partie de code pour spécifier le niveau de journalisation ou de suivi d'un processus. Il s'agit
d'un code C ou Java qui peut contenir des expressions, des instructions simples et des instructions
if-else.
Les tableaux suivants décrivent les valeurs de configuration acceptées par les balises sap_log_level
et sap_trace_level.
Tableau 9-14 : Niveau de journalisation SAP
Gravité
Valeurs de configuration
INFO
log_info ou log_information
AVERTISSEMENT
log_warn ou log_warning
ERROR
log_error
FATAL
log_fatal
AUCUNE
log_none
Tous les messages du niveau de gravité défini et de niveau supérieur apparaissent dans le fichier
journal. Par exemple, si vous définissez la gravité du journal sur WARNING, tous les messages
possédant un niveau de type WARNING, ERROR et FATAL sont journalisés. Le niveau de gravité par
défaut est ERROR.
Tableau 9-15 : Niveau de traçage SAP
159
Gravité
Valeurs de configuration
DEBUG
trace_debug
PATH
trace_path
2013-09-19
Configuration des paramètres globaux d'accès aux données
Gravité
Valeurs de configuration
INFO
trace_info ou trace_information
ERROR
trace_error
AUCUNE
trace_none
Tous les messages du niveau de gravité défini et de niveau supérieur apparaissent dans le fichier
journal. Par exemple, si vous définissez la gravité du traçage sur INFO, tous les messages de niveau
INFO et ERROR sont journalisés. Le niveau de gravité de traçage par défaut est ERROR.
Options de configuration
Il est également possible d'ajouter les options suivantes au fichier :
160
Option
Valeurs
Description
always_close
true ou
false
Ferme le fichier journal après chaque écriture.
La valeur par défaut est false.
append
true ou
false
Ajoute les informations du journal aux fichiers
journaux existants. Modifie le modèle d'attribution
de nom pour exclure le PID et l'horodatage, et
utilise à la place un nombre de fichiers journaux
variable. La valeur par défaut est false.
keep_num
un nombre entier
Spécifie le nombre de fichiers journaux à conserver. La valeur par défaut est 0. Un nombre entier
négatif signifie que tous les fichiers journaux sont
conservés.
log_dir
une chaîne
Spécifie le répertoire du fichier journal. La valeur
par défaut est la valeur de la variable d'environnement BO_TRACE_LOGDIR. Un tiret (-) signifie
que les informations du journal sont dirigées vers
stdout.
log_level
none, low, me
dium ou high
Définit un raccourci pour spécifier les valeurs
sap_log_level et sap_trace_level. Reportez-vous au tableau suivant.
2013-09-19
Configuration des paramètres globaux d'accès aux données
Option
scope_only
size
Valeurs
true ou
false
un nombre en
Ko
Description
Spécifie si seuls les messages avec périmètres
apparaissent dans les fichiers journaux. La valeur
par défaut est false.
Remarque :
Un périmètre marque l'entrée et la sortie d'un
bloc de code.
Taille maximale d'un fichier journal. La valeur par
défaut est 10000.
Valeurs d'option log_level
Le tableau suivant fournit l'ensemble des valeurs sap_log_level et sap_trace_level lorsque la
valeur log_level correspondante est définie dans le fichier de configuration.
Valeur log_level
Valeur sap_log_level
Valeur sap_trace_level
aucun
log_error
trace_error
low
log_error
trace_info
medium
log_warn
trace_path
high
log_info
trace_debug
Erreurs d'analyse
Les erreurs et avertissements qui peuvent survenir lors de l'analyse du fichier _trace.ini sont
journalisés dans le fichier ERR, situé dans le même répertoire que le fichier INI. Le nom du fichier
d'erreurs porte le nom du fichier INI.
Si le même fichier INI est partagé par plusieurs processus, il est impossible de déterminer quel
processus génère l'erreur. Pour générer des noms de fichier d'erreur plus explicites, ajoutez les lignes
suivantes en haut du fichier _trace.ini :
error_file = config_file + "_" + process + ".err";
output_file = config_file + "_" + process + ".out";
161
2013-09-19
Configuration des paramètres globaux d'accès aux données
9.10.2 Activation des journaux et des traces dans le fichier cs.cfg
Vous trouverez les journaux et traces du serveur de connexion avec ceux des applications SAP
BusinessObjects, telles que SAP BusinessObjects Web Intelligence. Il est également possible de créer
des journaux et traces du serveur de connexion séparément en configurant le fichier cs.cfg.
La section Traces du fichier vous permet d'activer des traces pour les pilotes et travaux du serveur
de connexion. Pour activer les traces de travail, définissez l'attribut Active de Job et JobLevel sur
Yes. Pour activer des traces de pilotes, définissez l'attribut Actif du Middleware sur Oui. Pour activer
les traces d'un pilote spécifique, définissez l'attribut Actif du pilote concerné sur Oui.
Exemple : Valeurs par défaut
<Traces Active="Yes">
<Logger Implementation="C" ClassID="csTRACELOG">
<Logger Implementation="Java" ClassID="com.sap.connectivity.cs.logging.TraceLogLogger"/>
<Trace Name="JobLevel" Active="Yes">
<Trace Name="Job" Active="Yes"/>
</Trace>
<Trace Name="MiddleWare" Active="Yes">
<Trace Name="Oracle" Active="Yes"/>
<Trace Name="Sybase" Active="Yes"/>
<Trace Name="DB2" Active="Yes"/>
...
<Trace Name="JCO" Active="Yes"/>
<Trace Name="BO OC" Active="Yes"/>
</Trace>
</Traces>
Cette configuration permet par défaut la journalisation et le suivi du serveur de connexion et des
pilotes.
9.10.3 Pour activer les journaux et les traces en mode Bibliothèque
1. Redémarrez le serveur de connexion.
2. Créez et définissez des valeurs pour les variables d'environnement suivantes :
• BO_TRACE_CONFIGDIR pour définir le nom du dossier des fichiers de configuration, par exemple :
C:\BOTraces\config
• BO_TRACE_CONFIGFILE pour définir le nom du fichier de configuration, par exemple :
BO_trace.ini
• BO_TRACE_LOGDIR pour définir le nom du dossier des journaux, par exemple : C:\BOTraces
Remarque :
Ces variables d'environnement sont généralement utilisées pour configurer le traçage de toute
l'activité de la plateforme de BI.
162
2013-09-19
Configuration des paramètres globaux d'accès aux données
3. Créez le fichier de configuration BO_trace.ini comme suit :
sap_log_level = log_info;
sap_trace_level = trace_debug;
Remarque :
Le nom du fichier INI est sensible à la casse.
4. Ajoutez les chemins du répertoire logging.jar et tracelog.jar à la variable d'environnement
CLASSPATH.
Par exemple : C:\BOTraces\lib\logging.jar et C:\BOTraces\lib\tracelog.jar.
5. Redémarrez le serveur de connexion.
Les journaux et traces sont écrits dans un fichier dont le nom par défaut est TraceLog_<idp>_<ho
rodatage>_trace.log. Si vous souhaitez définir un autre nom pour le fichier journal, mettez à jour
la variable d'environnement BO_TRACE_PROCESS avec le nouveau nom.
9.10.4 Pour activer les journaux et les traces en mode Serveur
Les traces des travaux et des pilotes doivent être activées depuis la CMC. Cela permet d'exécuter le
serveur tout en activant les traces.
1. Démarrez la CMC.
2. Allez à la page Propriétés du serveur de connexion (pour le service de connectivité natif) ou de
l'Adaptive Processing Server (pour l'Adaptive Connectivity Service).
3. Dans la section "Suivi de niveau inférieur", sélectionnez :
• Activer le suivi des travaux pour activer les traces des travaux
• Activer le suivi du middleware pour activer les traces du middleware
Remarque :
Le niveau du Journal de suivi doit être défini sur Elevé dans la section "Service de journal de
suivi". Ce niveau est différent du niveau de journalisation SAP défini dans le fichier BO_Trace.ini.
Rappel :
Le paramètre Activer le suivi du middleware vous permet de tracer tous les middlewares. Pour
suivre uniquement des middleware spécifiques, vous devez configurer le fichier cs.cfg et redémarrer
le serveur.
9.10.5 Lecture des journaux et des traces
Les traces et journaux du serveur de connexion sont marqués à l'aide de |CS| dans les fichiers de
suivi. Les journaux du serveur de connexion sont également identifiés par la mention THIS IS A
LOG. Chaque fonction a sa propre trace. Les traces contiennent les informations suivantes :
163
2013-09-19
Configuration des paramètres globaux d'accès aux données
•
•
•
•
•
•
Traces ENTER, qui identifient l'appel d'API du middleware. Traces EXIT qui identifient l'appel renvoyé.
L'API du middleware ne renvoie aucun appel s'il n'existe aucune trace EXIT après ENTER.
Exceptions d'appels, si |E| est affiché
Erreurs API, si le code erreur -1 est affiché
Gravité de journal ou d'erreur (par exemple : Debug, Path ou Information)
Base de données et couche réseau suivies dans la section [Network Layer|Database|ID] de
la trace
Messages d'erreur et de journal
Exemple : Trace
Voici un extrait d'une trace contenant les gravités DEBUG et PATH obtenues lorsque le serveur de
connexion était utilisé en mode bibliothèque :
|BE42CC9D40484416BADEF01039652F620|2012 04 12 11:41:27.422|+0200|Debug| |<<| | |TraceLog| 5256|
| ||||||||||||||||||||CS||[unknown|unknown|ID:0]CS Internal Configuration:
|BE42CC9D40484416BADEF01039652F621|2012 04 12 11:41:27.534|+0200|Debug| |<<| | |TraceLog| 5256|
| ||||||||||||||||||||CS||[unknown|unknown|ID:0]
1|main
1|main
...
|BE42CC9D40484416BADEF01039652F628|2012 04 12 11:41:27.920|+0200|Path| | | | |TraceLog| 5256|
1|main
| ||||||||||||||||||||CS||ENTER [JDBC|Oracle 11|ID:0]com.sap.connectivity.cs.java.ConnectionMana
ger{com.businessobjects.connectionserver.ConnectionManager}.close
|BE42CC9D40484416BADEF01039652F629|2012 04 12 11:41:27.920|+0200|Path| | | | |TraceLog| 5256|
1|main
| ||||||||||||||||||||CS||EXIT [JDBC|Oracle 11|ID:0]com.sap.connectivity.cs.java.ConnectionMana
ger{com.businessobjects.connectionserver.ConnectionManager}.close
Exemple : Trace
Voici un extrait d'une trace contenant la gravité INFO obtenue lorsque le serveur de connexion était
utilisé en mode serveur :
|6E606102224D49849A2C17D8691FAC785011|2012 04 26 19:02:43.075|+0200|Information| |==| | |aps_MySIA.csjava|
7088| 53|service builder-4| ||||||||||||||||||||CS||[unknown|unknown|ID:0]Starting CORBA NetworkLayer
service...
Exemple : Log
Voici un extrait de journal obtenu lorsque le serveur de connexion était utilisé en mode serveur :
|6E606102224D49849A2C17D8691FAC7B5114|2012 04 26 19:02:43.805|+0200| |Information| | | |aps_MySIA.csjava|
7088| 61|service builder-1| ||||||||||||||||||||CS||THIS IS A LOG [unknown|unknown|ID:0]Loaded driver:
NetworkLayer=JDBC, Database=Generic JDBC datasource
|6E606102224D49849A2C17D8691FAC7B5116|2012 04 26 19:02:43.817|+0200| |Information| | | |aps_MySIA.csjava|
7088| 61|service builder-1| ||||||||||||||||||||CS||THIS IS A LOG [unknown|unknown|ID:0]Loaded driver:
NetworkLayer=JDBC, Database=MaxDB 7.7
...
|43eabdad-d3e4-ec14-89aa-0c9a9fba3101|2012 04 26 19:02:20:883|+0200| |Information| | | |connectionserver_My
SIA.ConnectionServer|1576|7816|| |0|94|0|2|-|-|-|-|-|-||||||||||CS||THIS IS A LOG [unknown|unknown|ID:0]Co
nnectionServer is now started
9.11 Activation des journaux et des traces pour le client OLAP
164
2013-09-19
Configuration des paramètres globaux d'accès aux données
Vous trouverez les journaux et traces du client OLAP avec ceux des applications SAP BusinessObjects,
telles que SAP BusinessObjects Web Intelligence. Vous pouvez par exemple les trouver avec les traces
du serveur de traitement Web Intelligence. Il est également possible de créer un journal et une trace
du client OLAP séparément en configurant le fichier OlapClient.cfg.
Vous activez les journaux en définissant l'attribut UseLog sur yes dans la section OlapClient du
fichier. Vous spécifiez le chemin du fichier journal dans l'attribut LogFileName. Vous ne devez pas
modifier la valeur UseProcessName.
Il n'est pas nécessaire d'arrêter le serveur de traitement Web Intelligence pour modifier ces paramètres.
Vous pouvez cependant activer les journaux et traces lorsqu'il est en cours d'exécution.
Exemple :
[OlapClient]
UseLog =yes
UseProcessName=false
LogFileName =c:\OlapClient.log
; Factory Mode can be: Lib (inproc) or Proxy (Remoting)
FactoryMode=Lib
...
Cette configuration permet la journalisation et le suivi pour le client OLAP.
Rubriques associées
• A propos du fichier de configuration OlapClient.cfg
9.11.1 Exemple de journal
L'exemple du fichier journal suivant est un extrait de fichier journal pour le client OLAP obtenu pour
une connexion MSAS.
...
[2012/11/05 - 12:04:54:025][0] XmlaConnectionWinhttp::XmlaConnectionWinhttp() -> Using Windows HTTP Services
version 6.1.7600.16385
[2012/11/05 - 12:04:54:025][0] HTTPClient::connect() -> Using direct access
[2012/11/05 - 12:04:54:040][0] HTTPClient::connect() -> Using Windows Proxy Automatic Discovery (WPAD)
[2012/11/05 - 12:04:54:040][0] HTTPClient::connect() -> Using proxy settings: WPAD url=http://proxy:8083,
Proxy= ProxyBypass=
[2012/11/05 - 12:04:54:040][0] HTTPClient::connect() -> Connecting using WinHttpConnect(): Hostname='olapwxp' Port=80
[2012/11/05 - 12:04:54:040][0] XmlaConnectionWinhttp::Open() -> Connected.
[2012/11/05 - 12:04:54:040][0] XmlaClient::discover() Call 'DISCOVER_DATASOURCES'...
[2012/11/05 - 12:04:54:040][0] SoapEnvelope::updateProperties() BeginRange=-1 EndRange=-1
[2012/11/05 - 12:04:54:040][0] XmlaConnectionWinhttp::SendRequest() Authentication Mode = Credentials.
[2012/11/05 - 12:04:54:040][0] XmlaConnectionWinhttp::SendRequest() Setting basic credential to HttpRequest.
[2012/11/05 - 12:04:54:040][0] XmlaConnection::getTimeout() No timeout was specified in ConnectionSpecifica
tion, defaulting to 100(s).
[2012/11/05 - 12:04:54:056][0] XmlTextReader::XmlTextReader() Using libXML version 2.06.32
[2012/11/05 - 12:04:54:056][0] XmlaClient::discover() Rowset contains 1 rows
[2012/11/05 - 12:04:54:056][0] XmlaClient::discover() Call 'DISCOVER_DATASOURCES' ElapseTime=15ms
[2012/11/05 - 12:04:54:056][0] XmlaClient::createOlapEntities() -> Rowset=[DISCOVER_DATASOURCES], 1 entities
retrieved Elapse=15ms
[2012/11/05 - 12:04:54:056][0] XmlaClient::discover() Call 'DISCOVER_SCHEMA_ROWSETS'...
[2012/11/05 - 12:04:54:072][0] SoapEnvelope::updateProperties() BeginRange=-1 EndRange=-1
[2012/11/05 - 12:04:54:072][0] XmlaConnectionWinhttp::SendRequest() Authentication Mode = Credentials.
[2012/11/05 - 12:04:54:072][0] XmlaConnectionWinhttp::SendRequest() Setting basic credential to HttpRequest.
165
2013-09-19
Configuration des paramètres globaux d'accès aux données
[2012/11/05 - 12:04:54:072][0] XmlaConnection::getTimeout() No timeout was specified in ConnectionSpecifica
tion, defaulting to 100(s).
[2012/11/05 - 12:04:54:072][0] XmlTextReader::XmlTextReader() Using libXML version 2.06.32
[2012/11/05 - 12:04:54:072][0] XmlaClient::discover() Rowset contains 54 rows
...
166
2013-09-19
Configuration des paramètres du pilote d'accès aux données
Configuration des paramètres du pilote d'accès aux
données
10.1 Configuration des paramètres du pilote
Pour configurer l'accès aux données pour un pilote spécifique, vous pouvez soit modifier les fichiers
de configuration du pilote pour ajuster les paramètres, soit créer vos propres entrées de base de
données si vous avez besoin de connexions pour des bases de données spécifiques de votre
environnement.
Remarque :
Le fichier Readme associé à chaque application SAP BusinessObjects utilisant le serveur de connexion
contient des informations sur les utilitaires de ligne de commande qui permettent de vérifier la
configuration du pilote d'accès aux données et du SGBDR. Ces utilitaires peuvent créer des fichiers
journaux qui tracent l'activité du serveur d'analyse interactive. Consultez le fichier Readme de cette
version pour obtenir des instructions sur l'utilisation de ces utilitaires.
Rubriques associées
• A propos des paramètres globaux
10.1.1 Fichiers de configuration d'accès aux données
Les fichiers de configuration suivants contrôlent la configuration du pilote d'accès aux données de
chacune des connexions définies :
•
cs.cfg
Le fichier définit les paramètres globaux qui s'appliquent à toutes les connexions. Il se trouve dans
le répertoire rép-install-connectionserver\connectionServer.
•
<pilote>.sbo
Ce fichier est spécifique à chaque pilote d'accès aux données. L'espace réservé <pilote>
correspond à la source de données à laquelle s'applique le fichier de configuration. Chaque fichier
SBO se trouve dans un sous-répertoire du répertoire connectionServer, où le sous-répertoire
est désigné sous le nom du middleware ou de la couche réseau de la base de données par exemple.
167
2013-09-19
Configuration des paramètres du pilote d'accès aux données
rép-install-connectionserver\connectionServer\oracle pour les bases de données
Oracle.
Remarque :
Les paramètres définis dans la section DriverDefaults de cs.cfg sont remplacés par les
paramètres correspondants dans les fichiers SBO.
•
<pilote>.setup
Ce fichier définit le nom du fichier SBO, le répertoire et le middleware ou la couche réseau de la
base de données associés au pilote. Ce fichier est nécessaire pour pouvoir utiliser le pilote. Un
pilote sans fichier de configuration ne peut pas être utilisé. Tous les fichiers se trouvent dans le
répertoire rép-install-connectionserver\connectionServer\setup.
Par exemple, le fichier oracle_jdbc.setup ci-après définit le fichier de configuration oracle.sbo
pour les pilotes d'accès aux données Oracle utilisés pour établir les connexions JDBC :
...
<Driver>
<NetworkLayer Name="JDBC"></NetworkLayer>
<Directory>jdbc</Directory>
<DataFileName>oracle</DataFileName>
</Driver>
...
Rubriques associées
• A propos des paramètres globaux
• Fichiers SBO installés
10.1.2 Fichiers SBO installés
Les fichiers <pilote>.sbo suivants sont installés par défaut sous Microsoft Windows.
Pour obtenir la liste la plus récente des pilotes pris en charge, visitez le site Web
SAP Service Marketplace à l'adresse service.sap.com/bosap-support ou contactez votre représentant
SAP.
168
Sous-répertoire
Technologie de bases de données
Fichier SBO
db2
IBM DB2
db2.sbo
essbase
Oracle Essbase
essbase.sbo
2013-09-19
Configuration des paramètres du pilote d'accès aux données
169
Sous-répertoire
Technologie de bases de données
Fichier SBO
javabean
Javabean
javabean.sbo
jco
SAP ERP
jco.sbo
2013-09-19
Configuration des paramètres du pilote d'accès aux données
Sous-répertoire
jdbc
170
Technologie de bases de données
Fichier SBO
Serveur Data Federator
datafederator.sbo
IBM DB2
db2.sbo
Derby
derby.sbo
Greenplum et PostgreSQL
greenplum.sbo
HIVE
hive.sbo
HSQLDB
hsqldb.sbo
IBM Informix
informix.sbo
Ingres
ingres.sbo
Generic JDBC
jdbc.sbo
MaxDB
maxdb.sbo
MySQL
mysql.sbo
HP Neoview
neoview.sbo
Netezza
netezza.sbo
SAP HANA
newdb.sbo
Oracle
oracle.sbo
Microsoft SQL Server
sqlsrv.sbo
Sybase
sybase.sbo
2013-09-19
Configuration des paramètres du pilote d'accès aux données
Sous-répertoire
odata
171
Technologie de bases de données
Fichier SBO
Teradata
teradata.sbo
OData 2.0
odata.sbo
2013-09-19
Configuration des paramètres du pilote d'accès aux données
Sous-répertoire
odbc
172
Technologie de bases de données
Fichier SBO
MS Access 2007
access.sbo
MS Access 2010 et 2013
access2010.sbo
Serveur Data Federator
datafederator.sbo
IBM DB2 iSeries
db2iseries.sbo
PostgreSQL 8
greenplum.sbo
Greenplum 4 et PostgreSQL 9
greenplum4.sbo
IBM Informix
informix.sbo
Ingres
ingres.sbo
MaxDB
maxdb.sbo
MS Excel 2007
msexcel.sbo
MySQL
mysql.sbo
HP Neoview
neoview.sbo
Netezza
netezza.sbo
SAP HANA
newdb.sbo
Generic ODBC et Generic ODBC3
odbc.sbo
OpenAccess pour Salesforce
openaccess.sbo
MS Excel 2010, 2013 et fichiers texte
personalfiles.sbo
2013-09-19
Configuration des paramètres du pilote d'accès aux données
Sous-répertoire
Technologie de bases de données
Fichier SBO
Microsoft SQL Server
sqlsrv.sbo
Sybase
sybase.sbo
Teradata
teradata.sbo
Generic OLE DB
oledb.sbo
Microsoft SQL Server
sqlsrv.sbo
oledb_olap
Microsoft Analysis Services
slqsrv_as.sbo
open
Fichiers CSV
open.sbo
Oracle
oracle.sbo
Oracle EBS
oracle_ebs.sbo
sap
SAP BW
sap.sbo
sybase
Sybase
sybase.sbo
XML
xml.sbo
Services Web
webservices.sbo
oledb
oracle
xml
Le sous-répertoire jdbc contient des fichiers de configuration pour gérer les connexions aux bases de
données via la couche réseau JDBC. Consultez le site Web de SAP Service Marketplace ou la série
des fichiers SBO afin d'en savoir plus sur les bases de données prises en charge pour les connexions
JDBC.
Le sous-répertoire odbc contient le fichier de configuration mysql.sbo pour gérer les connexions à
la base de données MySQL via la couche réseau ODBC. La base de données MySQL 5 est disponible
sur toutes les plateformes, avec une prise en charge Unicode. Assurez-vous que vous utilisez
MySQL Connector/ODBC 5.1.4 ou version ultérieure pour vous connecter à cette base de données.
173
2013-09-19
Configuration des paramètres du pilote d'accès aux données
Si vous utilisez une version antérieure du pilote sous Unix, vous rencontrerez des erreurs au moment
de l'exécution.
Le sous-répertoire odbc contient les fichiers de configuration greenplum4.sbo et access2010.sbo
pour gérer les connexions à Greenplum 4 et PostgreSQL 9 d'une part, et MS Access 2010 et 2013
d'autre part, via la couche réseau ODBC. Ces fichiers sont différents des fichiers greenplum.sbo et
access.sbo car ils déploient la configuration à la fois sur MS Windows 32 bits et 64 bits. Les bases
de données Greenplum 4 et PostgreSQL 9 sont également disponibles sur les versions UNIX 64 bits.
Le sous-répertoire odbc contient également le fichier de configuration msexcel.sbo pour gérer les
connexions à MS Excel 2007 via la couche réseau ODBC. Ce fichier déploie la configuration sur MS
Windows 32 bits uniquement. Le fichier de configuration personalfiles.sbo déploie la configuration
pour MS Excel 2010 et 2013 via ODBC à la fois sur MS Windows 32 bits et 64 bits.
Le sous-répertoire open contient le fichier de configuration open.sbo pour gérer les connexions aux
fichiers CSV via CSV OpenDriver. Lorsque vous développez un pilote CSV sur l'exemple du pilote CVS
Open à l'aide du Driver Development Kit de Java, vous devez placer tous vos fichiers de configuration
dans ce répertoire. Pour en savoir plus sur ce pilote, consultez le guide Data Access Driver Java SDK
Developer Guide.
10.1.3 Pour afficher et modifier les fichiers SBO
Attention :
Avant d'ouvrir un fichier SBO, faites une copie de sauvegarde. Certains paramètres de configuration
ne doivent pas être modifiés. Si vous modifiez ou supprimez ces paramètres, vous risquez de provoquer
un dysfonctionnement des applications SAP BusinessObjects.
1.
2.
3.
4.
Placez-vous dans le répertoire qui contient le fichier SBO du pilote d'accès aux données cible.
Ouvrez le fichier SBO dans un éditeur XML.
Développez les sections concernées.
Recherchez la balise correspondant à la valeur à modifier et faites les modifications nécessaires.
Le format des paramètres est le suivant : <Parameter Name="parameter">value</Parameter>
où parameter est le nom du paramètre et value est la valeur attribuée au paramètre.
5. Vérifiez la validité du fichier par rapport au fichier DTD, puis enregistrez et fermez le fichier.
10.1.4 Personnalisation des fichiers SBO
Attention :
Lorsque vous installez un nouveau pilote, vous pouvez personnaliser les fichiers SBO avec vos propres
pilotes et vos propres entrées de base de données. Afin d'éviter d'éventuelles erreurs lors de la
modification des fichiers SBO, SAP BusinessObjects recommande de créer un fichier SBO distinct qui
174
2013-09-19
Configuration des paramètres du pilote d'accès aux données
spécifie les bases de données ciblées par votre personnalisation et les bibliothèques utilisées par le
pilote. Vous devez créer au préalable un fichier de configuration pour la définition du fichier SBO. Il
n'est pas nécessaire de modifier les registres.
1. Créez un fichier de configuration dans le répertoire rép-install-connectionserver\conne
ctionServer\setup en utilisant un éditeur XML.
Spécifiez le nom du fichier SBO, son répertoire et la couche réseau de la base de données utilisée
pour la connexion.
2. Vérifiez la validité du fichier par rapport au fichier DTD, puis enregistrez et fermez le fichier.
3. Accédez au sous-répertoire dans lequel vous souhaitez stocker le fichier SBO ou créez votre propre
sous-répertoire comme indiqué dans le fichier de configuration.
4. Créez le fichier SBO avec votre base de données cible et vos bibliothèques de pilotes en utilisant
un éditeur XML.
5. Vérifiez la validité du fichier par rapport au fichier DTD, puis enregistrez et fermez le fichier.
Remarque :
Outre la personnalisation du fichier SBO, vous devez créer les fichiers COD, PRM et RSS pour chaque
pilote que vous installez.
10.1.5 Vérification dynamique des connexions
Vous pouvez configurer un pilote de sorte qu'il confirme qu'une connexion du pool de connexions peut
être utilisée au moment de l'exécution. Ce processus de validation consiste à exécuter une requête
SQL sans effet secondaire lorsque la connexion est extraite du pool. Cela signifie que la connexion
peut être utilisée si la requête SQL est exécutée sans erreur. Dans le cas contraire, la connexion est
ignorée.
Rappel :
Cette fonctionnalité est disponible pour les connexions Generic ODBC, Generic OLE DB et
Generic JDBC. Etant donné que toutes les autres connectivités prises en charge intègrent déjà cette
vérification de connexion, aucune configuration n'est requise.
1. Arrêtez le serveur de connexion.
2. Ouvrez le fichier SBO du pilote.
3. Recherchez la section DataBase correspondant à votre connexion.
Par exemple, pour une connexion Generic ODBC :
<DataBases>
<DataBase Active="Yes" Name="Generic ODBC datasource">
<Libraries>
...
</Libraries>
<Parameter Name="CharSet Table" Platform="Unix">datadirect</Parameter>
</DataBase>
...
4. Ajoutez la ligne suivante dans la section DataBase :
<Parameter Name="Connection Check">SQL query</Parameter>
175
2013-09-19
Configuration des paramètres du pilote d'accès aux données
où SQL query est la requête servant à vérifier la validité.
5. Enregistrez le fichier SBO.
6. Redémarrez le serveur de connexion.
Connection Server confirme que la connexion peut être utilisée avant d'exécuter la requête de données.
10.1.6 Propriétés du pilote JDBC
Vous pouvez ajouter des propriétés du pilote JDBC en effectuant l'une des opérations suivantes :
•
•
Dans l'Assistant de connexion de votre application, à la création de la connexion, définissez le
paramètre "Propriétés du pilote JDBC (key=value,key=value):". Cette opération est facultative.
Définissez les propriétés du pilote dans le fichier SBO approprié une fois le le serveur de connexion
arrêté.
Si la propriété est définie à la fois dans le fichier SBO et à l'aide de l'assistant, seule la valeur définie
via l'assistant est prise en compte par l'application.
Exemple :
Voici la section d'un fichier oracle.sbo modifié avec deux propriétés du pilote.
<DataBase Active="Yes" Name="Oracle 10">
<Class JARFile="dbd_jdbc,dbd_oracle">
com.businessobjects.connectionserver.java.drivers.jdbc.oracle.OracleDriver</Class>
<JDBCDriver>
<Parameter Name="JDBC Class">oracle.jdbc.OracleDriver</Parameter>
<Parameter Name="URL Format">jdbc:oracle:thin:@§DATASOURCE§:§DATABASE§</Parameter>
<Properties>
<Property Name="oracle.jdbc.defaultNChar">true</Property>
<Property Name="defaultNChar">true</Property>
</Properties>
...
</JDBCDriver>
...
</DataBase>
Rubriques associées
• Création d'une connexion JDBC avec le fichier SBO
10.2 A propos des pilotes ODBC DataDirect
La couche d'accès aux données prend en charge l'utilisation de pilotes ODBC DataDirect 7.0 pour les
bases de données MS SQL Server sur toutes les plateformes UNIX. Ces pilotes peuvent être sans
marque ou avec marque.
176
2013-09-19
Configuration des paramètres du pilote d'accès aux données
Ces pilotes de marque DataDirect sont fournis avec la plateforme de BI et ne peuvent être utilisés
qu'avec des applications SAP BusinessObjects telles que SAP BusinessObjects Web Intelligence.
Vous les trouverez dans le répertoire rép-install-boe/enterprise_xi40/nom-plate
forme/odbc/lib, où rép-install-boe correspond au répertoire d'installation de la plateforme de
BI et nom-plateforme au nom de la plateforme UNIX.
Les bases de données MS SQL Server fonctionnent avec un pilote ODBC DataDirect 7.0 ou un pilote
ODBC de marque DataDirect 7.0. Ils fonctionnement également avec la version 6.0 SP2 du pilote.
Celle-ci n'est cependant pas fournie avec la version de plateforme actuelle.
Les paramètres par défaut du serveur de connexion permettent au pilote ODBC sans marque de
fonctionner en transparence avec vos paramètres de configuration actuels. Si vous avez déjà déployé
un pilote dans votre environnement, vous pourrez installer le pilote n'ayant pas de marque sans avoir
à modifier la configuration.
10.2.1 Pour activer l'utilisation de pilotes de marque DataDirect
Pour utiliser le pilote de marque, vous devez vous assurer que l'accès aux données est correctement
configuré.
1. Accédez au répertoire contenant le fichier sqlsrv.sbo.
Sous UNIX, ce fichier de configuration se trouve dans le répertoire rép-install-connection
server/connectionServer/odbc.
2. Utilisez un éditeur XML pour ouvrir le fichier sqlsrv.sbo à modifier.
3. Recherchez la section Defaults.
Le paramètre Use DataDirect OEM Driver est défini sur No par défaut. Cela signifie que l'accès
aux données est configuré par défaut pour fonctionner avec les pilotes sans marque.
4. Définissez le paramètre Use DataDirect OEM Driver sur Yes et enregistrez le fichier.
5. Ajoutez le fichier suivant à votre variable d'environnement LD_LIBRARY_PATH.
rép-install-boe/enterprise_xi40/nom-plateforme/odbc/lib
6. Configurez l'environnement en modifiant le fichier env.sh dans le répertoire rép-installboe/setup et remplissez-le.
Par exemple :
DEFAULT_ODBCFILE="${BOBJEDIR}enterprise_xi40/"odbc.ini
Export DEFAULT_ODBCFILE
ODBC_HOME="${BINDIR}odbc"
Export ODBC_HOME
ODBCINI="${BOBJEDIR}enterprise_xi40/"odbc.ini
export ODBCINI
Remarque :
DEFAULT_ODBCFILE peut désigner n'importe quel fichier contenant les détails de connexion des
pilotes de marque.
7. Configurez la source de données en modifiant le fichier odbc.ini.
177
2013-09-19
Configuration des paramètres du pilote d'accès aux données
Par exemple :
[ODBC Data Sources]
sql2008=sql=DataDirect 7.0 SQL Server Native Wire Protocol
Driver=/.../enterprise_xi40/linux_x64/odbc/lib/CRsqls24.so
Description=DataDirect 7.0 SQLServer Wire Protocol Driver
Address=10.180.0.197,1433
Database=bodb01
8. Lancez le serveur de connexion depuis la CMC.
Le serveur de connexion peut créer une connexion aux bases de données MS SQL Server avec des
pilotes ODBC de marque DataDirect.
Exemple :
Vous trouverez ci-dessous un extrait du fichier par défaut sqlsrv.sbo.
<Defaults>
<Parameter
<Parameter
<Parameter
<Parameter
<Parameter
...
<Parameter
</Defaults>
...
178
Name="Family">Microsoft</Parameter>
Name="SQL External File">sqlsrv</Parameter>
Name="SQL Parameter File">sqlsrv</Parameter>
Name="Description File">sqlsrv</Parameter>
Name="Strategies File">sqlsrv</Parameter>
Name="Use DataDirect OEM Driver" Platform="Unix">No</Parameter>
2013-09-19
Informations de référence sur les paramètres SBO
Informations de référence sur les paramètres SBO
11.1 Structure du fichier SBO
Il existe un fichier <pilote>.sbo pour chaque pilotes d'accès aux données pris en charge. Chaque
fichier <pilote>.sbo est divisé en sections :
179
Section du fichier
Description
Defaults
Cette section contient les paramètres de configuration par défaut
qui s'appliquent à tous les middleware de base de données utilisant
le pilote d'accès aux données. Ces paramètres remplacent les ensembles de valeurs correspondants du middleware de base de
données.
2013-09-19
Informations de référence sur les paramètres SBO
Section du fichier
Description
Cette section contient un élément enfant Database pour chaque
middleware de base de données pris en charge par le pilote d'accès
aux données.
Chaque élément Database peut contenir les éléments ou attributs
suivants :
• Active : cet attribut spécifie si la prise en charge du middleware
est activée ou non. Sa valeur est YES ou NO.
•
Name : cet attribut spécifie le nom du middleware pris en charge
par le pilote d'accès aux données. Les valeurs de noms de
middleware définies ici apparaissent dans la page Sélection du
middleware de base de données dans l'Assistant de connexion.
•
Alias : cet élément spécifie le nom des versions de middleware
les plus anciennes qui ne sont plus officiellement prises en
charge par le pilote d'accès aux données, mais qui sont encore
utilisées. Vous pouvez ajouter un élément alias pour une version
de middleware antérieure de sorte que les connexions existantes
utilisent plutôt le pilote d'accès aux données actuel. Vous pouvez
définir en guise de paramètres du nouvel alias, les paramètres
de configuration spécifiques à l'ancien middleware. Vous pouvez
créer de nouvelles connexions à l'aide de l'alias.
•
Parameter : cet élément contient un attribut Name et une valeur
qui s'applique spécifiquement à un middleware. Les valeurs
définies pour les paramètres répertoriés ici prévalent sur les
valeurs définies pour les mêmes paramètres dans la section
Defaults.
Databases
Remarque :
Les paramètres booléens acceptent les valeurs true/false
et yes/no. Les valeurs ne sont pas sensibles à la casse.
11.2 Description des paramètres SBO
Les paramètres de configuration sont répertoriés en fonction des éléments suivants :
•
180
Commun
2013-09-19
Informations de référence sur les paramètres SBO
Cette section décrit les paramètres de fichiers SBO partagés par différentes technologies de bases
de données. Les autres sections décrivent les paramètres spécifiques à la technologie de bases de
données ou à la couche réseau qu'ils représentent.
•
•
•
•
•
•
•
•
•
JavaBean
JCO
JDBC
OData
ODBC
OLE DB
OLE DB pour OLAP
Sybase ASE/CTL
Teradata
Chaque paramètre figure avec les informations suivantes :
•
Exemple de la façon dont le paramètre apparaît dans le fichier XML
•
Description du paramètre
•
Valeurs possibles qui peuvent être définies pour le paramètre
•
Valeur par défaut du paramètre
Rubriques associées
• Paramètres SBO communs
• Paramètres SBO JavaBean
• Paramètres SBO JCO
• Paramètres SBO JDBC
• Paramètres SBO OData
• Paramètres SBO ODBC
• Paramètres SBO OLE DB
• Paramètres SBO OLE DB OLAP
• Paramètres SBO Sybase
• Paramètres SBO Teradata
11.3 Paramètres SBO communs
Ces paramètres SBO sont pour la plupart communs à tous les pilotes d'accès aux données. Ils sont
définis dans la section Defaults des fichiers. Certains de ces paramètres SBO sont également définis
dans le fichier cs.cfg. Les valeurs définies dans la section Defaults remplacent celles définies dans
le fichier cs.cfg.
181
2013-09-19
Informations de référence sur les paramètres SBO
11.3.1 Array Bind Available
<Parameter Name="Array Bind Available">No</Parameter>
Spécifie si la base de données prend en charge la fonction Array Bind.
Description
La fonction Array Bind permet d'optimiser les performances des requêtes
de mise à jour SQL.
Yes : la base de données prend en charge la fonction Array Bind.
Valeurs
No : la base de données ne prend pas en charge la fonction Array Bind.
Par défaut
Valeur définie dans le fichier cs.cfg.
11.3.2 Array Bind Size
Restriction :
Les outils client de la plateforme SAP BusinessObjects de BI n'utilisent pas ce paramètre.
<Parameter Name="Array Bind Size">5</Parameter>
Description
Spécifie le nombre de lignes exportées avec chaque requête INSERT.
Valeurs
Nombre de lignes exportées avec chaque requête INSERT (entier).
Par défaut
Valeur définie dans le fichier cs.cfg.
11.3.3 Array Fetch disponible
182
2013-09-19
Informations de référence sur les paramètres SBO
<Parameter Name="Array Fetch Available">No</Parameter>
Spécifie si le serveur de connexion active la fonction Array Fetch.
Description
La fonction Array Fetch optimise les performances en extrayant les résultats SQL par tranche.
Yes : la fonction Array Fetch est prise en charge.
Valeurs
No : la fonction Array Fetch n'est pas prise en charge.
Par défaut
Valeur définie dans le fichier cs.cfg.
11.3.4 Taille de l'Array fetch
<Parameter Name="Array Fetch Size">10</Parameter>
183
2013-09-19
Informations de référence sur les paramètres SBO
Spécifie le nombre de lignes de données extraites par tranche. Le serveur de connexion fournit la fonctionnalité Array Fetch dans tous les
modes de déploiement.
Rappel :
La valeur de la taille de l'Array fetch est propagée dans le
middleware de base de données s'il prend en charge l'Array Fetch.
Le nombre optimal dépend des performances de votre système.
• Si le chiffre est peu élevé, le système extrait plus souvent de petits
volumes de données. Cela peut avoir une incidence sur les performances.
•
Description
Si le chiffre est élevé, le système effectue moins d'extractions, mais
chaque opération demande davantage de mémoire.
Attention :
Vérifiez que la valeur de la taille de l'Array fetch est appropriée, car elle peut affecter les performances de votre système, notamment dans les accès à distance, par exemple lorsque les connexions
au système SAP ERP sont établies en mode de déploiement de niveau
Web. Pour les connexions OLAP avec accès à distance (MS Analysis
Services, SAP BW et source de données Essbase via un Connection
Server 32 bits), définissez la taille de l'Array fetch sur une valeur optimale
basée sur le nombre de colonnes à créer dans les rapports (par exemple,100 si le nombre de colonnes est élevé et 250 si ce nombre est
peu élevé).
En mode de déploiement de niveau Web, le paramètre HTTP Chunk
Size peut également vous aider à ajuster les performances en réduisant
le nombre d'appels de données entre le client et le serveur. Pour en
savoir plus sur la mémorisation par bloc HTTP, voir le Guide d'administration de la plateforme SAP BusinessObjects Business Intelligence.
Nombre de lignes extraites par tranche (entier).
Valeurs
1 spécifie que la fonction Array Fetch est désactivée.
0 indique que le pilote décide quelle taille de l'Array fetch utiliser. Cette
valeur est uniquement valide pour les pilotes JDBC.
Par défaut
Valeur définie dans le fichier cs.cfg.
Rubriques associées
• Restrictions relatives au pilote SAP ERP
184
2013-09-19
Informations de référence sur les paramètres SBO
11.3.5 Taille d'affichage maximale en BigDecimal
<Parameter Name="BigDecimal Max Display Size">128</Parameter>
Description
Spécifie la taille d'affichage maximale des données extraites avec le
type de caractère BigDecimal.
Valeurs
Taille d'affichage (entier en bits).
Par défaut
Pas de valeur par défaut.
11.3.6 Binary Max Length
<Parameter Name="Binary Max Length">32768</Parameter>
Description
Spécifie la longueur maximale des colonnes de tables de type :
• binaire et valeur MaxLength définie sur Max ou aucune longueur
fixe n'est fournie pour les sources de données OData
• base64Binary et hexBinary pour les sources de données XML
Les données renvoyées sont tronquées si leur taille est supérieure à
celle spécifiée.
Par défaut
32 768
Rubriques associées
• Pilote OData
• Pilote XML
• Pilote de services Web
185
2013-09-19
Informations de référence sur les paramètres SBO
11.3.7 Paramètre Bucket Split Size
<Parameter Name="Bucket Split Size">25000</Parameter>
Spécifie le nombre d'enregistrements triés dans la mémoire avant leur
écriture sur le disque local. Les pilotes d'accès aux données suivants
utilisent le paramètre Bucket Split Size lorsqu'ils effectuent les
opérations ORDER BY, GROUP BY ou DISTINCT :
• CSV OpenDriver
• Pilote OData
• Pilote SAP ERP
• Pilotes XML et de services Web
Description
Remarque :
Vous pouvez configurer le chemin de répertoire dans le fichier cs.cfg
avec le paramètre Temp Data Dir si le système d'exploitation ne
spécifie aucun dossier temporaire. Cela peut être le cas avec les systèmes d'exploitation Linux.
Le paramètre Bucket Split Size affecte la consommation de mémoire. Si la taille de la mémoire principale est trop petite, la valeur de
paramètre est ignorée.
Par défaut
25 000
Rubriques associées
• Disque local utilisé en tant que cache pour les opérations de tri
Le pilote d'accès aux données CSV OpenDriver et les pilotes OData, SAP ERP, XML et
de services Web peuvent utiliser le disque local en tant que cache pour les lignes triées.
• Temp Data Dir
11.3.8 Séparateur de catalogue
<Parameter Name="Catalog Separator">.</Parameter>
186
2013-09-19
Informations de référence sur les paramètres SBO
Description
Spécifie le caractère de séparation utilisé entre des éléments d'identificateurs de base de données (qualificateurs, propriétaires, tables et colonnes). Par exemple, nom_base.nom_table.nom_colonne.
Valeurs
Le caractère de séparation à utiliser. En général, un point.
Par défaut
Si aucun caractère n'est spécifié, le serveur de connexion utilise le séparateur spécifié dans le middleware de base de données.
11.3.9 CharSet Table
<Parameter Name="CharSet Table">sybase</Parameter>
Description
Spécifie le nom de la table utilisée pour le mappage des jeux de caractères entre le système d'exploitation et le middleware.
Valeurs
Nom du fichier CRS.
Par défaut
Pas de valeur par défaut.
11.3.10 Description File
<Parameter Name="Description File">oracle</Parameter>
Description
187
Remarque :
Ne modifiez pas ce paramètre.
Spécifie le nom du fichier COD dans lequel se trouvent les étiquettes
de champs d'entrée de l'Assistant de connexion.
2013-09-19
Informations de référence sur les paramètres SBO
11.3.11 Dictionary Transaction Mode
<Parameter Name="Dictionary Transaction Mode">Transactional</Parameter>
Spécifie si le pilote d'accès aux données interroge les métadonnées en
mode transaction.
Description
Valeurs
Remarque :
Par défaut, les pilotes d'accès aux données interrogent les métadonnées
en mode AutoCommit (validation automatique). Pour modifier la configuration d'un pilote en mode transactionnel, ajoutez le paramètre à la
section appropriée du fichier de configuration SBO (section Valeurs
par défaut ou Base de données).
Transactional
11.3.12 Capacités du pilote
<Parameter Name="Driver Capabilities">Procedures , Query</Parameter>
La capacité du pilote à accéder ou non aux procédures et requêtes
stockées dans le logiciel de base de données. Ce paramètre est défini
à l'aide de l'Assistant de connexion. Vous pouvez inclure les deux valeurs
dans le paramètre.
Description
Remarque :
Ce paramètre doit être défini sur Procedures pour un pilote JavaBean.
Pour les applications SAP BusinessObjects, la fonctionnalité d'un pilote
JavaBean est définie en tant que procédures stockées.
Procedures : le pilote peut utiliser les procédures stockées dans la
base de données pour extraire des données.
Valeurs
Query : le pilote peut utiliser le langage d'une requête comme SQL pour
extraire des données.
188
2013-09-19
Informations de référence sur les paramètres SBO
Par défaut
Requête
11.3.13 Nom du pilote
<Parameter Name="Driver Name">Adaptive Server IQ</Parameter>
Spécifie le nom du pilote qui s'affiche dans l'onglet Pilotes de l'administrateur de sources de données ODBC sous Microsoft Windows.
Description
Ce paramètre est spécifique à ODBC. Il permet de filtrer les pilotes dans
la liste des noms de sources de données ODBC (DSN).
Nom du pilote.
Valeurs
Remarque :
Vous pouvez utiliser une expression régulière basée sur la syntaxe regexp GNU de PERL.
Par défaut
Pas de valeur par défaut.
11.3.14 Caractère d'échappement
<Parameter Name="Escape Character">/</Parameter>
189
Description
Spécifie le caractère d'échappement à utiliser dans les chaînes de caractères spéciaux, comme les schémas.
Valeurs
Le caractère à utiliser comme caractère d'échappement.
Par défaut
Si aucun caractère n'est spécifié, le serveur de connexion extrait la valeur
du middleware.
2013-09-19
Informations de référence sur les paramètres SBO
11.3.15 Extensions
<Parameter Name="Extensions">oracle10,oracle,jdbc</Parameter>
Remarque :
Ne modifiez pas ce paramètre.
Description
Fournit la liste des noms possibles pour les fichiers PRM et RSS des
pilotes d'accès aux données. Cette liste indique également les noms
possibles pour les répertoires dans lesquels vous pouvez stocker les
fichiers JAR.
Rubriques associées
• Création d'une connexion JDBC avec le paramètre Extensions
11.3.16 Family
<Parameter Name="Family">Sybase</Parameter>
Remarque :
Ne modifiez pas ce paramètre.
Description
Spécifie la famille de moteur de base de données affichée dans la page
"Sélection du middleware de base de données" de l'Assistant de connexion. L'ensemble de middleware qui correspond à la licence est affiché sur cette page dans une vue arborescente.
11.3.17 Forcer l'exécution
<Parameter Name="Force Execute">Never</Parameter>
190
2013-09-19
Informations de référence sur les paramètres SBO
Description
Remarque :
Ne modifiez pas ce paramètre.
Spécifie si la requête SQL est exécutée avant l'extraction de la description des résultats.
Never : la requête SQL n'est jamais exécutée avant l'extraction de la
description des résultats.
Valeurs
Procedures : la requête SQL est exécutée avant l'extraction de la
description des résultats, mais pour les procédures stockées uniquement.
Always : la requête SQL est toujours exécutée avant l'extraction de la
description des résultats.
Par défaut
Never
11.3.18 Casse de l'identificateur
<Parameter Name="Identifier Case">LowerCase</Parameter>
Description
Spécifie comment la base de données gère le comportement de casse
des identificateurs simples.
CaseSensitive : La base de données traite les identificateurs SQL à
casse mixte en respectant la casse.
LowerCase : La base de données traite les identificateurs SQL à casse
mixte en ne respectant pas la casse et les stocke en minuscules.
Valeurs
MixedCase : La base de données traite les identificateurs SQL à casse
mixte en ne respectant pas la casse et les stocke en casse mixte.
UpperCase : La base de données traite les identificateurs SQL à casse
mixte en ne respectant pas la casse et les stocke en majuscules.
191
2013-09-19
Informations de référence sur les paramètres SBO
11.3.19 Chaîne de signal des identificateurs
<Parameter Name="Identifier Quote String">"</Parameter>
Description
Spécifie le caractère utilisé pour signaler les identificateurs de bases
de données.
Valeurs
Caractère utilisé pour signaler les identificateurs de bases de données.
En général, des guillemets (").
Par défaut
Si aucun caractère n'est spécifié, le serveur de connexion extrait les
informations du middleware de la base de données.
11.3.20 Inclusion de synonymes
<Parameter Name="Include Synonyms">False</Parameter>
Description
Valeurs
Spécifie si des colonnes de synonymes Oracle sont extraites de la base de données
Oracle. S'applique aux connexions Oracle via les couches réseau JDBC ou Oracle
OCI.
True : des colonnes de synonymes Oracle sont extraites et affichées sous forme
de colonnes de table.
False : aucune colonne de synonymes Oracle n'est extraite.
Par défaut
False
11.3.21 Integer Max Length
192
2013-09-19
Informations de référence sur les paramètres SBO
<Parameter Name="Integer Max Length">18</Parameter>
Spécifie la longueur maximale des colonnes de table dont la source de
données XML est de type integer (nombre entier), nonPositiveInteger
(entier non positif), negativeInteger (entier négatif), noNegativeInteger
entier non négatif) et positiveInteger (entier positif).
Description
Les données renvoyées sont tronquées si leur taille est supérieure à
celle spécifiée.
Integer Max Length s'applique aux services Web et aux sources
de données XML.
Par défaut
18
Rubriques associées
• Pilote XML : Configuration de la taille maximale de la colonne
• Pilote du service Web : Configuration de la taille maximale de la colonne
11.3.22 Introscope Available
<Parameter Name="Introscope Available">True</Parameter>
Description
Remarque :
Ne modifiez pas ce paramètre.
Spécifie si la surveillance des performances via CA Wily Introscope est
activée pour le pilote.
True : la surveillance du pilote est activée.
Valeurs
False : la surveillance du pilote n'est pas activée.
Par défaut
193
Le paramètre est défini sur False pour tous les pilotes dans le fichier
cs.cfg. La surveillance est activée pour les connexions SAP HANA
uniquement dans le fichier newdb.sbo.
2013-09-19
Informations de référence sur les paramètres SBO
11.3.23 Nombre maximal de lignes disponibles
<Parameter Name="Max Rows Available">No</Parameter>
Description
Spécifie si le pilote peut limiter le nombre maximum de lignes pouvant
être extraites d'une source de données.
Yes : le nombre maximum de lignes peut être limité.
Valeurs
No : le nombre maximum de lignes ne peut pas être limité.
Par défaut
No
11.3.24 Native Int64 Available
<Parameter Name="Native Int64 Available">False</Parameter>
Description
Remarque :
Ne modifiez pas ce paramètre.
Spécifie si le middleware peut gérer directement les entiers 64 bits.
True : le middleware peut gérer les entiers 64 bits.
Valeurs
False : le middleware ne peut pas gérer les entiers 64 bits.
Par défaut
False
11.3.25 Optimize Execute
194
2013-09-19
Informations de référence sur les paramètres SBO
<Parameter Name="Optimize Execute">False</Parameter>
Description
Valeurs
Spécifie si le serveur de connexion optimise l'exécution des requêtes
SQL. Ce paramètre est pris en charge par les pilotes Oracle et ODBC
uniquement.
True : dans la mesure du possible, les requêtes SQL sont optimisées
durant l'exécution.
False : spécifie que l'exécution des requêtes SQL n'est pas optimisée.
Par défaut
False
11.3.26 Propriétaires disponibles
<Parameter Name="Owners Available">No</Parameter>
Indique si les pilotes d'accès aux données gèrent les propriétaires de
bases de données.
Description
Remarque :
Pour définir manuellement des propriétaires de tables dans l'outil de
conception d'information, vous devez définir ce paramètre sur Yes.
Yes : les propriétaires sont pris en charge.
Valeurs
No : les propriétaires ne sont pas pris en charge.
Par défaut
Non spécifié. Le serveur de connexion extrait les informations du
middleware de base de données.
11.3.27 Qualificateurs disponibles
<Parameter Name="Qualifiers Available">No</Parameter>
195
2013-09-19
Informations de référence sur les paramètres SBO
Spécifie si les pilotes d'accès aux données gèrent les qualificateurs de
bases de données.
Description
Remarque :
Pour définir manuellement des qualificateurs de tables dans l'outil de
conception d'information, vous devez définir ce paramètre sur Yes.
Yes : les qualificateurs sont pris en charge.
Valeurs
No : les qualificateurs ne sont pas pris en charge.
Par défaut
Non spécifié. Le serveur de connexion extrait les informations du
middleware de base de données.
11.3.28 Expiration de la requête disponible
<Parameter Name="Query TimeOut Available">False</Parameter>
Description
Spécifie si le middleware de la base de données prend en charge l'expiration d'une requête, c'est-à-dire si une requête en cours d'exécution
peut être annulée après un certain délai.
True : le middleware de la base de données gère les expirations de
requêtes.
Valeurs
False : le middleware de la base de données ne gère pas les expirations de requêtes.
Par défaut
False
11.3.29 Mise entre guillemets des identificateurs
<Parameter Name="Quote Identifiers">True</Parameter>
196
2013-09-19
Informations de référence sur les paramètres SBO
Description
Spécifie si l'identificateur de la procédure stockée prend en charge les
guillemets.
True : les guillemets sont pris en charge.
Valeurs
False : les guillemets ne sont pas pris en charge.
Par défaut
True
11.3.30 Skip SAML SSO
<Parameter Name="Skip SAML SSO">False</Parameter>
Spécifie si l'implémentation SAML de la connexion unique est ignorée
lors de la connexion à la base de données SAP HANA.
Description
Pour en savoir plus sur la connexion unique, consultez le Guide d'administration de la plateforme SAP BusinessObjects Business Intelligence.
True : l'implémentation SAML est ignorée.
Valeurs
False : l'implémentation SAML est utilisée en premier.
Par défaut
False
11.3.31 Fichier SQL externe
<Parameter Name="SQL External File">filename</Parameter>
197
2013-09-19
Informations de référence sur les paramètres SBO
Description
Remarque :
Ne modifiez pas ce paramètre.
Le fichier SQL externe contient des informations de configuration utilisées par la couche d'accès aux données.
11.3.32 SQL Parameter File
<Parameter Name="SQL Parameter File">oracle</Parameter>
Le nom du fichier qui stocke les paramètres de la base de données.
L'extension de ce fichier est .prm.
Description
Vous devez vous assurer que ce fichier se trouve dans le même répertoire que le fichier de configuration SBO.
Valeurs
Consultez la liste des valeurs dans le fichier SBO.
Par défaut
Valeurs de la liste.
11.3.33 Connexion unique disponible
<Parameter Name="SSO Available">False</Parameter>
Spécifie si la connexion unique est prise en charge.
Description
Pour en savoir plus sur la connexion unique, consultez le Guide d'administration de la plateforme SAP BusinessObjects Business Intelligence.
True : la connexion unique est prise en charge.
Valeurs
False : la connexion unique n'est pas prise en charge.
198
2013-09-19
Informations de référence sur les paramètres SBO
Par défaut
False
11.3.34 Strategies File
<Parameter Name="Strategies File">oracle</Parameter>
Spécifie le nom sans extension du fichier de stratégie (.stg).
Description
Ce fichier contient les stratégies externes utilisées par l'outil de conception d'univers pour la création automatique d'univers. Les fichiers de
stratégie se trouvent dans le même répertoire que le fichier SBO.
db2 pour les pilotes d'accès aux données IBM DB2.
informix pour IBM Informix
oracle pour Oracle
Valeurs
sqlsrv pour MS SQL Server
sybase pour Sybase
teradata pour Teradata
Par défaut
Valeurs de la liste.
11.3.35 String Max Length
<Parameter Name="String Max Length">32768</Parameter>
199
2013-09-19
Informations de référence sur les paramètres SBO
Indique la longueur maximale de chaîne des colonnes de table mappées
aux paramètres de fonction ABAP dont la valeur de la longueur est
égale à zéro.
Description
Spécifie également la longueur maximale des colonnes de table de
type :
• Chaîne et valeur MaxLength définie sur Max pour les sources de
données OData
• Chaîne et l'une des sources de données XML suivantes : anyURI,
QName, NOTATION, duration, gYearMonth, gYear, gMonthDay,
gDay, gMonth, TYPE_NORMALIZEDSTRING, jeton, langue, Nom,
NCName, XSD_TYPE_ID, IDREF, IDREFS, ENTITY, ENTITIES
Les données renvoyées sont tronquées si leur taille est supérieure à
celle spécifiée.
Par défaut
32 768
Rubriques associées
• Pilote OData
• Pilote SAP ERP : Accès aux fonctions ABAP
• Pilote XML
• Pilote de services Web
11.3.36 Temp Data Dir
<Parameter Name="Temp Data Dir">C:\temp\</Parameter>
200
2013-09-19
Informations de référence sur les paramètres SBO
Spécifie le chemin du répertoire des données temporaires écrites sur
le disque. Utilisez ce paramètre si le système d'exploitation ne spécifie
aucun dossier temporaire par défaut, par exemple: C:\Utilisateu
ss\monNom\AppData\Local\Temp.
Description
Les pilotes d'accès aux données suivants peuvent utiliser le paramètre
Temp Data Dir :
• CSV OpenDriver
• Pilote OData
• Pilote SAP ERP
• Pilotes XML et de services Web
Lorsque le pilote exécute une opération ORDER BY, GROUP BY ou
DISTINCT, les données sont écrites dans ce dossier si le nombre
d'enregistrements à trier dépasse la valeur du paramètre Bucket
Split Size.
Par défaut
Le paramètre est placé en commentaire. Supprimez la syntaxe de commentaire pour activer le paramètre.
Rubriques associées
• Disque local utilisé en tant que cache pour les opérations de tri
Le pilote d'accès aux données CSV OpenDriver et les pilotes OData, SAP ERP, XML et
de services Web peuvent utiliser le disque local en tant que cache pour les lignes triées.
• Paramètre Bucket Split Size
11.3.37 Mode de transaction disponible
<Parameter Name="Transactional Available">Yes</Parameter>
Spécifie si les opérations SQL exécutées sur la base de données sont
traitées comme transactions groupées ou individuelles.
Description
201
Par défaut, ce paramètre ne figure pas dans le fichier SBO. Ajoutez-le
au fichier SBO si le pilote d'accès aux données ne prend pas en charge
le mode de transaction.
2013-09-19
Informations de référence sur les paramètres SBO
Yes : les opérations exécutées sur la base de données sont traitées en
tant que groupe lorsqu'elles sont validées.
Valeurs
No : chaque instruction SQL est immédiatement validée, autrement dit,
l'option Autocommit est désactivée.
Remarque :
N'utilisez pas de pilote avec Transactional Available=No pour
accéder au référentiel SAP BusinessObjects.
Par défaut
Yes. Valeur définie dans le fichier cs.cfg.
Rubriques associées
• Echec de connexion lorsque le mode Transaction n'est pas pris en charge
• Fonctionnement des connexions salesforce.com dans l'outil de conception d'univers
11.3.38 Type
<Parameter Name="Type">Relational</Parameter>
Description
Remarque :
Ne modifiez pas ce paramètre.
Spécifie le type de la source de données.
11.3.39 Unicode
<Parameter Name="Unicode">UTF8</Parameter>
202
2013-09-19
Informations de référence sur les paramètres SBO
Spécifie si le pilote d'accès aux données peut bénéficier de la configuration Unicode du middleware client.
Description
Ce paramètre apparaît comme paramètre par défaut du pilote dans le
fichier cs.cfg. Sa valeur s'applique à tous les pilotes d'accès aux données. Par défaut, ce paramètre ne figure pas dans le fichier SBO. Pour
remplacer la valeur par défaut, vous devez l'ajouter à la section De
faults du fichier SBO pour le pilote d'accès aux données cible.
UTF8 : encodage du format de transformation UCS/Unicode 8 bits.
Valeurs
CharSet : encodage du jeu de caractères.
UCS2 : encodage du jeu de caractères 2 bits Universal Character Set.
Par défaut
Valeur définie dans le fichier cs.cfg.
11.3.40 Format d'URL
<Parameter Name="URL Format ">string</Parameter>
Spécifie le format de l'URL.
La spécification JDBC n'indique pas le format de la chaîne de connexion
qu'elle requiert. Les fournisseurs utilisent différents types de formats
d'URL. En voici quelques exemples :
• Fournisseur MySQL :
jdbc:mysql://$DATASOURCE$/$DATABASE$
Description
•
Fournisseur Oracle :
jdbc:oracle:thin:@$DATASOURCE$:$DATABASE$
Remarque :
Ce paramètre est pris en charge par les fichiers de pilote JDBC et JavaBean uniquement.
Valeurs
203
Format de l'URL.
2013-09-19
Informations de référence sur les paramètres SBO
Par défaut
Pas de valeur par défaut.
11.3.41 Taille maximale des données XML
<Parameter Name="XML Max Size">65536</Parameter>
Description
Spécifie la taille maximale des données extraites au format XML.
Valeurs
Taille XML maximale autorisée (en octets).
Par défaut
Ce paramètre dépend de la base de données.
11.4 Paramètres SBO JavaBean
Ces paramètres s'appliquent au fichier SBO de JavaBean. Ils servent à configurer la connexion
JavaBean.
Ils sont définis dans le fichier \\rép-install-connectionserver\connectionServer\java
bean\javabean.sbo.
11.4.1 Classe JavaBean
<Parameter Name="JavaBean Class">string</Parameter>
Définit le point d'entrée du JavaBean que l'application SAP BusinessObjects utilise.
Description
Le point d'entrée est la définition d'une classe Java développée depuis
l'interface Bean spécifiée via le package com.businessobjects.
204
2013-09-19
Informations de référence sur les paramètres SBO
Valeurs
Un nom complet de classe JavaBean
Par défaut
Pas de valeur par défaut.
11.5 Paramètres SBO JCO
Ces paramètres s'appliquent à la technologie de base de données SAP ERP. Ils servent à configurer
une connexion à un système SAP ERP.
Ils sont définis dans le fichier \\rép-install-connectionserver\connectionSer
ver\jco\jco.sbo.
11.5.1 ERP Max Rows
<Parameter Name="ERP Max Rows">2147483647</Parameter>
Description
Spécifie le nombre maximum de lignes pouvant être renvoyées par une
requête à un InfoSet ou une requête SAP sans filtre.
Valeurs
Nombre entier égal ou inférieur à 2147483647.
Par défaut
2147483647
Rubriques associées
• Pilote SAP ERP
11.6 Paramètres SBO JDBC
Ces paramètres s'appliquent au fichier SBO de JDBC. Ils servent à configurer la connexion JDBC.
205
2013-09-19
Informations de référence sur les paramètres SBO
Ils sont définis dans les fichiers SBO du répertoire \\rép-install-connectionserver\connec
tionServer\jdbc.
11.6.1 Connexion partageable
<Parameter Name="Connection Shareable">False</Parameter>
Remarque :
Ne modifiez pas ce paramètre.
Description
Spécifie si une connexion d'un pool de connexions peut être partagée
entre différents demandeurs. Fonctionne conjointement avec le paramètre Connexion partagée.
True : la connexion peut être partagée entre plusieurs utilisateurs.
Valeurs
False : la connexion ne peut pas être partagée entre les utilisateurs.
Par défaut
False
Rubriques associées
• Connexion partagée
11.6.2 Caractère d'échappement disponible (Escape Character Available)
<Parameter Name="Escape Character Available">True</Parameter>
Description
Spécifie si la couche réseau JDBC intègre une clause d'échappement
après l'expression like de la requête SQL. Cette clause permet de
spécifier un caractère afin d'ignorer des caractères spécifiques tels que
les traits de soulignement (_).
True : une clause d'échappement est prise en charge.
Valeurs
False : aucune clause d'échappement n'est prise en charge.
206
2013-09-19
Informations de référence sur les paramètres SBO
Par défaut
True
11.6.3 Clés étrangères disponibles
<Parameter Name="ForeignKeys Available">True</Parameter>
Spécifie si les clés étrangères des tables de la
base de données peuvent être extraites.
Description
True : les clés étrangères peuvent être extraites.
Valeurs
False : les clés étrangères ne peuvent pas être
extraites.
Par défaut
True
11.6.4 Obtention d'une colonne étendue
<Parameter Name="Get Extended Column">No</Parameter>
Remarque :
Ne modifiez pas ce paramètre.
Description
Spécifie si la couche d'accès aux données utilise la procédure stockée
getExtendedColumns fournie par l'implémentation du serveur de requêtes Data Federator pour extraire les colonnes d'entrée.
Yes : getExtendedColumnsest utilisée.
Valeurs
No : getExtendedColumns n'est pas utilisée.
Par défaut
207
No
2013-09-19
Informations de référence sur les paramètres SBO
11.6.5 Classe JDBC
<Parameter Name="JDBC Class">string</Parameter>
Description
Valeurs
Classe Java complète du pilote JDBC.
Dépend du fournisseur ou de la source de données, par exemple :
• oracle.jdbc pour OracleDriver pour Oracle
•
Par défaut
com.ibm.db2.jcc.DB2Driver pour DB2
Pas de valeur par défaut.
11.6.6 Clés primaires disponibles
<Parameter Name="PrimaryKey Available">True</Parameter>
Description
Spécifie si les clés primaires des tables de la base de données peuvent
être extraites.
True : les clés primaires peuvent être extraites.
Valeurs
False : les clés primaires ne peuvent pas être extraites.
Par défaut
True
11.6.7 Paramètres régionaux de visualisation préférés disponibles
<Parameter Name="PVL Available">True</Parameter>
208
2013-09-19
Informations de référence sur les paramètres SBO
Spécifie si la connexion prend en charge la fonctionnalité Paramètres
régionaux de visualisation préférés (PVL).
Description
Cette fonctionnalité est uniquement prise en charge par les connexions
SAP HANA dans cette version.
True : la fonctionnalité PVL est prise en charge.
Valeurs
False : la fonctionnalité PVL n'est pas prise en charge.
11.6.8 Connexion partagée
<Parameter Name="Shared Connection">False</Parameter>
Remarque :
Ne modifiez pas ce paramètre.
Description
Spécifie si la connexion demandée d'un pool de connexions est partagée.
Fonctionne conjointement avec le paramètre Connexion parta
geable. N'est pas pris en compte si le paramètre Max Pool Time de
cs.cfg est défini sur 0.
True : la connexion est partagée.
Valeurs
False : la connexion n'est pas partagée.
Par défaut
False
Rubriques associées
• Connexion partageable
• Max Pool Time
11.6.9 JDBC ResultSet Type
209
2013-09-19
Informations de référence sur les paramètres SBO
<Parameter Name="JDBC ResultSet Type">1003</Parameter>
Remarque :
Vous devez utiliser ce paramètre avec JDBC ResultSet Concurre
ncy. Il n'est pas obligatoire.
Description
Spécifie la valeur d'argument resultSetType de la méthode Java
createStatement.
Cette méthode appartient à l'interface java.sql.Connection. Vous
ajoutez ce paramètre pour créer un objet Statement par défaut et
ajuster les performances de votre connexion.
Valeurs
Vous définissez des valeurs Java standard ou des valeurs spécifiques
à la base de données. Les valeurs doivent être des nombres entiers.
Rubriques associées
• createStatement method
• ResultSet interface
11.6.10 JDBC ResultSet Concurrency
<Parameter Name="JDBC ResultSet Concurrency">1007</Parameter>
Remarque :
Vous devez utiliser ce paramètre avec JDBC ResultSet Type. Il n'est
pas obligatoire.
Description
Spécifie la valeur d'argument resultSetConcurrency de la méthode
Java createStatement.
Cette méthode appartient à l'interface java.sql.Connection. Vous
ajoutez ce paramètre pour créer un objet Statement par défaut et
ajuster les performances de votre connexion.
Valeurs
Vous définissez des valeurs Java standard ou des valeurs spécifiques
à la base de données. Les valeurs doivent être des nombres entiers.
Rubriques associées
• createStatement method
210
2013-09-19
Informations de référence sur les paramètres SBO
• ResultSet interface
11.7 Paramètres SBO OData
Ces paramètres sont utilisés pour configurer des connexions aux sources de données qui utilisent le
protocole OData.
Ils sont définis dans le fichier \\rép-install-serveurdeconnexion\connectionServer\oda
ta\odata.sbo.
11.7.1 Enforce Max Protocol Version
<Parameter Name="Enforce Max Protocol Version">Yes</Parameter>
Spécifie si le pilote envoie la version prise en charge du protocole
OData au fournisseur OData.
Description
Si tel est le cas, le fournisseur OData peut décider s'il répond ou non
au pilote dans le protocole donné. Ce paramètre peut être utile lorsque
la plateforme de BI se connecte à un fournisseur qui utilise le protocole
OData 3.0.
Yes : le pilote envoie la version prise en charge du protocole OData.
Valeurs
No : le pilote n'envoie pas la version prise en charge du protocole
OData.
Par défaut
Yes
11.8 Paramètres SBO ODBC
Ces paramètres s'appliquent à la couche réseau ODBC. Ils servent à configurer la connexion ODBC.
211
2013-09-19
Informations de référence sur les paramètres SBO
Ils sont définis dans les fichiers SBO du sous-répertoire \\connectionserver-install-dir\co
nnectionServer\odbc.
11.8.1 Jeu de caractères
<Parameter Name="CharSet">UTF88591</Parameter>
Remarque :
Ne modifiez pas ce paramètre.
Description
Spécifie le jeu de caractères des données renvoyées par le middleware
de base de données.
Valeurs
ISO88591 : valeur par défaut du jeu de caractères spécifiée pour
HP Neoview sous UNIX.
Par défaut
Si aucune valeur n'est spécifiée, le serveur de connexion utilise le jeu
de caractères indiqué dans le middleware de la base de données.
11.8.2 Statut de connexion disponible
<Parameter Name="Connection Status Available">True</Parameter>
Description
Spécifie si le middleware peut détecter les connexions incorrectes (fonction ping).
True : le middleware peut détecter les connexions incorrectes.
Valeurs
False : le middleware ne peut pas détecter les connexions incorrectes.
Par défaut
212
La valeur définie dans le middleware.
2013-09-19
Informations de référence sur les paramètres SBO
11.8.3 Coût estimé disponible
<Parameter Name="Cost Estimate Available">False</Parameter>
Description
Spécifie si le middleware de base de données prend en charge l'estimation du coût de l'exécution de la requête SQL. Ce paramètre est uniquement utilisé avec la base de données Teradata.
True : le middleware prend en charge l'estimation du coût.
Valeurs
False : le middleware ne prend pas en charge l'estimation du coût.
Par défaut
False
11.8.4 Chaîne vide
<Parameter Name="Empty String">EmptyString</Parameter>
Description
Spécifie si certaines fonctions telles que les tables SQL reçoivent une
chaîne vide ou un pointeur nul pour remplacer les paramètres manquants.
NullString : une chaîne nulle est utilisée.
Valeurs
EmptyString : une chaîne vide est utilisée.
Par défaut
EmptyString
11.8.5 ODBC Cursors
213
2013-09-19
Informations de référence sur les paramètres SBO
<Parameter Name="ODBC Cursors">No</Parameter>
Description
Spécifie si le pilote d'accès aux données utilise la bibliothèque de curseurs ODBC. Cela peut vous aider à améliorer les performances de
votre système.
Yes : le pilote d'accès aux données utilise la bibliothèque de curseurs
ODBC.
Valeurs
No : le pilote d'accès aux données n'utilise pas la bibliothèque de curseurs ODBC.
Par défaut
Valeur définie dans le fichier cs.cfg.
11.8.6 SQLDescribeParam disponible
<Parameter Name="SQLDescribeParam Available">True</Parameter>
Description
Spécifie si le middleware gère la fonction ODBC SQLDescribeParam.
Cette fonction permet de décrire les paramètres d'une procédure stockée. Ce paramètre est utilisé pour la base de données IBM Informix
uniquement.
True : la fonction SQLDescribeParam est disponible.
Valeurs
False : la fonction SQLDescribeParam n'est pas disponible.
Par défaut
La valeur définie dans le middleware de base de données.
11.8.7 SQLMoreResults disponible
<Parameter Name="SQLMoreResults Available">True</Parameter>
214
2013-09-19
Informations de référence sur les paramètres SBO
Spécifie si le middleware gère la fonction ODBC SQLMoreResults.
Description
Cette fonction permet d'extraire davantage d'ensembles de résultats de
l'exécution SQL, le cas échéant. Ce paramètre est pris en charge par
les pilotes ODBC uniquement.
True : la fonction SQLMoreResults est prise en charge.
Valeurs
False : la fonction SQLMoreResults n'est pas prise en charge.
Par défaut
La valeur définie dans le middleware.
11.8.8 Utilisation du pilote OEM DataDirect
<Parameter Name="Use DataDirect OEM Driver">No</Parameter>
Description
Spécifie si les connexions aux bases de données MS SQL Server
peuvent utiliser des pilotes ODBC de marque DataDirect.
Yes : la connexion peut utiliser le pilote de marque.
Valeurs
No : la connexion ne peut pas utiliser de pilote de marque.
Par défaut
No
Rubriques associées
• A propos des pilotes ODBC DataDirect
11.8.9 V5toV6DriverName
<Parameter Name="V5toV6DriverName">{Informix 3.34 32 BIT}</Parameter>
215
2013-09-19
Informations de référence sur les paramètres SBO
Description
Spécifie la règle de conversion d'Informix Connect en Informix
ODBC. La valeur de ce paramètre détermine quel pilote Informix est utilisé pour définir le nom de la source de données (DSN) ODBC sans la
chaîne de connexion. Ce paramètre est utilisé pour la base de données
IBM Informix uniquement.
Valeurs
Le nom exact du pilote Informix installé sur l'ordinateur.
Par défaut
Valeur définie dans le fichier cs.cfg.
11.9 Paramètres SBO OLE DB
Ces paramètres s'appliquent à la technologie de bases de données OLE DB. Ils servent à configurer
la connexion OLE DB.
Ils sont définis dans les fichiers \\rép-install-connectionserver\connectionSer
ver\oledb\oledb.sbo et \sqlsrv.sbo.
11.9.1 Enumerator CLSID
<Parameter Name="Enumerator CLSID">MSDASQL Enumerator</Parameter>
Description
Remarque :
Ne modifiez pas ce paramètre.
Spécifie l'ID de classe de l'énumérateur OLE DB. Ce paramètre est utilisé avec OLE DB uniquement.
11.9.2 Provider CLSID
<Parameter Name="Provider CLSID">MSDASQL</Parameter>
216
2013-09-19
Informations de référence sur les paramètres SBO
Description
Remarque :
Ne modifiez pas ce paramètre.
Spécifie l'ID de classe du fournisseur OLE DB. Ce paramètre est utilisé
avec OLE DB uniquement.
11.10 Paramètres SBO OLE DB OLAP
Ces paramètres s'appliquent à la technologie de bases de données OLAP OLE DB. Ils servent à
configurer la connexion OLE DB pour OLAP.
Ils sont définis dans le fichier \\rép-install-connectionserver\connectionSer
ver\oledb_olap\slqsrv_as.sbo.
11.10.1 MSOlap CLSID
<Parameter Name="MSOlap CLSID">msolap.4</Parameter>
Description
Remarque :
Ne modifiez pas ce paramètre.
Spécifie l'ID de classe du fournisseur OLE DB. Ce paramètre est utilisé
avec OLE DB pour OLAP uniquement.
11.11 Paramètres SBO Sybase
Ces paramètres s'appliquent au fichier SBO de Sybase ASE/CTLIB. Ils servent à configurer la connexion
Sybase ASE/CTLIB.
Ils sont définis dans le fichier \\rép-install-connectionserver\connectionServer\sy
base\sybase.sbo.
217
2013-09-19
Informations de référence sur les paramètres SBO
11.11.1 Comportement des pilotes
<Parameter Name="Driver Behavior">Dynamic</Parameter>
Description
Spécifie quel pilote Sybase est utilisé.
Dynamic : le pilote ct_dynamic est utilisé.
Valeurs
Toute autre valeur permet l'utilisation du pilote CTLib.
Par défaut
Dynamic.
11.11.2 Cryptage du mot de passe
<Parameter Name="Password Encryption">True</Parameter>
Indique si le mécanisme de cryptage du mot de passe spécifié dans le
middleware doit être utilisé pour le mot de passe saisi dans la boîte de
dialogue Détails sur la connexion.
Description
Ce paramètre est uniquement utilisé avec Sybase. Il se trouve dans la
section Defaults pour des raisons de compatibilité avec les versions
à venir.
True : le mécanisme de cryptage de mot de passe du middleware est
utilisé.
Valeurs
False : le mécanisme de cryptage de mot de passe du middleware
n'est pas utilisé.
Par défaut
218
Valeur définie dans le fichier cs.cfg.
2013-09-19
Informations de référence sur les paramètres SBO
11.11.3 Identificateur entre guillemets
<Parameter Name="Quoted Identifier">False</Parameter>
Description
Spécifie si les identificateurs entre guillemets sont pris en charge. Ce
paramètre est pris en charge par le middleware Sybase uniquement.
True : les identificateurs entre guillemets sont pris en charge.
Valeurs
False : les identificateurs entre guillemets ne sont pas pris en charge.
Par défaut
False
11.11.4 Reprise sur erreur
<Parameter Name="Recover Errors">True</Parameter>
Description
Spécifie si le pilote Client Library est utilisable après l'échec du pilote
ct_dynamic.
True : le pilote Client Library est utilisé.
Valeurs
False : le pilote Client Library n'est pas utilisé.
Par défaut
True
11.11.5 Taille du texte
<Parameter Name="Text Size">32768</Parameter>
219
2013-09-19
Informations de référence sur les paramètres SBO
Remarque :
Ce paramètre n'est pas obligatoire.
Spécifie la taille maximale des données binaires ou caractères volumineuses de longueur variable prise en charge.
Description
Par défaut
Les données binaires ou caractères volumineuses de longueur variable
extraites de la base de données Sybase CTL sont tronquées si elles
sont supérieures à 32 Ko. Vous ajoutez ce paramètre à la section Data
base appropriée du fichier de configuration pour éviter que les données
ne soient tronquées.
32768
11.12 Paramètres SBO Teradata
Ces paramètres s'appliquent aux fichiers SBO Teradata. Ils sont utilisés pour configurer une connexion
Teradata via JDBC ou ODBC.
Ils sont définis dans les fichiers \\rép-install-serveurdeconnexion\connectionSer
ver\jdbc\teradata.sbo et \\rép-install-serveurdeconnexion\connectionSer
ver\odbc\teradata.sbo.
11.12.1 Replace Current Owner With Database
<Parameter Name="Replace Current Owner With Database">Yes</Parameter>
Description
Valeurs
Spécifie si le pilote renvoie le nom de la base de données en cours lorsque la source de données est interrogée à propos du propriétaire actuel.
Utilisation exclusive avec des connexions ODBC.
Yes : le propriétaire actuel est mappé au nom de la base de données
Teradata.
No : le propriétaire actuel est mappé au nom d'utilisateur actuel.
220
2013-09-19
Informations de référence sur les paramètres SBO
Par défaut
No
Rubriques associées
• Connexions Teradata : Mappage de la base de données Teradata au propriétaire actuel
La section suivante fournit des informations de configuration relatives aux connexions
Teradata.
221
2013-09-19
Informations de référence sur les paramètres SBO
222
2013-09-19
Configuration des paramètres de fonctionnalités des bases de données
Configuration des paramètres de fonctionnalités des
bases de données
12.1 A propos des paramètres de fonctionnalités des bases de données
Les paramètres de fonctionnalités des bases de données décrivent les fonctionnalités des bases de
données utilisées en tant que sources de données pour le contenu d'un univers. Vous pouvez définir
ces paramètres pour les utiliser aux niveaux suivants :
• Au niveau de l'univers
Les paramètres sont définis lors de la création ou de la modification de l'univers.
•
Au niveau de la base de données
Les paramètres sont définis dans le fichier PRM de la base de données. Ils sont remplacés par tout
paramètre correspondant au niveau de l'univers.
Remarque :
Pour visualiser les opérateurs et les fonctions disponibles pour le pilote d'accès aux données, ouvrez
le fichier <pilote>.prm dans un éditeur XML.
12.2 A propos des fichiers PRM
Les fichiers PRM fournissent des paramètres qui décrivent les fonctionnalités de bases de données
utilisées comme sources de données pour les applications SAP BusinessObjects. Ils permettent aux
facteurs liés à la base de données de vérifier le SQL à utiliser avec l'univers en fonction de la connexion
et de la base de données associée. Il existe un fichier PRM correspondant à chaque pilote de base de
données.
Vous pouvez configurer certains paramètres de fonctionnalités de bases de données lorsque vous
vous trouvez dans l'univers. Ils remplacent les paramètres du fichier PRM en conséquence.
Les fichiers PRM se trouvent dans les dossiers suivants :
•
223
rép-install-serveurdeconnexion\connectionServer\<SGBDR>, où <SGBDR > est la
couche réseau ou le nom du middleware.
2013-09-19
Configuration des paramètres de fonctionnalités des bases de données
•
rép-install-serveurdeconnexion\connectionServer\<SGBDR>\extensions\qt. Ces
fichiers PRM s'appellent des fichiers étendus. Pour en savoir plus sur les paramètres des fichiers
étendus, voir le chapitre de référence SQL et MDX du Guide de l'utilisateur de l'outil de conception
d'information.
Remarque :
Des fichiers texte d'aide sont également disponibles en d'autres langues dans ces répertoires.
12.2.1 Structure de fichier de paramètres PRM
Il existe un fichier PRM pour chaque pilote de base de données pris en charge. Chaque fichier est
divisé en plusieurs sections qui contiennent des paramètres spécifiques. Le tableau suivant décrit le
contenu et la signification de chaque section de fichier PRM.
Section du fichier
Description
Paramètres utilisés pour décrire les fonctionnalités des bases de données
servant de sources de données pour les univers, par exemple EXT_JOIN,
ORDER_BY et UNION. Elles ne sont pas directement disponibles pour tous
les produits SAP BusinessObjects.
Configuration
Ces paramètres peuvent être modifiés pour optimiser les requêtes exécutées
sur des univers avec le pilote d'accès aux données cible.
Remarque :
Voir leur description dans le chapitre suivant.
224
DateOperations
Opérateurs de date disponibles pour l'outil de conception d'univers et l'outil
de conception d'information, par exemple, ANNEE, TRIMESTRE, MOIS.
Operators
Opérateurs disponibles pour l'outil de conception d'univers et l'outil de conception d'information, par exemple, AJOUTER, SOUSTRAIRE, MULTIPLIER.
2013-09-19
Configuration des paramètres de fonctionnalités des bases de données
Section du fichier
Description
Fonctions disponibles pour l'outil de conception d'univers et l'outil de conception d'information, par exemple, Moyenne, Somme, Variance. Pour en savoir
plus, voir le Guide de l'utilisateur de l'outil de conception d'information.
Le texte de l'aide qui apparaît lorsque des fonctions de cette section sont
sélectionnées dans l'outil de conception d'univers et dans l'outil de conception
d'information est répertorié dans le fichier <pilote><langue>.prm, par
exempleoracleen.prm. Ce fichier se trouve dans le même répertoire que
le fichier <pilote>.prm. Vous pouvez l'ouvrir pour afficher les descriptions
de toutes les fonctions disponibles dans le fichier <pilote>.prm.
La section Functions contient les éléments enfants suivants :
• Group : indique si l'utilisation de cette fonction dans une requête génère
une clause group by.
Fonctions
•
True (vrai) indique que la requête génère une clause group by.
•
False (faux) indique que la requête ne génère pas de clause group
by.
•
ID : nom qui apparaît dans la liste de fonctions "Objets personnels" de
Desktop Intelligence. Obsolète dans cette version.
•
InMacro : si cette valeur est True, alors la fonction est répertoriée dans
la liste de fonctions "Objets personnels" de Desktop Intelligence. Obsolète
dans cette version.
•
Type : type de données de la fonction.
•
Arguments : arguments acceptés par la fonction. Une fonction peut disposer d'un maximum de quatre arguments, et tout argument supplémentaire n'est pas pris en compte.
•
SQL : syntaxe SQL pour la fonction.
Rubriques associées
• Pour afficher et modifier un fichier texte d'aide sur les fonctions
12.3 Pour afficher et modifier des fichiers PRM
1. Placez-vous dans le répertoire qui contient le fichier PRM du pilote d'accès aux données cible.
225
2013-09-19
Configuration des paramètres de fonctionnalités des bases de données
Les fichiers PRM sont stockés dans les répertoires rép-install-connectionserver\conne
ctionServer\<SGBDR>.
2. Ouvrez un fichier <pilote>.prm dans un éditeur XML.
3. Développez les sections concernées.
4. Définissez les valeurs en les entrant dans la balise appropriée.
5. Enregistrez le fichier et fermez-le.
12.4 Pour afficher et modifier un fichier texte d'aide sur les fonctions
Le texte de l'aide qui apparaît sous chaque fonction sélectionnée dans l'outil de conception d'univers
ou l'outil de conception d'informations est géré dans un fichier XML distinct. Vous pouvez modifier et
ajouter du texte pour décrire une fonction en modifiant le fichier <pilote><langue>.prm. Il existe
un fichier texte d'aide pour chaque version linguistique des produits SAP BusinessObjects installés.
Lorsque vous ajoutez une fonction au fichier PRM, vous devez ajouter le texte d'aide pour cette nouvelle
fonction dans le fichier <pilote><langue>.prm approprié. Par exemple, si vous ajoutez une fonction
au fichier oracle.prm, vous devez aussi ajouter le nom de la fonction et son texte d'aide au fichier
oraclefr.prm si vous utilisez la version française de l'outil. Voir la norme ISO639-1.
12.5 Pour modifier le texte d'aide d'une fonction PRM
1. Placez-vous dans le répertoire qui contient le fichier de langue PRM du pilote d'accès aux données
cible.
Les fichiers linguistiques PRM sont stockés dans les répertoires rép-install-connectionser
ver\connectionServer\<SGBDR>.
2. Ouvrez un fichier <pilote><langue>.prm dans un éditeur XML.
3. Développez la section Messages.
4. Procédez comme suit pour ajouter du texte d'aide à une nouvelle fonction :
• Ajoutez une nouvelle section pour la fonction. La façon la plus simple de le faire consiste à copier
l'entrée d'une fonction existante et à la coller dans la section Function. Modifiez ensuite le texte
de la nouvelle fonction.
•
Saisissez le texte d'aide pour la fonction.
5. Pour afficher ou modifier le texte d'aide d'une fonction existante, procédez comme suit :
• Développez la section Function.
226
•
Développez la section Message pour la fonction.
•
Modifiez le texte d'aide.
2013-09-19
Configuration des paramètres de fonctionnalités des bases de données
6. Enregistrez le fichier et fermez-le.
227
2013-09-19
Configuration des paramètres de fonctionnalités des bases de données
228
2013-09-19
Informations de référence sur les paramètres PRM
Informations de référence sur les paramètres PRM
13.1 Informations de référence sur la configuration de fichier PRM
Les paramètres de fonctionnalités de bases de données sont répertoriés par ordre alphabétique. Pour
afficher les fonctions, les opérateurs de date et les autres opérateurs disponibles, ouvrez un fichier
<pilote>.prm dans un éditeur XML. Chaque paramètre est défini dans la balise suivante :
<Parameter Name="parameter">value</Parameter>
où parameter est le nom du paramètre et value la valeur attribuée au paramètre.
Chaque paramètre figure avec les informations suivantes :
•
Exemple de la façon dont le paramètre apparaît dans le fichier XML
•
Description du paramètre
•
Valeurs possibles qui peuvent être définies pour le paramètre
•
Valeur par défaut du paramètre, le cas échéant
Remarque :
Certains paramètres de configuration ne doivent pas être modifiés. Ces paramètres ont des valeurs
définies pour une utilisation interne dans les solutions SAP BusinessObjects. Ces paramètres sont
décrits dans cette section, mais un avertissement indique qu'il ne faut pas en modifier les valeurs. Vous
ne devez pas modifier ces paramètres. Avant de modifier un ou plusieurs autres fichiers PRM, il est
recommandé d'effectuer une copie de sauvegarde du fichier PRM.
13.1.1 ANALYTIC_CLAUSE
<Parameter Name="ANALYTIC_CLAUSE">WHEN</Parameter>
Description
229
Spécifie le mot clé SQL à utiliser si une fonction spécifiée dans le paramètre ANALYTIC_FUNCTIONS est utilisée dans l'instruction SQL.
2013-09-19
Informations de référence sur les paramètres PRM
WHEN : indique qu'une clause WHEN est utilisée. Il s'agit de la valeur
par défaut pour les bases de données IBM Red Brick.
Valeurs
QUALIFY: indique qu'une clause QUALIFY est utilisée. Il s'agit de la
valeur par défaut pour les bases de données Teradata.
Remarque :
Consultez la documentation de votre base de données pour savoir comment elle implémente la clause SQL.
Par défaut
Voir les valeurs ci-dessus.
Rubriques associées
• ANALYTIC_FUNCTIONS
13.1.2 ANALYTIC_FUNCTIONS
<Parameter Name="ANALYTIC_FUNCTIONS">RANK,SUM,AVG,COUNT,MIN,MAX</Parameter>
Description
Répertorie les fonctions d'analyse prises en charge par la base de données.
Valeurs
Consultez les valeurs dans les fichiers PRM.
Par défaut
Valeurs de la liste.
13.1.3 CALCULATION_FUNCTION
<Parameter Name="CALCULATION_FUNCTION">YES</Parameter>
Description
230
Spécifie si la base de données prend en charge les fonctions de calcul.
2013-09-19
Informations de référence sur les paramètres PRM
Valeurs
YES : la base de données prend en charge les fonctions de calcul. Dans
ce cas, l'outil de conception d'information est en mesure de créer des
colonnes de calcul.
NO : la base de données ne prend pas en charge les fonctions de calcul.
13.1.4 CONSTANT_SAMPLING_SUPPORTED
<Parameter Name="CONSTANT_SAMPLING_SUPPORTED">YES</Parameter>
Description
Spécifie si la base de données prend en charge l'échantillonnage aléatoire. L'échantillonnage aléatoire consiste à extraire des lignes aléatoires
d'un jeu de données.
YES : la base de données prend en charge l'échantillonnage aléatoire.
Valeurs
NO : la base de données ne prend pas en charge l'échantillonnage
aléatoire.
Par défaut
YES
13.1.5 DISTINCT
<Parameter Name="DISTINCT">YES</Parameter>
Description
231
Spécifie si la base de données prend en charge le mot clé DISTINCT
dans les instructions SQL. Ce paramètre est utilisé avec MS Access.
2013-09-19
Informations de référence sur les paramètres PRM
YES : la base de données prend en charge le mot clé DISTINCT.
Valeurs
NO : la base de données ne prend pas en charge le mot clé DISTINCT.
Ce comportement désactive les fonctionnalités suivantes :
• L'option Valeurs distinctes qui apparaît lorsque vous cliquez sur le
bouton Valeurs dans l'Assistant de création d'univers de l'outil de
conception d'univers.
•
Par défaut
La fonction NombreUnique qui s'affiche lorsque vous créez une
condition avec l'opérande Calcul dans l'Editeur de requête.
YES
13.1.6 EXT_JOIN
<Parameter Name="EXT_JOIN">YES</Parameter>
Description
Spécifie si la base de données prend en charge les jointures externes.
Ce paramètre est utilisé par tous les pilotes d'accès aux données.
YES : la base de données prend en charge les jointures externes.
Valeurs
NO : la base de données ne prend pas en charge les jointures externes.
Les cases à cocher Jointure externe de la boîte de dialogue Modifier
la jointure de l'outil de conception d'univers sont grisées.
Par défaut
YES
13.1.7 FULL_EXT_JOIN
<Parameter Name="FULL_EXT_JOIN">YES</Parameter>
232
2013-09-19
Informations de référence sur les paramètres PRM
Description
Indique si la base de données prend en charge les jointures externes
complètes.
YES : la base de données prend en charge les jointures externes complètes.
Valeurs
NO : la base de données ne prend pas en charge les jointures externes
complètes.
Par défaut
YES
13.1.8 GROUP_BY
<Parameter Name="GROUP_BY">NO</Parameter>
Description
Spécifie si la base de données prend en charge la clause GROUP BY dans les
instructions SQL.
YES : la base de données prend en charge la clause GROUP BY.
Valeurs
NO : la base de données ne prend pas en charge la clause GROUP BY.
13.1.9 GROUP_BY_SUPPORTS_COLUMN_INDEX
<Parameter Name="GROUP_BY_SUPPORTS_COLUMN_INDEX">NO</Parameter>
Description
233
Spécifie si la base de données prend en charge l'utilisation d'index de
colonnes de l'instruction SELECT dans la clause GROUP BY.
2013-09-19
Informations de référence sur les paramètres PRM
YES : la base de données prend en charge l'utilisation d'index de colonnes de l'instruction SELECT à la place des noms de colonne.
Valeurs
NO : la base de données ne prend pas en charge l'utilisation d'index de
colonnes de l'instruction SELECT à la place des noms de colonne.
Par défaut
NO
13.1.10 GROUP_BY_SUPPORTS_COMPLEX
Parameter Name="GROUP_BY_SUPPORTS_COMPLEX">NO</Parameter>
Spécifie si la base de données prend en charge les expressions complexes dans la clause GROUP BY. Les expressions complexes sont
toutes les expressions à l'exception des noms de colonnes et des index
de l'instruction SELECT, comme les fonctions ou les colonnes ne figurant pas dans l'instruction SELECT. Ce paramètre est utilisé avec
IBM DB2.
Description
Remarque :
Si vous exécutez une requête contenant des indicateurs et des objets
complexes (c'est-à-dire des objets utilisant des fonctions et la concaténation), votre application affiche le message d'erreur suivant : La base
de données ne vous permet pas d'effectuer des agrégations avec l'objet <nom_objet>.
YES : la base de données prend en charge les expressions complexes
dans la clause GROUP BY.
Valeurs
NO : la base de données ne prend pas en charge les expressions complexes dans la clause GROUP BY.
Par défaut
234
NO
2013-09-19
Informations de référence sur les paramètres PRM
13.1.11 GROUP_BY_SUPPORTS_CONSTANT
<Parameter Name="GROUP_BY_SUPPORTS_CONSTANT">YES</Parameter>
Description
Spécifie si la base de données prend en charge l'utilisation d'objets constants dans la clause GROUP BY. Ce paramètre est utilisé par les
bases de données IBM DB2 et Microsoft SQL Server.
YES : la base de données prend en charge l'utilisation d'objets constants
dans la clause GROUP BY.
Valeurs
NO : la base de données ne prend pas en charge l'utilisation d'objets
constants dans la clause GROUP BY.
Par défaut
YES
13.1.12 HAVING
<Parameter Name="HAVING">NO</Parameter>
Description
Spécifie si la base de données prend en charge la clause HAVING dans
les instructions SQL.
YES : la base de données prend en charge la clause HAVING.
Valeurs
NO : la base de données ne prend pas en charge la clause HAVING.
Par défaut
NO
13.1.13 INTERSECT
235
2013-09-19
Informations de référence sur les paramètres PRM
<Parameter Name="INTERSECT">INTERSECT</Parameter>
Description
Spécifie le mot clé pris en charge par la base de données pour l'opération
sur ensemble INTERSECT.
INTERSECT : le mot clé pris en charge par la base de données est INTERSECT.
Valeurs
Aucune valeur : la base de données ne prend en charge aucun mot clé
pour l'opération sur ensemble INTERSECT. Dans ce cas, deux requêtes
sont générées.
Par défaut
INTERSECT
13.1.14 INTERSECT_ALL
<Parameter Name="INTERSECT_ALL">YES</Parameter>
Description
Spécifie si la base de données prend en charge l'opération sur ensemble
INTERSECT ALL.
YES : la base de données prend en charge l'opération sur ensemble
INTERSECT ALL.
Valeurs
NO : la base de données ne prend pas en charge l'opération sur ensemble INTERSECT ALL.
Par défaut
YES
13.1.15 INTERSECT_IN_SUBQUERY
<Parameter Name="INTERSECT_IN_SUBQUERY">YES</Parameter>
236
2013-09-19
Informations de référence sur les paramètres PRM
Description
Spécifie si la base de données prend en charge l'opération sur ensemble
INTERSECT dans les sous-requêtes.
YES : la base de données prend en charge l'opération sur ensemble
INTERSECT dans les sous-requêtes.
Valeurs
NO : la base de données ne prend pas en charge l'opération sur ensemble INTERSECT dans les sous-requêtes.
13.1.16 JOIN
<Parameter Name="JOIN">YES</Parameter>
Description
Spécifie si la base de données prend en charge une opération JOIN
entre deux tables.
YES : la base de données prend en charge les jointures entre toutes les
colonnes de deux tables.
Valeurs
STRUCTURE_JOIN : la base de données prend en charge les jointures
entre deux tables liées à des contraintes référentielles. Identique à NO
dans cette version.
NO : la base de données ne prend pas en charge les jointures entre
deux tables.
13.1.17 LEFT_EXT_JOIN
<Parameter Name="LEFT_EXT_JOIN">YES</Parameter>
Description
237
Spécifie si la base de données prend en charge les jointures externes
complètes.
2013-09-19
Informations de référence sur les paramètres PRM
YES : la base de données prend en charge les jointures externes
gauches.
Valeurs
NO : la base de données ne prend pas en charge les jointures externes
gauches.
13.1.18 LEFT_OUTER
<Parameter Name="LEFT_OUTER">$(+)</Parameter>
<Parameter Name="LEFT_OUTER">$*</Parameter>
Description
Spécifie la syntaxe à utiliser pour les expressions de jointure externe
gauche.
$(+) : cette syntaxe est utilisée avec Oracle.
Valeurs
$* : cette syntaxe est utilisée avec Sybase, MS SQL Server et
IBM Red Brick.
Remarque :
$ représente une expression de jointure.
Par défaut
Voir les valeurs ci-dessus.
Exemple
Si table1.col1 est joint à table2.col2 dans Oracle, l'expression
générée est table1.col1(+) = table2.col2.
13.1.19 LIKE_SUPPORTS_ESCAPE_CLAUSE
<Parameter Name="LIKE_SUPPORTS_ESCAPE_CLAUSE">YES</Parameter>
Description
238
Spécifie si la base de données prend en charge l'utilisation d'une clause
ESCAPE dans la condition LIKE de l'instruction SQL.
2013-09-19
Informations de référence sur les paramètres PRM
YES : la base de données prend en charge la clause ESCAPE dans la
condition LIKE.
Valeurs
NO : la base de données ne prend pas en charge la clause ESCAPE
dans la condition LIKE.
Par défaut
Si ce paramètre n'est pas spécifié, le serveur de connexion extrait l'information du middleware de base de données.
13.1.20 MINUS
<Parameter Name="MINUS">MINUS</Parameter>
Description
Spécifie le mot clé pris en charge par la base de données pour l'opération
sur ensemble MINUS.
MINUS : la base de données prend en charge l'opérateur ensembliste
MINUS.
Valeurs
EXCEPT : la base de données prend en charge l'opérateur ensembliste
EXCEPT.
Aucune valeur : la base de données ne prend en charge aucun mot clé
pour l'opération sur ensemble MINUS. Dans ce cas, deux requêtes sont
générées.
Par défaut
MINUS
13.1.21 MINUS_ALL
<Parameter Name="MINUS_ALL">Yes</Parameter>
239
2013-09-19
Informations de référence sur les paramètres PRM
Description
Spécifie si la base de données prend en charge l'opération sur ensemble
MINUS ALL.
YES : la base de données prend en charge l'opération sur ensemble
MINUS ALL.
Valeurs
NO : la base de données ne prend pas en charge l'opération sur ensemble MINUS ALL.
13.1.22 MINUS_IN_SUBQUERY
<Parameter Name="MINUS_IN_SUBQUERY ">YES</Parameter>
Description
Spécifie si la base de données prend en charge l'opération sur ensemble
MINUS dans les sous-requêtes.
YES : la base de données prend en charge l'opération sur ensemble
MINUS dans les sous-requêtes.
Valeurs
NO : la base de données ne prend pas en charge l'opération sur ensemble MINUS dans les sous-requêtes.
13.1.23 ORDER_BY
<Parameter Name="ORDER_BY">YES</Parameter>
Description
Spécifie si la base de données prend en charge la clause ORDER BY.
YES : la base de données prend en charge la clause ORDER BY.
Valeurs
NO : la base de données ne prend pas en charge la clause ORDER BY.
240
2013-09-19
Informations de référence sur les paramètres PRM
13.1.24 ORDER_BY_REQUIRES_SELECT
<Parameter Name="ORDER_BY_REQUIRES_SELECT">NO</Parameter>
Description
Valeurs
Spécifie si la base de données requiert que les colonnes utilisées dans
la clause ORDER BY soient référencées dans la clause SELECT.
YES : les utilisateurs ne sont pas autorisés à trier les colonnes si elles
ne figurent pas dans l'instruction SELECT. Dans ce cas, le bouton Gérer
les tris est grisé dans l'éditeur de requête de l'outil de conception
d'univers.
NO : les utilisateurs sont autorisés à trier les colonnes même si elles ne
figurent pas dans l'instruction SELECT.
Par défaut
NO
13.1.25 ORDER_BY_SUPPORTS_COLUMN_INDEX
<Parameter Name="ORDER_BY_SUPPORTS_COLUMN_INDEX">YES</Parameter>
Description
Spécifie si la base de données prend en charge l'utilisation d'index de
colonnes de l'instruction SELECT dans la clause ORDER BY.
YES : la base de données prend en charge l'utilisation d'index de colonnes de l'instruction SELECT à la place des noms de colonne.
Valeurs
NO : la base de données ne prend pas en charge l'utilisation d'index de
colonnes de l'instruction SELECT à la place des noms de colonne.
241
2013-09-19
Informations de référence sur les paramètres PRM
13.1.26 PERCENT_RANK_SUPPORTED
<Parameter Name="PERCENT_RANK_SUPPORTED">YES</Parameter>
Description
Spécifie si la base de données prend en charge la fonction d'analyse
de classement par pourcentage. Consultez la documentation de votre
base de données pour savoir comment elle implémente le classement
par pourcentage.
YES : la base de données prend en charge le classement par pourcentage.
Valeurs
NO : la base de données ne prend pas en charge le classement par
pourcentage.
Par défaut
YES
13.1.27 RANK_SUPPORTED
<Parameter Name="RANK_SUPPORTED">YES</Parameter>
Description
Spécifie si la base de données prend en charge la fonction d'analyse
de classement dans les instructions SQL.
YES : la base de données prend en charge le classement.
Valeurs
NO : la base de données ne prend pas en charge le classement.
Par défaut
242
YES
2013-09-19
Informations de référence sur les paramètres PRM
13.1.28 RIGHT_EXT_JOIN
<Parameter Name="RIGHT_EXT_JOIN">YES</Parameter>
Description
Spécifie si la base de données prend en charge les jointures externes
droites.
YES : la base de données prend en charge les jointures externes droites.
Valeurs
NO : la base de données ne prend pas en charge les jointures externes
droites.
13.1.29 RIGHT_OUTER
<Parameter Name="RIGHT_OUTER">$(+)</Parameter>
<Parameter Name="RIGHT_OUTER">*$</Parameter>
Description
Spécifie la syntaxe à utiliser pour les expressions de jointure externe
droite.
$(+) : cette syntaxe est utilisée avec Oracle.
Valeurs
*$ : cette syntaxe est utilisée avec Sybase, MS SQL Server et
IBM Red Brick.
Remarque :
$ représente une expression de jointure.
Par défaut
243
Voir les valeurs ci-dessus.
2013-09-19
Informations de référence sur les paramètres PRM
13.1.30 SEED_SAMPLING_SUPPORTED
<Parameter Name="SEED_SAMPLING_SUPPORTED">YES</Parameter>
Description
Spécifie si la base de données prend en charge l'échantillonnage par
valeur de départ. L'échantillonnage par valeur de départ est une variante
de l'échantillonnage aléatoire où la valeur de départ aléatoire est fournie
par l'utilisateur.
YES : la base de données prend en charge l'échantillonnage par valeur
de départ.
Valeurs
NO : la base de données ne prend pas en charge l'échantillonnage par
valeur de départ.
Par défaut
NO
13.1.31 SELECT_SUPPORTS_NULL
<Parameter Name="NULL_IN_SELECT_SUPPORTED">YES</Parameter>
Description
Spécifie si la base de données prend en charge les colonnes NULL
dans l'instruction SELECT.
YES : la base de données prend en charge les colonnes NULL dans
l'instruction SELECT.
Valeurs
NO : la base de données ne prend pas en charge les colonnes NULL
dans l'instruction SELECT.
YES
Par défaut
244
NO pour les bases de données Teradata, IBM DB2, IMB Informix et
IBM Red Brick qui ne prennent pas en charge la valeur NULL pour les
colonnes.
2013-09-19
Informations de référence sur les paramètres PRM
13.1.32 SUBQUERY_IN_FROM
<Parameter Name="SUBQUERY_IN_FROM">YES</Parameter>
Description
Spécifie si la base de données prend en charge l'utilisation de sous-requêtes
dans la clause FROM.
YES : la base de données prend en charge l'utilisation de sous-requêtes dans
la clause FROM.
Valeurs
NO : la base de données ne prend pas en charge l'utilisation de sous-requêtes
dans la clause FROM.
13.1.33 SUBQUERY_IN_IN
<Parameter Name="SUBQUERY_IN_IN">YES</Parameter>
Description
Spécifie si la base de données prend en charge l'utilisation de sous-requêtes dans la clause IN.
YES : la base de données prend en charge l'utilisation de sous-requêtes
dans la clause IN.
Valeurs
NO : la base de données ne prend pas en charge l'utilisation de sousrequêtes dans la clause IN.
13.1.34 SUBQUERY_IN_WHERE
<Parameter Name="SUBQUERY_IN_WHERE">YES</Parameter>
245
2013-09-19
Informations de référence sur les paramètres PRM
Description
Spécifie si la base de données prend en charge l'utilisation de sous-requêtes
dans la clause WHERE.
YES : la base de données prend en charge l'utilisation de sous-requêtes dans
la clause WHERE.
Valeurs
NO : la base de données ne prend pas en charge l'utilisation de sous-requêtes
dans la clause WHERE.
13.1.35 TECHNICAL_COLUMN_NAME_PATTERN
<Parameter Name="TECHNICAL_COLUMN_NAME_PATTERN">^(-idref)(.)*</Parameter>
Description
Spécifie que toutes les colonnes commençant par le modèle -idref ne sont
pas affichées dans les connexions, fondations de données et couches de gestion d'univers basés sur des sources de données OData. Par conséquent,
l'outil de conception d'information ne peut pas créer de requêtes avec ces colonnes.
Remarque :
Ne modifiez pas ce paramètre.
Valeur
^(-idref)(.)*
13.1.36 UNION
<Parameter Name="UNION">UNION</Parameter>
Description
246
Spécifie le mot clé pris en charge par la base de données pour l'opération
sur ensemble UNION.
2013-09-19
Informations de référence sur les paramètres PRM
UNION : le mot clé pris en charge par la base de données est UNION.
Valeurs
Aucune valeur : la base de données ne prend en charge aucun mot clé
pour l'opération sur ensemble UNION. Dans ce cas, deux requêtes sont
générées.
Par défaut
UNION
13.1.37 UNION_ALL
<Parameter Name="UNION_ALL">YES</Parameter>
Description
Spécifie si la base de données prend en charge l'opération sur ensemble UNION
ALL.
YES : la base de données prend en charge l'opération sur ensemble UNION
ALL.
Valeurs
NO : la base de données ne prend pas en charge l'opération sur ensemble UNION
ALL.
13.1.38 UNION_IN_SUBQUERY
<Parameter Name="UNION_IN_SUBQUERY">YES</Parameter>
Description
Spécifie si la base de données prend en charge l'utilisation de l'opération sur ensemble UNION dans les sous-requêtes.
YES : la base de données prend en charge l'opération sur ensemble UNION dans
les sous-requêtes.
Valeurs
NO : la base de données ne prend pas en charge l'opération sur ensemble UNION
dans les sous-requêtes.
247
2013-09-19
Informations de référence sur les paramètres PRM
248
2013-09-19
Informations de référence sur la conversion du type de données
Informations de référence sur la conversion du type de
données
14.1 Conversion du type de données
Dans l'outil de conception d'information, les fondations de données fournissent des tables d'une ou
plusieurs bases de données relationnelles, qui forment la base des couches de gestion. Le type de
données associé à chaque colonne de table est affiché dans une fondation de données avec d'autres
détails de colonne. Les couches de gestion fournissent des colonnes de table en tant qu'objets de
métadonnées, tels que des dimensions ou des hiérarchies, et affichent le type de données associé à
chaque objet. Le tableau suivant décrit le mappage entre ces deux ensembles de types de données :
249
Type de données affiché dans la fondation
de données
Type de données affiché dans la couche de
gestion
BINARY, LONGVARBINARY, VARBINARY
BLOB
BIT
Booléen
DATE
Date
TIME, TIMESTAMP
Date/heure
LONGVARCHAR
Texte long
BIGINT, DECIMAL, DOUBLE, FLOAT, INTEGER,
NUMERIC, REAL, SMALLINT, TINYINT
Numérique
CHAR, VARCHAR, XML
Chaîne
UNDEFINED
Inconnu
2013-09-19
Informations de référence sur la conversion du type de données
Remarque :
Issue de n'importe quelle base de données, une heure est gérée comme Date/Heure dans la plateforme
de BI. La partie de la valeur Date/Heure qui correspond à la date doit normalement s'afficher en tant
que date actuelle dans les rapports des utilisateurs finaux.
La couche d'accès aux données gère la conversion des types de données fournis par les couches
réseau en types de données du serveur de connexion, qui sont ensuite mappés aux types de données
fournis dans les fondations de données.
Cette section fournit les tables de conversion entre les types de données des couches réseau génériques
(JDBC et ODBC) et les types de données des fondations de données. Elle fournit également des tables
de conversion pour des couches réseau spécifiques telles qu'OLE DB, Oracle OCI et Sybase CTL et
décrit des exceptions et des conversions non évidentes pour des bases de données spécifiques (fichiers
CSV, systèmes SAP ERP et la base de données SAP HANA, par exemple).
Rubriques associées
• Types de données du fichier CSV
• Types de données JDBC
• Types de données ODBC
• Types de données OData
• Types de données OLE DB
• Types de données Oracle OCI
• Types de données SAP ERP
• Types de données SAP HANA
• Types de données Sybase CTL
• Types de données XML
14.1.1 Types de données du fichier CSV
Le tableau suivant répertorie les types de données déclarés dans les fichiers DDL pour la détection du
schéma des fichiers CSV et leur équivalent dans les fondations de données.
250
Type déclaré dans le fichier DDL
Type de données de fondation de données
BIT, BOOLEAN
BIT
DATE
DATE
TIME
TIME
2013-09-19
Informations de référence sur la conversion du type de données
Type déclaré dans le fichier DDL
Type de données de fondation de données
TIMESTAMP
TIMESTAMP
BIGINT, DECIMAL
DECIMAL
FLOAT, DOUBLE, REAL
DOUBLE
INTEGER, INT, SMALLINT
INTEGER
NUMBER, NUMERIC
NUMERIC
VARCHAR
VARCHAR
Rubriques associées
• Détection du schéma CSV
14.1.2 Types de données JDBC
Le tableau suivant répertorie les types de données fournis via JDBC et leur équivalent dans les fondations
de données.
251
Type de données JDBC
Type de données de fondation de données
BINARY
BINARY
VARBINARY
VARBINARY
BLOB, LONGVARBINARY
LONGVARBINARY
BIT, BOOLEAN
BIT
CLOB, NCLOB
LONGVARCHAR
2013-09-19
Informations de référence sur la conversion du type de données
Type de données JDBC
Type de données de fondation de données
DATE
DATE
TIME
TIME
TIMESTAMP
TIMESTAMP
DOUBLE
DOUBLE
FLOAT
FLOAT
REAL
REAL
SMALLINT
SMALLINT
CHAR, NCHAR
CHAR
LONGNVARCHAR, LONGVARCHAR, NVARCHAR, ROWID, VARCHAR
VARCHAR
SQLXML
XML
IBM Informix
Le tableau suivant répertorie les types de données susceptibles de figurer dans les résultats lorsque
l'utilisateur interroge une base de données IBM Informix via JDBC et leur équivalent dans les fondations
de données. Ces types de données écrasent les types de données génériques.
252
2013-09-19
Informations de référence sur la conversion du type de données
Type de données JDBC Informix
Type de données de fondation de données
TIMESTAMP
Ils peuvent être mappés aux types suivants :
• DATE si le type de données Informix suit le
modèle DATETIME\\s+(HOUR|MINUTE|SE
COND)\\s+TO\\s+(HOUR|MINUTE|SECO
ND)
• TIME si le type de données Informix suit le
modèle DATETIME\\s+(YEAR|MO
NTH|DAY)\\s+TO\\s+(YEAR|MONTH|DAY)
• TIMESTAMP dans les autres cas
BOOLEAN
SMALLINT
MS SQL Server
Le tableau suivant répertorie les types de données susceptibles de figurer dans les résultats lorsque
l'utilisateur interroge une base de données MS SQL Server via JDBC et leur équivalent dans les
fondations de données. Le mappage des types de données dépend aussi du nom du type SQL associé
au type de données de la couche réseau. Ces types de données écrasent les types de données
génériques.
Type de données JDBC MS
SQL Server
Nom du type SQL
Type de données de fondation
de données
LONGVARCHAR
toute valeur autre que "xml"
VARCHAR
LONGVARCHAR
xml
XML
Oracle
Le tableau suivant répertorie les types de données susceptibles de figurer dans les résultats lorsque
l'utilisateur interroge une base de données Oracle via JDBC et leur équivalent dans les fondations de
données. Le mappage des types de données dépend aussi du nom du type SQL associé au type de
données de la couche réseau. Ces types de données écrasent les types de données génériques.
253
Type de données JDBC
Oracle
Nom du type SQL
Type de données de fondation
de données
BFILE
toute valeur
LONGVARBINARY
2013-09-19
Informations de référence sur la conversion du type de données
Type de données JDBC
Oracle
Nom du type SQL
Type de données de fondation
de données
toute valeur
BFILE
LONGVARBINARY
DATE
toute valeur
TIMESTAMP
toute valeur
TIMESTAMP
TIMESTAMP
BINARY_DOUBLE
toute valeur
DOUBLE
OTHER
FLOAT
DOUBLE
BINARY_FLOAT
toute valeur
REAL
toute valeur
NCHAR
CHAR
toute valeur
NVARCHAR2, ROWID, UROWID
VARCHAR
14.1.3 Types de données ODBC
Le tableau suivant répertorie les types de données fournis via ODBC et leur équivalent dans les
fondations de données.
254
Type de données ODBC
Type de données de fondation de données
SQL_BINARY
BINARY
SQL_VARBINARY
VARBINARY
SQL_LONGVARBINARY
LONGVARBINARY
SQL_BIT
BIT
2013-09-19
Informations de référence sur la conversion du type de données
Type de données ODBC
Type de données de fondation de données
SQL_DATE, SQL_TYPE_DATE
DATE
SQL_DATETIME, SQL_TIME, SQL_TIMESTAMP,
SQL_TYPE_TIME, SQL_TYPE_TIMESTAMP
TIMESTAMP
SQL_LONGVARCHAR, SQL_WLONGVARCHAR
LONGVARCHAR
SQL_BIGINT
BIGINT
SQL_DECIMAL
DECIMAL
SQL_DOUBLE
DOUBLE
SQL_FLOAT
FLOAT
SQL_INTEGER
INTEGER
SQL_NUMERIC
NUMERIC
SQL_REAL
REAL
SQL_SMALLINT
SMALLINT
SQL_TINYINT
TINYINT
SQL_CHAR, SQL_GUID, SQL_WCHAR
CHAR
SQL_VARCHAR, SQL_WVARCHAR
VARCHAR
IBM DB2
Le tableau suivant répertorie les types de données susceptibles de figurer dans les résultats lorsque
l'utilisateur interroge une base de données IBM DB2 via ODBC et leur équivalent dans les fondations
de données. Ces types de données écrasent les types de données génériques.
255
2013-09-19
Informations de référence sur la conversion du type de données
Type de données ODBC DB2
Type de données de fondation de données
SQL_BLOB
LONGVARBINARY
SQL_CLOB, SQL_DBCLOB, SQL_LONGVARGRAPHIC
LONGVARCHAR
SQL_DECFLOAT
DOUBLE
SQL_GRAPHIC
CHAR
SQL_VARGRAPHIC
VARCHAR
SQL_XML
XML
IBM Informix
Le tableau suivant répertorie les types de données susceptibles de figurer dans les résultats lorsque
l'utilisateur interroge une base de données IBM Informix via ODBC et leur équivalent dans les fondations
de données. Ces types de données écrasent les types de données génériques.
256
Type de données ODBC Informix
Type de données de fondation de données
SQL_BIT
SMALLINT
SQL_INFX_UDT_BLOB
LONGVARBINARY
SQL_TIMESTAMP, SQL_TYPE_TIMESTAMP
Ils peuvent être mappés aux types suivants :
• DATE si le type de données Informix suit le
modèle DATETIME\\s+(HOUR|MINUTE|SE
COND)\\s+TO\\s+(HOUR|MINUTE|SECO
ND)
• TIME si le type de données Informix suit le
modèle DATETIME\\s+(YEAR|MO
NTH|DAY)\\s+TO\\s+(YEAR|MONTH|DAY)
• TIMESTAMP dans les autres cas
SQL_INFX_UDT_CLOB
LONGVARCHAR
2013-09-19
Informations de référence sur la conversion du type de données
MS SQL Server
Le tableau suivant répertorie les types de données susceptibles de figurer dans les résultats lorsque
l'utilisateur interroge une base de données MS SQL Server via ODBC et leur équivalent dans les
fondations de données. Ces types de données écrasent les types de données génériques.
Type de données ODBC MS SQL Server
Type de données de fondation de données
SQL_SS_TIME2, SQL_SS_TIMESTAMPOFFSET
TIMESTAMP
SQL_SS_XML
XML
14.1.4 Types de données OData
Le tableau suivante répertorie les types de données EDM (Entity Data Model) internes aux sources de
données OData et leur équivalent dans les fondations de données.
Type de données OData
Type de données de fondation de données
Edm.Binary
BINARY
Edm.Boolean
BIT
TIMESTAMP
257
Edm.DateTime, Edm.Time
Remarque :
Les nanosecondes ne sont pas mappées.
Edm.Int64
BIGINT
Edm.Decimal
DECIMAL
Edm.Double
DOUBLE
Edm.Float, Edm.Single
FLOAT
2013-09-19
Informations de référence sur la conversion du type de données
Type de données OData
Type de données de fondation de données
Edm.Int32
INTEGER
Edm.Byte, Edm.Int16, Edm.SByte
SMALLINT
Edm.DateTimeOffset, Edm.Guid, Edm.String
VARCHAR
14.1.5 Types de données OLE DB
Le tableau suivant répertorie les types de données fournis via OLE DB et leur équivalent dans les
fondations de données.
Remarque :
Pour certains types de données, le mappage dépend des valeurs des paramètres DBCOLUMNFLAGS_IS
LONG et DBCOLUMNFLAGS_ISFIXEDLENGTH associés à chaque type.
258
Type de données OLE DB
Type de données de fondation de données
DBTYPE_BYTES
VARBINARY
DBTYPE_BYTES si DBCOLUMNFLAGS_ISLONG=true
LONGVARBINARY
DBTYPE_BYTES si DBCOLUMNFLAGS_ISFIXEDLE
NGTH=true
BINARY
DBTYPE_BOOL
BIT
DBTYPE_DBDATE
DATE
DBTYPE_DBTIME
TIME
DBTYPE_DBTIMESTAMP
TIMESTAMP
2013-09-19
Informations de référence sur la conversion du type de données
Type de données OLE DB
Type de données de fondation de données
DBTYPE_DECIMAL
DECIMAL
DBTYPE_I1, DBTYPE_UI1
TINYINT
DBTYPE_I2, DBTYPE_UI2
SMALLINT
DBTYPE_I4, DBTYPE_UI4
INTEGER
DBTYPE_I8, DBTYPE_UI8
BIGINT
DBTYPE_R4
REAL
DBTYPE_R8
DOUBLE
DBTYPE_CY, DBTYPE_NUMERIC
NUMERIC
DBTYPE_STR, DBTYPE_WSTR
VARCHAR
DBTYPE_STR, DBTYPE_WSTR si DBCOLUMN
FLAGS_ISLONG=true
LONGVARCHAR
DBTYPE_STR, DBTYPE_WSTR si DBCOLUMN
FLAGS_ISFIXEDLENGTH=true
CHAR
Types de données MS SQL Server
Le tableau suivant répertorie les types de données susceptibles de figurer dans les résultats lorsque
l'utilisateur interroge une base de données MS SQL Server via OLE DB et leur équivalent dans les
fondations de données. Ces types de données écrasent les types de données précédents.
259
Type de données OLE DB MS SQL Server
Type de données de fondation de données
DBTYPE_DBTIME2, DBTYPE_DBTIMESTAMPOFFSET
TIMESTAMP
2013-09-19
Informations de référence sur la conversion du type de données
Type de données OLE DB MS SQL Server
Type de données de fondation de données
DBTYPE_GUID
CHAR
DBTYPE_XML
XML
14.1.6 Types de données Oracle OCI
Le tableau suivant répertorie les types de données fournis via Oracle OCI et leur équivalent dans les
fondations de données.
260
Type de données Oracle OCI
Type de données de fondation de données
SQLT_BIN
BINARY
SQLT_BFILE, SQLT_BLOB, SQLT_LBI
LONGVARBINARY
SQLT_DAT, SQLT_DATE, SQLT_TIME,
SQLT_TIMESTAMP, SQLT_TIMESTAMP_LTZ,
SQLT_TIMESTAMP_TZ
TIMESTAMP
SQLT_CLOB, SQLT_LNG
LONGVARCHAR
SQLT_FLT, SQLT_IBDOUBLE
DOUBLE
SQLT_IBFLOAT
REAL
SQLT_NUM
NUMERIC
SQLT_AFC
CHAR
SQLT_CHR, SQLT_RDD, SQLT_RID
VARCHAR
2013-09-19
Informations de référence sur la conversion du type de données
14.1.7 Types de données SAP ERP
Le tableau suivant répertorie les types de données ABAP utilisés par les systèmes SAP ERP et leur
équivalent dans les fondations de données.
Type de données ABAP
Type de données de fondation de données
HEXADECIMAL
BINARY
DATE
DATE
TIME
TIME
FLOAT
FLOAT
INTEGER
INTEGER
NUMERIC TEXT, PACKED NUMBER
NUMERIC
TEXT
CHAR
VARIABLE LENGTH STRING
VARCHAR
Format de date dans les expressions SQL
Le format de date à utiliser par l'utilisateur de l'application lors de la création de requêtes dans l'éditeur
d'expressions SQL est DATE'aaaa-mm-jj', par exemple : DATE'2013-04-10'.
Le format est spécifié dans le fichier PRM étendu jco.prm avec le paramètre USER_INPUT_DATE_FOR
MAT. Voir le Guide de l'utilisateur de l'outil de conception d'information.
Rubriques associées
• A propos des fichiers PRM
261
2013-09-19
Informations de référence sur la conversion du type de données
14.1.8 Types de données SAP HANA
Le tableau suivant répertorie les types de données utilisés dans la base de données SAP HANA et leur
équivalent dans les fondations de données. Pour en savoir plus sur les types de données SAP HANA,
voir la Référence relative aux types de données SAP HANA.
Type de données SAP HANA
Type de données de fondation de données
BLOB
LONGVARBINARY
VARBINARY
VARBINARY
DATE
DATE
TIME
TIME
TIMESTAMP
LONGDATE, SECONDDATE, TIMESTAMP
Remarque :
SECONDDATE est converti en TIMESTAMP sans
millisecondes.
DECIMAL, REAL, SMALLDECIMAL
FLOAT
BIGINT, INTEGER, SMALLINT, TINYINT
INTEGER
DOUBLE
DOUBLE
CLOB, NCLOB, TEXT
LONGVARCHAR
ALPHANUM, NVARCHAR, SHORTTEXT, VARCHAR
VARCHAR
Rubriques associées
• SAP HANA Data Type Reference
262
2013-09-19
Informations de référence sur la conversion du type de données
14.1.9 Types de données Sybase CTL
Le tableau suivant répertorie les types de données fournis via Sybase CTL et leur équivalent dans les
fondations de données.
Remarque :
Les types de données Sybase CTL sont des valeurs du champ datatype de la structure CS_DATAFMT,
qui est fournie par la couche réseau. La valeur du champ usertype de la structure est également
fournie pour certains types de données et est utilisée pour le mappage par la couche d'accès aux
données.
263
Type de données Sybase CTL
Type d'utilisateur Sybase CTL
Type de données de fondation de données
CS_BINARY_TYPE
CS_BINARY_USERTYPE
BINARY
CS_BINARY_TYPE
CS_VARBINARY_USERTYPE ou
aucune valeur
VARBINARY
CS_LONGBINARY_TYPE
Toute valeur
VARBINARY
CS_IMAGE_TYPE
Toute valeur
LONGVARBINARY
CS_BIT_TYPE
Toute valeur
BIT
CS_DATE_TYPE
Toute valeur
DATE
CS_BIGDATETIME_TYPE,
CS_BIGTIME_TYPE, CS_DATETIME_TYPE, CS_DATETIME4_TYPE, CS_TIME_TYPE
Toute valeur
TIMESTAMP
CS_LONGCHAR_TYPE,
CS_TEXT_TYPE
Toute valeur
LONGVARCHAR
CS_BIGINT_TYPE, CS_UBIGINT_TYPE
Toute valeur
BIGINT
2013-09-19
Informations de référence sur la conversion du type de données
264
Type de données Sybase CTL
Type d'utilisateur Sybase CTL
Type de données de fondation de données
CS_DECIMAL_TYPE, CS_MONEY_TYPE, CS_MONEY4_TYPE
Toute valeur
DECIMAL
CS_FLOAT_TYPE
Toute valeur
DOUBLE
CS_INT_TYPE , CS_UINT_TYPE
Toute valeur
INTEGER
CS_NUMERIC_TYPE
Toute valeur
NUMERIC
CS_REAL_TYPE
Toute valeur
REAL
CS_SMALLINT_TYPE,
CS_USMALLINT_TYPE
Toute valeur
SMALLINT
CS_TINYINT_TYPE
Toute valeur
TINYINT
CS_CHAR_TYPE
CS_CHAR_USERTYPE ou
CS_NCHAR_USERTYPE ou
CS_UNICHAR_USERTYPE
CHAR
CS_CHAR_TYPE
CS_VARCHAR_USERTYPE ou
CS_NVARCHAR_USERTYPE ou
CS_UNIVARCHAR_USERTYPE
ou CS_SYSNAME_USERTYPE
ou aucune valeur
VARCHAR
CS_UNICHAR_TYPE
USER_UNICHAR_TYPE
CHAR
CS_UNICHAR_TYPE
USER_UNIVARCHAR_TYPE ou
aucune valeur
VARCHAR
2013-09-19
Informations de référence sur la conversion du type de données
14.1.10 Types de données XML
Le tableau suivant répertorie les types de données intégrés XML et leur équivalent dans les fondations
de données.
265
Type de données intégré XML
Type de données de fondation de données
booléen
BIT
base64Binary, hexBinary
•
•
date
DATE
time
TIME
dateHeure
TIMESTAMP
float
FLOAT
double, decimal
DOUBLE
integer, negativeInteger, nonPositiveInteger, noNegativeInteger, positiveInteger
DECIMAL
long, unsignedLong
BIGINT
int, unsignedInt
INTEGER
short, unsignedShort
SMALLINT
byte, unsignedByte
TINYINT
BINARY si une longueur est définie
VARBINARY
2013-09-19
Informations de référence sur la conversion du type de données
Type de données intégré XML
Type de données de fondation de données
•
•
chaîne
anySimpleType, anyType, anyURI, duration,
gDay, gMonth, gMonthDay, gYear, gYearMonth,
NOTATION, QName
CHAR si une longueur est définie
VARCHAR
Remarque :
Les types de données dérivés de la chaîne sont
mappés à CHAR ou VARCHAR.
VARCHAR
Mappage des métadonnées de colonne
•
•
•
L'élément Signé ou Non signé est déterminé selon le type de données.
L'élément Peut être nul est déterminé selon les attributs nullable et minOccurs.
La taille de colonne, les chiffres décimaux et la taille d'affichage sont déterminés selon le type de
données. Si le type ne donne aucune indication, une longueur maximale configurée par l'utilisateur
est renvoyée.
14.2 Restriction des volumineuses de longueur variable
Restriction :
Ce qui suit concerne uniquement les applications Crystal Reports.
En raison de l'implémentation de la couche d'accès aux données, la taille maximale d'une colonne de
données binaires et de caractères volumineuses de longueur variable est limitée à 16 Mo pour les
sources de données suivantes :
• IBM DB2 via ODBC
• MS SQL Server via ODBC
• Sybase CTL
Si l'utilisateur de l'application insère des données volumineuses de longueur variable supérieures à
16 Mo dans un rapport, la performance du système peut en être affectée.
14.3 Mappage du type de données pour les univers multi-sources
266
2013-09-19
Informations de référence sur la conversion du type de données
Dans le cas d'une fondation de données multi-sources, les types de données du serveur de connexion
sont convertis en types de données fournis via le service de fédération de données.
Les types de données de la fédération de données sont les suivants :
•
•
•
•
•
•
•
•
BIT
DATE
TIME
TIMESTAMP
DOUBLE
DECIMAL
INTEGER
VARCHAR
Ils sont mappés aux types de données de la fondation de données correspondante :
Attention :
Les types BINARY, VARBINARY et LONGVARBINARY ne sont pas pris en charge et les valeurs de
ces types sont mappées à une valeur nulle.
267
2013-09-19
Informations de référence sur la conversion du type de données
268
2013-09-19
Informations supplémentaires
Informations supplémentaires
Ressources d'informations
Emplacement
Informations sur le produit SAP
BusinessObjects
http://www.sap.com
Naviguez vers http://help.sap.com/businessobjects/ et cliquez sur Tous
les produits dans le panneau latéral "Présentation de SAP BusinessObjects".
SAP Help Portal
Vous pouvez accéder à la toute dernière documentation relative aux
produits SAP BusinessObjects et à leur déploiement sur le portail SAP
Help Portal. Il est également possible de télécharger des versions PDF
ou des bibliothèques HTML installables.
Certains guides résident sur SAP Service Marketplace et ne sont, par
conséquent, pas disponibles sur le portail SAP Help Portal. Le portail
d'aide répertorie ces guides et propose un lien vers SAP Service Marketplace. Les clients qui bénéficient d'un contrat de maintenance disposent
d'un ID utilisateur pour accéder à ce site. Pour obtenir un identifiant, contactez votre support technique.
http://service.sap.com/bosap-support > Documentation
•
•
SAP Service Marketplace
269
Guides d'installation : https://service.sap.com/bosap-instguides
Notes de version : http://service.sap.com/releasenotes
SAP Service Marketplace comprend certains guides d'installation, guides
de migration et de mise à niveau, guides de déploiement, notes de version
et des documents concernant les plates-formes prises en charge. Les
clients qui bénéficient d'un contrat de maintenance disposent d'un ID
utilisateur pour accéder à ce site. Pour obtenir un identifiant, contactez
votre support technique. Si vous êtes redirigé vers SAP Service Marketplace à partir du site SAP Help Portal, utilisez le menu situé dans le panneau de navigation à gauche pour sélectionner la catégorie contenant
la documentation que vous souhaitez consulter.
2013-09-19
Informations supplémentaires
Ressources d'informations
Emplacement
https://cw.sdn.sap.com/cw/community/docupedia
Docupedia
Docupedia fournit des ressources de documentation supplémentaires,
un environnement de création collaboratif et un canal de commentaires
interactif.
Ressources à l'attention des développeurs
https://boc.sdn.sap.com/
Articles SAP BusinessObjects sur
SAP Community Network
https://www.sdn.sap.com/irj/boc/businessobjects-articles
https://www.sdn.sap.com/irj/sdn/businessobjects-sdklibrary
Ces articles étaient précédemment appelées notes techniques.
https://service.sap.com/notes
Remarques
Forums sur SAP Community Network
Ces remarques étaient précédemment appelées des articles de la base
de connaissances.
https://www.sdn.sap.com/irj/scn/forums
http://www.sap.com/services/education
Formation
Nous pouvons vous fournir un module de formation qui réponde à vos
besoins et convienne à votre style d'apprentissage préféré, sous forme
de stage traditionnel ou de séminaires plus ciblés.
http://service.sap.com/bosap-support
Support client en ligne
Le site SAP Support Portal présente des informations sur les programmes
et services de support technique. Il propose également des liens vers
de nombreuses informations techniques ainsi que des téléchargements.
Les clients qui bénéficient d'un contrat de maintenance disposent d'un
ID utilisateur pour accéder à ce site. Pour obtenir un identifiant, contactez
votre support technique.
http://www.sap.com/services/bysubject/businessobjectsconsulting
Conseil
270
Les consultants peuvent vous accompagner dans votre démarche, depuis
la phase initiale d'analyse jusqu'à la phase finale de livraison de votre
projet de déploiement. Ils peuvent vous faire bénéficier de leur expertise
en matière de bases de données relationnelles et multidimensionnelles,
de connectivité, d'outils de conception de base de données et de techno
logie d'intégration personnalisée.
2013-09-19
Index
Symboles
_trace.ini, fichier 158
Caractères numériques
64 bits, prise en charge
à propos de 27
environnement UNIX 27
prise en charge Microsoft Windows
28
A
ABAP, fonctions 93
ActiveDataSources, configurer 156
Adaptive Connectivity service 25
aide
cscheck 42
fichiers PRM 226
Amazon EMR HIVE, connexions 120
ANALYTIC_CLAUSE 229
ANALYTIC_FUNCTIONS 230
Apache Hadoop HIVE, connexions 117
architecture 20
architecture système 20
Array Bind Available 182
Array Bind Size 182
Array Fetch disponible 183
B
basculement 123, 129
bases de données
configurer l'accès 156
paramètres de fonctionnalités 223
prendre en charge des procédures
stockées 31
prises en charge 44
sélectionner l'accès à 157
vérifier l'accès 51
bases de données prises en charge
44
BigDecimal, taille d'affichage maximale
185
Binary Max Length 88, 108, 115, 185
Bucket, Split Size 186
271
C
CALCULATION_FUNCTION 230
Capacités du pilote 188
Caractère d'échappement 189
caractère d'échappement, disponible
206
Casse de l'identificateur 191
Chaîne de signal des identificateurs
192
charge, équilibrer 37
Charset List Extension 149
CharSet Table 187
Classpath
créer une connexion JavaBean 64
créer une connexion JDBC 56
clé primaire disponible 208
clés étrangères disponibles 207
CMC 149
colonne étendue, obtenir 207
colonnes d'entrée 91
conception d'information, outil 29
conception d'univers, outil de 29
Config File Extension 150
configuration requise
connexions 41
version minimale de Data
Federator 139
configuration, fichiers 167
à propos de 21
exemple de fichier SBO JavaBean
65
fichier global 22
fichiers SBO installés 168
fichiers spécifiques au pilote 22
connecteurs
SAP NetWeaver BW 136
SAS 138
Connection Server
configurer l'accès aux données
pour les pilotes de marque
DataDirect 177
configurer pour une
connexion ODBC à
Data Federator 141
connectivité, services 25
connectivités prises en charge 46
Connexion partageable 206
Connexion partagée 209
connexion unique 29, 132, 134
Connexion unique disponible 198
connexions
composants de 19
configuration requise pour créer 41
configurer les connexions JDBC
176
créer Data Federator XI 3.0 139
créer des connexions Generic
JDBC 58
créer des connexions Generic
ODBC 67
créer des connexions Generic
ODBC3 68
créer des connexions JDBC avec
des fichiers SBO 56
créer une connexion JavaBean 64
créer une connexion JavaBean
avec Extensions 65
créer une connexion JDBC avec
Extensions 57
connexions JavaBean
créer 64
créer avec Extensions 65
connexions, pools
à propos de 35
à propos des connexions de 35
connexions, valider au moment de
l'exécution 175
CONSTANT_SAMPLING_SUPPORTED
231
conventions 18
couches réseau
prises en charge 44
sélectionner 156
vérifier la connectivité avec le
middleware 50
couches réseau prises en charge 44
Count, fonction 87
Coût estimé disponible 213
Cryptage du mot de passe 218
Crystal Reports 266
cs.cfg, fichier 162
à propos de 22, 147
afficher 148
informations de référence sur les
paramètres de configuration
149
modifier 148
section Capabilities 155
section Library 156
2013-09-19
Index
cscheck
accéder à l'aide 42
accessdriver 49
connectivité 50
driverssearch 45
exécuter 43
liste 44
liste de fonctions 43
middleware 48
ping 51
rechercher 46
syntaxe 43
CSV, fichiers 71
types de données 250
D
Data Federator XI 3.0
à propos de la création de
connexions 139
répertoire d'installation 140
version requise 139
DataDirect 176
DDL, fichiers 74
déploiement, mode 24, 156
Description Extension 150
Description File 187
Dictionary Transaction Mode 188
DISTINCT 231
E
Empty String 213
Enforce Max Protocol Version 211
entrée dsn 141
Enumerator CLSID 216
ERP Max Rows 96, 205
erreur, reprise 219
Essbase, connexions 125
ETAT DU SERVEUR 37
Expiration de la requête disponible 196
EXT_JOIN 232
extension de fichier, configurer 152
Extensions 190
créer une connexion JavaBean 65
créer une connexion JDBC 57
F
Family 190
fichier openrda.ini 141
Fichier SQL externe 197
flux XML, valider 154
Forcer l'exécution 190
FULL_EXT_JOIN 232
272
G
Generic ODBC, source de données
28, 67
Generic ODBC3, source de données
68
GROUP_BY 233
GROUP_BY_SUPPORTS_COLUMN_INDEX
233
GROUP_BY_SUPPORTS_COMPLEX
234
GROUP_BY_SUPPORTS_CONSTANT
235
guide d'accès aux données
à propos de 17
conventions 18
public 17
tâches clés 17
guide, à propos de 17
guide, public concerné 17
H
HAVING 235
HOARD 39
activer 39
désactiver 40
I
IBM DB2
GROUP_BY_SUPPORTS_COMPLEX
234
GROUP_BY_SUPPORTS_CONSTANT
235
SELECT_SUPPORTS_NULL 244
IBM DB2, connexions 120
IBM Informix
SELECT_SUPPORTS_NULL 244
SQLDescribeParam disponible 214
V5toV6DriverName 215
IBM Informix, connexions 121
IBM Red Brick
ANALYTIC_CLAUSE 229
LEFT_OUTER 238
RIGHT_OUTER 243
SELECT_SUPPORTS_NULL 244
Identificateur entre guillemets 219
identificateurs, mise entre guillemets
196
Ignore Driver Load Failure 150
InfoSets 91
installation
fichiers installés 21
répertoire Data Federator 140
installation (suite)
vérifier le pilote d'accès aux
données 49
Integer Max Length 108, 115, 193
INTERSECT 236
INTERSECT_ALL 236
INTERSECT_IN_SUBQUERY 236
Introscope 40
Introscope Available 193
J
JavaBean
à propos des connexions 63
Classe JavaBean 204
Format d'URL 203
JavaBean, classe 204
JavaBean, exemple de fichier SBO 65
javabean.sbo 64
JDBC
à propos des connexions 55
caractère d'échappement
disponible 206
Classe JDBC 208
clé primaire disponible 208
clés étrangères disponibles 207
Connexion partageable 206
Connexion partagée 209
créer des connexions avec des
fichiers SBO 56
créer des connexions avec
Extensions 57
format d'URL 203
générique 58
inclure des synonymes 192
JDBC ResultSet Concurrency 210
JDBC ResultSet Type 209
types de données 251
JDBC ResultSet Concurrency 210
JDBC ResultSet Type 209
JDBC, classe 208
JDBC, connexions
ajouter des propriétés du pilote 176
jdbc.sbo 58
jeu de caractères 212
JNI, utilisation 155
JOIN 237
journaux 158, 165
journaux et traces, lire 163
L
LEFT_EXT_JOIN 237
LEFT_OUTER 238
LIKE_SUPPORTS_ESCAPE_CLAUSE
238
2013-09-19
Index
Native Int64 Available 194
Neoview
jeu de caractères 212
Nombre maximal de lignes disponibles
194
ODBC (suite)
Generic ODBC3 68
ODBC Cursors 214
pilotes DataDirect 176
SQLMoreResults disponible 214
Statut de connexion disponible 212
utiliser le pilote OEM DataDirect
215
ODBC Cursors 214
ODBC, pilotes 29
ODBC, types de données 254
OLAP, connexions 26, 128
OlapClient.cfg, fichier 165
à propos de 148
OLE DB
Enumerator CLSID 216
Provider CLSID 216
types de données 258
OLE DB OLAP
MSOlap CLSID 217
Optimize Execute 195
Oracle
Chaîne de signal des
identificateurs 192
exemple de vérification de la
connectivité 51
inclure des synonymes 192
LEFT_OUTER 238
Optimize Execute 195
procédures stockées 32
RIGHT_OUTER 243
types de données 260
Oracle EBS, connexions 125
Oracle JDBC, connexions 123
Oracle RAC, connexions 125
ORDER_BY 240
ORDER_BY_REQUIRES_SELECT
241
ORDER_BY_SUPPORTS_COLUMN_INDEX
241
O
P
OData, connexions 76, 87
HTTPS 78
performances 85
pilote, fonctionnalités 77
schéma 78
suivi 89
types de données 257
ODBC
à propos des connexions 66
Chaîne vide 213
exposer une couche de base de
données en mode serveur 157
Generic ODBC2 67
paramètres régionaux de visualisation
préférés, disponibles 208
PERCENT_RANK_SUPPORTED 242
performances 85
pilote, nom 189
pilote, paramètres par défaut 147
pilotes d'accès aux données
à propos de 20
configurer les paramètres 167
fichiers CSV 71
fichiers de configuration 167
fichiers PRM 223
fichiers utilisés par 22
Load Drivers On Startup 151
Locales 147
M
macros 34
Max Pool Time 152
Max Rows 87, 96
mémoire, allocation 39
mémoire, utilisation 37
Microsoft Azure, sources de données
89
Microsoft Windows
64 bits 28
middleware
prises en charge 46
vérifier la connectivité avec la
couche réseau 50
vérifier la disponibilité sur un
ordinateur 48
MINUS 239
MINUS_ALL 239
MINUS_IN_SUBQUERY 240
mode bibliothèque 156, 162
mode Bibliothèque 157
mode serveur 156, 163
MS Access
DISCTINCT 231
MS SQL Server 176
MS SQL Server, connexions 122
MSOlap CLSID 217
N
273
pilotes d'accès aux données (suite)
rechercher les pilotes installés 45
sélectionner 156
systèmes SAP ERP 90
vérifier la disponibilité sur un
ordinateur 49
pilotes de marque 176
pilotes Java 55
pilotes, comportement 218
pilotes, exemples 20
PRM, fichiers
à propos de 223
à propos du texte d'aide des
fonctions 226
modifier 225
modifier le texte d'aide 226
structure 224
visualiser 225
procédures stockées
à propos de 31
à propos des connexions
JavaBean 63
contraintes 32
créer Oracle 33
Oracle 32
SAP HANA 34
Teradata 34
propriétaires, disponibles 195
Provider CLSID 216
PVL 90, 129
Q
Qualificateurs disponibles 195
R
RANK_SUPPORTED 242
Replace Current Owner With Database
220
requêtes SAP 91
rétrocompatibilité 39, 71
RIGHT_EXT_JOIN 243
RIGHT_OUTER 243
S
salesforce.com, connexions 126
SAML 29, 129
SAP BW, connexions 128
SAP ERP, connexions 90, 128, 205
types de données 261
SAP HANA, connexions 129, 197
procédures stockées 34
SAP MaxDB, connexions 136
2013-09-19
Index
SAP NetWeaver BW, connexions 136
SAP NetWeaver Gateway 76, 87
SAS, connexions 138
SBO, fichiers
afficher 174
configurer une connexion
JavaBean avec Extensions 65
configurer une connexion JDBC
avec ClassPath 56
configurer une connexion JDBC
avec Extensions 57
installé 168
modifier 174
paramètres des bases de données
179
paramètres par défaut 179
personnaliser 174, 175
structure 179
vérification de la connexion 175
SEED_SAMPLING_SUPPORTED 244
SELECT_SUPPORTS_NULL 244
Séparateur de catalogue 186
serveur de connexion
lire les journaux et traces 163
Serveur de connexion
à propos des paramètres globaux
147
activité des workflows 40
configuration du mode de
déploiement 156
configurer les paramètres globaux
149
configurer pour un déploiement
complexe 156
définir les protocoles en mode
serveur 157
définition 19
mémoire 39
mode de déploiement 24
prise en charge 64 bits 27
procédures stockées 32
sélectionner le mode de
déploiement 155
tracer en mode bibliothèque 162
tracer en mode serveur 163
service de connectivité, natif 25
services Web, connexions 108
services Web, type de données 265
Settings 147
Skip SAML SSO 197
SMB 74
source de données, Generic JDBC 58
274
SQL External Extension 153
SQL Parameter Extension 153
SQL Parameter File 198
SQL Server
GROUP_BY_SUPPORTS_CONSTANT
235
LEFT_OUTER 238
RIGHT_OUTER 243
SQL Server Analysis Services,
connexions 122
SQLDDL, fichiers 74
SQLDescribeParam disponible 214
SQLMoreResults disponible 214
SSL 129
SSO
configurer pour l'outil de conception
d'information 132
configurer pour Web Intelligence
134
configurer pour Web Intelligence
Rich Client 134
sources de données prises en
charge 29
Statut de connexion disponible 212
Strategies Extension 154
Strategies File 199
String Max Length 88, 108, 115, 199
SUBQUERY_IN_FROM 245
SUBQUERY_IN_IN 245
SUBQUERY_IN_WHERE 245
Sybase
comportement des pilotes 218
Cryptage du mot de passe 218
exemple de vérification de la
connectivité 51
Identificateur entre guillemets 219
LEFT_OUTER 238
reprise sur erreur 219
RIGHT_OUTER 243
types de données 263
synonymes, inclure 192
T
tâches clés 17
Taille de l'Array fetch 96, 183
Taille maximale des données XML 204
TECHNICAL_COLUMN_NAME_PATTERN
246
Temp Data Dir 200
Teradata
ANALYTIC_CLAUSE 229
Teradata (suite)
Coût estimé disponible 213
macros 34
procédures stockées 34
SELECT_SUPPORTS_NULL 244
Teradata, connexions 138
texte, taille 219
traces 147, 158, 165
transaction, mode disponible 121,
127, 201
Type 202
types de données
fichiers CSV 250
JDBC 251
OData 257
ODBC 254
OLE DB 258
Oracle OCI 260
SAP ERP 261
services Web 265
Sybase 263
XML 265
types de données, convertir 249
U
Unicode 202
UNION 246
UNION_ALL 247
UNION_IN_SUBQUERY 247
univers, sources multiples 266
UNIX
64 bits 27
URL, format 203
utiliser le pilote OEM DataDirect 215
V
V5toV6DriverName 215
Validate Configuration Files 154
vérification de la connexion 175
W
workflow, activité 40
X
XI 3.x, versions 55
XML, connexions 96
XML, types de données 265
2013-09-19
">