Verbindingen en gegevensbronnen maken voor algemene JDBC-drivers

Gebruik deze workflow om het mogelijk te maken dat Essbase verbinding maakt met een JDBC-gegevensbron door gebruik te maken van de drivers die u naar de Essbase Server uploadt.

Als u de beheerder van een Essbase implementatie bent, kunt u Essbase configureren om uw voorkeursdrivers te gebruiken die u uploadt naar de Essbase servercomputer. Oracle heeft de Essbase JDBC-connectiviteit getest met Oracle drivers. Als u JDBC-drivers van andere leveranciers wilt gebruiken, raadpleegt u de documentatie bij de drivers voor vereisten voor het opgeven van de URL en referenties van uw JDBC-gegevensbron. Bekijk voor prestatiegerelateerde stappen de JDBC-documentatie van de leverancier.

Opmerking:

Zorg dat de JDBC-driver die u gebruikt met Essbase de methode setFetchSize gebruikt voor het controleren van de hoeveelheid geheugen die wordt gebruikt bij het verwerken van de resultatenset. Voor optimale prestaties van processen voor gegevens laden en dimensies maken, haalt Essbase 1000 records op per netwerkaanroep.

Als u Essbase wilt configureren om algemene JDBC-drivers te gebruiken,

Maak verbinding met de Essbase servercomputer met behulp van SSH.
Maak handmatig een directory drivers in <Startpagina Essbase> op de server-instance.

Gebruik alleen kleine letters voor drivers aangezien het pad hoofdlettergevoelig is.
Download op de site van de leverancier de JAR-bestanden voor de JDBC-drivers die u wilt gebruiken.

De Oracle Database JDBC-driver die wordt ondersteund door Essbase, is ojdbc8.jar.

Als u Autonomous Data Warehouse gebruikt, moet u het volledige archief (ojdbc8-full.tar.gz) met de Oracle JDBC Thin driver en bijbehorende JAR-bestanden downloaden.
Upload de JAR-bestanden voor de JDBC-drivers naar de directory drivers of de Essbase instance.

Upload slechts één versie van elke databasedriver naar de directory drivers. Upload bijvoorbeeld niet zowel sqljdbc41.jar als sqljdbc42.jar, anders gebruikt Essbase de oudste versie (aangezien deze als eerste voorkomt in CLASSPATH).

Als u Autonomous Data Warehouse gebruikt, extraheert u het archief (ojdbc8-full.tar.gz) en verplaatst u alle inhoud rechtstreeks naar de directory drivers (geen submap).
Maak verbindingen met de JDBC-drivers.
1. Klik in de Essbase webinterface op Bronnen en daarna op Verbindingen.
  
  Of begin op de pagina 'Applicaties' in plaats van op de pagina 'Bronnen' als u de verbinding en gegevensbron op applicatieniveau wilt definiëren in plaats van op algemeen niveau. Klik hiervoor op een applicatienaam en klik vervolgens op Bronnen.
2. Klik op Verbinding maken en selecteer JDBC.
  
  Essbase zoekt de JDBC-driver in de map drivers. Als er geen JAR-bestanden worden gevonden, retourneert Essbase de fout 'Klasse niet gevonden' of wordt er gemeld dat de driver niet kan worden geladen wanneer u de verbinding test.
3. In het scherm Verbinding maken
  1. Geef een naam op voor de JDBC-verbinding. Bijvoorbeeld Oracle JDBC.
  2. Geef in het veld 'URL' de JDBC-verbindingsstring op. Bijvoorbeeld jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com. Verkrijg de JDBC-verbindingsstring van de JDBC-provider.
    
    De bovenstaande notatie is alleen van toepassing op Oracle Database. Zie Meer voorbeelden van verbindingen voor generieke JDBC-drivers als u andere leveranciers gebruikt.
  3. Voer voor de velden 'Gebruiker' en 'Wachtwoord' de referenties in voor een gebruiker die toegang tot de database heeft.
  4. Geef in het veld 'Driver' de volledig gekwalificeerde klassenaam van de JDBC-driver op. Bijvoorbeeld oracle.jdbc.driver.OracleDriver.
  Geef voor Oracle drivers de URL op met behulp van de richtlijnen voor de syntaxis:
  - Als Oracle Database is geregistreerd bij een listener, kunt u Service Name in de URL gebruiken in plaats van de SID met de korte syntaxis jdbc:oracle:thin:@<host>:<port>/<servicename>. Voorbeeld:
```
jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com
```
  - In het volgende voorbeeld wordt Service Name met de lange syntaxis gebruikt.
```
jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(host=myserver.example.com)(protocol=tcp)(port=1521))(CONNECT_DATA=(SERVICE_NAME=orclpdb.example.com)))
```
  - Als u de Oracle System ID (SID) wilt gebruiken die de database op unieke wijze aanduidt, gebruikt u de syntaxis jdbc:oracle:thin:@<host>:<port>:<SID>. Bijvoorbeeld
```
jdbc:oracle:thin:@myhost:1521:orcl
```
  - Als u Autonomous Data Warehouse gebruikt, moet u in de URL-syntaxis de omgevingsvariabele TNS_ADMIN opnemen waarmee het pad naar de wallet wordt opgegeven. De wallet kan zich overal op de Essbase servercomputer bevinden, maar u moet het volledige pad opgeven met syntaxis zoals jdbc:oracle:thin:@database_service_name?TNS_ADMIN=walletpath.
    
    Linux-voorbeeld
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/scratch/oracle_home/dist/essbase/drivers/adwConn
```
    Windows-voorbeeld
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN="C:\\Oracle123\\Middleware\\Oracle_Home\\essbase\\drivers\\adwConn"
```
    Voorbeeld voor een OCI-implementatie
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/u01/data/essbase/catalog/users/firstname.lastname@example.com/adwconn
```
  De bovenstaande voorbeelden werken alleen voor Oracle Database. Zie Meer voorbeelden van verbindingen voor generieke JDBC-drivers als u andere leveranciers gebruikt.
4. Klik op Testen om de verbinding te valideren, en als deze goed is, klikt u op Maken.
5. Controleer of de verbinding is gemaakt en in de lijst met verbindingen wordt weergegeven.
Maak gegevensbronnen via de algemene JDBC-driververbindingen.
1. Klik op Gegevensbronnen en daarna op Gegevensbron maken.
2. Selecteer in het vervolgmenu Verbinding de naam van de verbinding die u zojuist hebt gemaakt, bijvoorbeeld Oracle JDBC. Verbindingen op applicatieniveau worden vooraf gegaan door de applicatienaam in de indeling applicatienaam.verbindingsnaam.
3. Geef een naam op voor de gegevensbron, bijvoorbeeld OracleDB_Datasource.
4. Voer desgewenst een omschrijving van de gegevensbron in, bijvoorbeeld SAMPLE_BASIC_TABLE in Oracle Database.
5. Geef in het veld 'Zoekvraag' de juiste SQL-zoekvraag op waarmee de gegevens worden geselecteerd die u in deze gegevensbron beschikbaar wilt maken.
6. Klik op Volgende. Als het SQL-statement voor het uitvoeren van de zoekvraag op een tabel correct is, worden de doorzochte kolommen gevuld.
7. Wijzig eventuele numerieke kolommen in 'Dubbel' en klik op Volgende.
8. Wijzig eventuele aanvullende bronspecifieke parameters, indien van toepassing, en klik op Volgende. Zie voor informatie over parametergebruik Parameters voor gegevensbronnen implementeren.
9. Bekijk het paneel met het voorbeeld. U moet de resultaten van de zoekvraag zien waarmee kolommen met gegevens uit de externe bron worden opgehaald.
10. Als het voorbeeld er goed uitziet, klikt u op Maken om het maken van de gegevensbron te voltooien.