Créer des connexions et des sources de données pour des pilotes JDBC génériques

Utilisez ce flux de travail pour permettre à Essbase de se connecter à n'importe quelle source de données JDBC, en utilisant des pilotes que vous chargez sur le serveur Essbase.

Si vous êtes l'administrateur du déploiement d'Essbase, vous pouvez configurer Essbase de façon à utiliser vos pilotes préférés chargés sur la machine serveur Essbase. Oracle a testé la connectivité JDBC d'Essbase en utilisant des pilotes Oracle. Pour utiliser un pilote JDBC d'un autre fournisseur, consultez la documentation du pilote afin de savoir comment spécifier l'URL et les données d'identification de votre source de données JDBC. Pour les étapes liées à la performance, voir la documentation portant sur le pilote JDBC du fournisseur.

Note :

Assurez-vous que le pilote JDBC que vous utilisez avec Essbase respecte la méthode setFetchSize pour le contrôle de la mémoire utilisée lors du traitement du jeu de résultats. Pour optimiser la performance des processus de chargement de données et de création de dimension, Essbase extrait 1 000 enregistrements par appel de réseau.

Pour configurer Essbase de façon à utiliser des pilotes JDBC génériques,

Connectez-vous à la machine serveur Essbase à l'aide du protocole SSH.
Créez manuellement un répertoire drivers dans le <répertoire de base du produit Essbase> sur l'instance de serveur.

Vérifiez que drivers est en minuscules, car le chemin est sensible à la casse.
Sur le site de votre fournisseur, téléchargez les fichiers JAR du pilote JDBC que vous souhaitez utiliser.

Le pilote JDBC Oracle Database pris en charge par Essbase est ojdbc8.jar.

Si vous utilisez Autonomous Data Warehouse, vous devez télécharger l'archive complète (ojdbc8-full.tar.gz) contenant le pilote JDBC léger d'Oracle et les fichiers JAR qui l'accompagnent.
Chargez les fichiers jar du pilote JDBC dans le répertoire drivers sur l'instance Essbase.

Chargez une seule version de chaque pilote de base de données dans le répertoire drivers. Par exemple, ne chargez pas à la fois sqljdbc41.jar et sqljdbc42.jar, sinon Essbase utilisera le plus ancien (car c'est celui qui apparaît en premier dans CLASSPATH).

Si vous utilisez Autonomous Data Warehouse, extrayez l'archive (ojdbc8-full.tar.gz) et déplacez tout son contenu directement dans le répertoire drivers (pas dans un sous-dossier).
Créez des connexions aux pilotes JDBC.
1. Dans l'interface Web d'Essbase, cliquez sur Sources, puis sur Connexions.
  
  Ou, pour définir la connexion et la source de données au niveau de l'application plutôt que globalement, partez de la page Applications au lieu de la page Sources, cliquez sur le nom d'une application, puis sur Sources.
2. Cliquez sur Créer une connexion et sélectionnez JDBC.
  
  Pour trouver le pilote JDBC, Essbase cherche dans le dossier drivers. Si aucun fichier jar n'est trouvé, Essbase retourne une erreur Classe introuvable (ou un échec de chargement du pilote) lorsque vous testez la connexion.
3. Dans l'écran Créer une connexion,
  1. Indiquez le nom de la connexion JDBC. Par exemple, Oracle JDBC.
  2. Dans le champ URL, indiquez la chaîne de connexion JDBC. Par exemple, jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com. Obtenez la chaîne de connexion JDBC auprès du fournisseur JDBC.
    
    Le format de syntaxe ci-dessus s'applique uniquement à Oracle Database. Consultez Autres exemples de connexion pour les pilotes JDBC génériques si vous utilisez d'autres fournisseurs.
  3. Pour les champs Utilisateur et Mot de passe, entrez les données d'identification d'un utilisateur autorisé à accéder à la base de données.
  4. Dans le champ Pilote, indiquez le nom de classe complet du pilote JDBC. Par exemple, oracle.jdbc.driver.OracleDriver.
  Pour les pilotes Oracle, spécifiez l'URL en respectant la syntaxe suivante :
  - Si Oracle Database est enregistré avec un module d'écoute, vous pouvez utiliser le nom de service dans l'URL au lieu du SID, selon la syntaxe courte jdbc:oracle:thin:@<host>:<port>/<servicename>. Exemple :
```
jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com
```
  - L'exemple suivant utilise le nom de service avec une syntaxe longue.
```
jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(host=myserver.example.com)(protocol=tcp)(port=1521))(CONNECT_DATA=(SERVICE_NAME=orclpdb.example.com)))
```
  - Pour utiliser l'ID système Oracle (SID) qui identifie de manière unique la base de données, utilisez la syntaxe jdbc:oracle:thin:@<host>:<port>:<SID>. Par exemple,
```
jdbc:oracle:thin:@myhost:1521:orcl
```
  - Si vous utilisez Autonomous Data Warehouse, vous devez inclure, dans la syntaxe de l'URL, la variable d'environnement TNS_ADMIN spécifiant le chemin vers le portefeuille. Le portefeuille peut se trouver n'importe où sur la machine serveur Essbase. Vous devez toutefois indiquer le chemin complet, avec une syntaxe de type jdbc:oracle:thin:@database_service_name?TNS_ADMIN=walletpath.
    
    Exemple Linux
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/scratch/oracle_home/dist/essbase/drivers/adwConn
```
    Exemple Windows
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN="C:\\Oracle123\\Middleware\\Oracle_Home\\essbase\\drivers\\adwConn"
```
    Exemple sur un déploiement OCI
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/u01/data/essbase/catalog/users/firstname.lastname@example.com/adwconn
```
  Les exemples ci-dessus fonctionnent uniquement pour Oracle Database. Consultez Autres exemples de connexion pour les pilotes JDBC génériques si vous utilisez d'autres fournisseurs.
4. Cliquez sur Tester pour valider la connexion, et si elle a réussi, cliquez sur Créer.
5. Vérifiez que la connexion a bien été créée et qu'elle apparaît dans la liste des connexions.
Créez des sources de données sur les connexions de pilote JDBC génériques.
1. Cliquez sur Sources de données, puis cliquez sur Créer une source de données.
2. Dans la liste déroulante Connexion, sélectionnez le nom de la connexion que vous venez de créer; par exemple, Oracle JDBC. Les connexions de niveau application sont préfixées avec le nom de l'application, au format nomApplication.nomConnexion.
3. Donnez un nom à la source de données; par exemple, OracleDB_Datasource.
4. Entrez éventuellement une description de la source de données; par exemple SAMPLE_BASIC_TABLE on Oracle Database.
5. Dans le champ Interrogation, indiquez l'interrogation SQL appropriée qui sélectionne les données que vous voulez rendre disponibles dans cette source de données.
6. Cliquez sur Suivant. Si l'énoncé SQL était correct pour l'interrogation d'une table, les colonnes interrogées sont alimentées.
7. Affectez l'attribut Double aux colonnes numériques, et cliquez sur Suivant.
8. Modifiez d'éventuels paramètres propres à la source, le cas échéant, et cliquez sur Suivant. Pour plus d'informations sur l'utilisation des paramètres, voir Mettre en œuvre des paramètres pour les sources de données.
9. Vérifiez le panneau de prévisualisation. Vous devriez voir les résultats de l'interrogation extrayant des colonnes de données de la source externe.
10. Si la prévisualisation semble correcte, cliquez sur Créer pour terminer la création de la source de données.