Yhteyksien ja tietolähteiden luominen yleisille JDBC-ajureille

Voit tämän työnkulun avulla antaa Essbasen luoda yhteys mihin tahansa JDBC-tietolähteeseen ajureilla, jotka ladataan Essbase-palvelimelle.

Jos olet Essbase-käyttöönoton järjestelmänvalvoja, voit konfiguroida Essbasen käyttämään ensisijaisia Essbase-palvelinkoneelle lataamiasi ajureita. Oracle on testannut Essbase JDBC -yhteyden Oraclen ajureilla. Jos haluat käyttää muiden toimittajien JDBC-ajureita, tarkista käyttämäsi JDBC-tietolähteen URL-osoitteen ja valtuuksien määrittelyn vaatimukset ajurin dokumentaatiosta. Katso suorituskykyyn liittyvien vaiheiden tiedot toimittajan JDBC-dokumentaatiosta.

Konfiguroi Essbase yleisten JDBC-ajurien käyttöä varten seuraavasti:

1. Luo yhteys Essbase-palvelinkoneeseen SSH-avaimen avulla.

2. Luo ajurien hakemisto manuaalisesti <Essbase- tuotteen kotisivulla>palvelininstanssissa.

   Varmista, että drivers on kirjoitettu kokonaan pienillä kirjaimilla, sillä polku on kirjainkoosta riippuvainen.

3. Lataa toimittajasivustolta haluamasi JDBC-ajurin JAR:t.

   Oracle Databasen JDBC-ajuri, jota Essbase tukee, on ojdbc8.jar.

   Jos käytät Autonomous Data Warehousea, on ladattava koko arkisto (ojdbc8-full.tar.gz), joka sisältää suppean Oracle JDBC -ajurin sekä liittyvät JAR:t.

4. Lataa JDBC-ajurin JAR:t drivers-hakemistoon Essbase-instanssissa.

   Lataa vain yksi versio kustakin tietokanta-ajurista drivers-hakemistoon. Älä esimerkiksi lataa sekä sqljdbc41.jar- että sqljdbc42.jar-versiota tai muutoin Essbase käyttää niistä vanhempaa (sillä se näkyy ensimmäisenä polulla CLASSPATH).

   Jos käytät Autonomous Data Warehousea, poimi arkisto (ojdbc8-full.tar.gz) ja siirrä koko sisältö suoraan drivers-hakemistoon (ei alikansioon).

5. Luo yhteydet JDBC-ajureille.

   1. Valitse Essbase-verkkokäyttöliittymässä Lähteet ja Yhteydet.

      Tai jos haluat määrittää yhteyden ja tietolähteen yleisen tason sijaan sovellustasolla, aloita Sovellukset-sivulta, älä Lähteet-sivulta, napsauta sovelluksen nimeä ja valitse sitten Lähteet.

   2. Valitse Luo yhteys ja sitten JDBC.

      Essbase hakee JDBC-ajuria drivers-kansiosta. Jos jar-tiedostoja ei löydy, Essbase palauttaa Luokkaa ei löytynyt (tai Ajurin lataus epäonnistui) -virheen yhteyttä testattaessa.

   3. Luo yhteys-näytössä

      1. Anna JDBC-yhteyden nimi. Esimerkiksi Oracle JDBC.

      2. Anna JDBC-yhteysmerkkijono URL-kenttään. Esimerkiksi jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com. Pyydä JDBC-yhteysmerkkijono JDBC:n toimittajalta.

         Edellä esitetty syntaksimuoto koskee vain Oracle-tietokantaa. Katso kohta Lisäesimerkkejä yleisten JDBC-ajurien yhteyksistä, jos käytät muita palveluntarjoajia.

      3. Anna Käyttäjä- ja Salasana-kenttiin sen käyttäjän tiedot, jolla on valtuudet käyttää tietokantaa.

      4. Anna Ajuri-kenttään JDBC-ajurin täydellinen luokkanimi. Esimerkiksi oracle.jdbc.driver.OracleDriver.

      
      
      
      
      

      Määritä Oracle-ajureille URL-osoite seuraavien syntaksiohjeiden mukaisesti:

      • Jos Oracle Databaselle on rekisteröity kuuntelija, voit käyttää URL-osoitteen palvelun nimeä SID:n sijaan lyhyen syntaksin mukaisesti jdbc:oracle:thin:@<host>:<port>/<servicename>. Esimerkki:

        jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com

      • Seuraavassa esimerkissä käytetään palvelun nimen pitkää syntaksia.

        jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(host=myserver.example.com)(protocol=tcp)(port=1521))(CONNECT_DATA=(SERVICE_NAME=orclpdb.example.com)))

      • Jos haluat käyttää tietokannan yksilöivää Oraclen järjestelmätunnusta (SID), käytä syntaksia jdbc:oracle:thin:@<host>:<port>:<SID>. Esimerkiksi

        jdbc:oracle:thin:@myhost:1521:orcl

      • Jos käytät Autonomous Data Warehousea, URL-syntaksissa on oltava mukana TNS_ADMIN-ympäristömuuttuja, jolla määritetään lompakon polku. Lompakko voi olla missä tahansaEssbase-palvelinkoneella, mutta sille on annettava koko polku käyttämällä syntaksia, joka voi olla esimerkiksi tällainen: jdbc:oracle:thin:@database_service_name?TNS_ADMIN=walletpath.

        Linux-esimerkki

        jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/scratch/oracle_home/dist/essbase/drivers/adwConn

        Windows-esimerkki

        jdbc:oracle:thin:@adwsql_low?TNS_ADMIN="C:\\Oracle123\\Middleware\\Oracle_Home\\essbase\\drivers\\adwConn"

        Esimerkki OCI-käyttöönotosta

        jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/u01/data/essbase/catalog/users/firstname.lastname@example.com/adwconn

      Edellä annetut esimerkit toimivat ainoastaan Oracle-tietokannassa. Katso kohta Lisäesimerkkejä yleisten JDBC-ajurien yhteyksistä, jos käytät muita palveluntarjoajia.

   4. Tarkista yhteys valitsemalla Testi, ja jos yhteys toimii, valitse Luo.

   5. Tarkista, että yhteyden luonti onnistui ja että se näkyy yhteyslistassa.

6. Luo tietolähteet yleisten JDBC-ajuriyhteyksien avulla.

   1. Valitse Tietolähteet ja sitten Luo tietolähde.

   2. Valitse avattavasta Yhteys-valikosta juuri luomasi yhteyden nimi, kuten Oracle JDBC. Sovellustason yhteyksiin lisätään etuliitteenä sovelluksen nimi muodossa sovelluksenNimi.yhteydenNimi.

   3. Anna tietolähteelle nimi, kuten OracleDB_Datasource.

   4. Voit halutessasi syöttää tietolähteen kuvauksen, esimerkiksi SAMPLE_BASIC_TABLE Oracle-tietokannalle.

   5. Määritä kyselykenttään asianmukainen SQL-kysely, jolla valitaan tälle tietolähteelle käytettäväksi asetettavat tiedot.

   6. Valitse Seuraava. Jos SQL-lause oli oikea kyselyn suorittamiseen, kyselyyn liittyvien sarakkeet täytetään.

   7. Vaihda numeeriset sarakkeet kaksinkertaisiksi ja valitse Seuraava.

   8. Vaihda mahdolliset lähdekohtaiset lisäparametrit ja valitse Seuraava. Lisätietoja parametrien käytöstä on kohdassa Tietolähteiden parametrien toteutus.

   9. Tarkista esikatselupaneeli. Näkyviin pitäisi tulla kyselyn tulokset, kun haetaan tietosarakkeita ulkoisesta lähteestä.

   10. Jos esikatselu näyttää oikealta, viimeistele tietolähteen luonti valitsemalla Luo.