Creaţi conexiuni şi surse de date pentru driverele JDBC generice

Utilizaţi acest flux de lucru pentru a permite Essbase să se conecteze la orice sursă de date JDBC, utilizând driverele pe care le încărcaţi pe serverul Essbase.

Dacă sunteţi administratorul de implementare Essbase, puteţi configura Essbase pentru a utiliza driverele pe care le preferaţi, pe care le încărcaţi pe maşina serverului Essbase. Oracle a testat conectivitatea JDBC Essbase utilizând driverele Oracle. Pentru utilizarea driverelor JDBC de la alţi furnizori, verificaţi documentaţia driverelor pentru cerinţe privind specificarea adresei URL şi a acreditărilor pentru sursa de date JDBC. Pentru paşii privind performanţele, consultaţi documentaţia JDBC pentru furnizori.

Notă:

Asiguraţi-vă că driverul JDBC pe care îl utilizaţi cu Essbase respectă cerinţele din metoda setFetchSize de control al memoriei, utilizată la procesarea setului de rezultate. Pentru performanţe optime privind procesele de încărcare a datelor şi de generare a dimensiunilor, Essbase preia 1000 de înregistrări per apel prin reţea.

Pentru a configura Essbase pentru utilizarea driverelor JDBC generice,

Conectaţi-vă la maşina serverului Essbase utilizând SSH.
Creaţi manual un director drivers în <Home Produse Essbase> pe instanţa serverului.

Verificaţi ca drivers să fie scris cu litere mici, deoarece calea ţine cont de litere mari/mici.
De pe site-ul furnizorului dvs., descărcaţi fişierele JAR pentru driverele JDBC pe care doriţi să le utilizaţi.

Driverul JDBC pentru baza de date Oracle acceptat de Essbase este ojdbc8.jar.

Dacă utilizaţi Autonomous Data Warehouse, trebuie să descărcaţi arhiva integrală (ojdbc8-full.tar.gz) ce conţine driverul Oracle JDBC Thin şi fişierele JAR asociate.
Încărcaţi fişierele JAR pentru driverul JDBC în directorul drivers de pe instanţa Essbase.

Încărcaţi doar o singură versiune a fiecărui driver de bază de date în directorul drivers. De exemplu, nu încărcaţi şi sqljdbc41.jar şi sqljdbc42.jar, sau Essbase îl va utiliza pe cel mai vechi (deoarece apare primul în CLASSPATH).

Dacă utilizaţi Autonomous Data Warehouse, extrageţi arhiva (ojdbc8-full.tar.gz) şi mutaţi tot conţinutul direct în directorul drivers (şi nu un subfolder).
Creaţi conexiuni la driverele JDBC.
1. În interfaţa web Essbase, faceţi clic pe Surse, apoi pe Conexiuni.
  
  Sau, pentru a defini conexiunea şi sursa de date la nivel de aplicaţie, nu global, începeţi din pagina Aplicaţii, nu din pagina Surse, faceţi clic pe numele unei aplicaţii şi apoi pe Surse.
2. Faceţi clic pe Creare conexiune şi selectaţi JDBC.
  
  Pentru a găsi driverul JDBC, Essbase caută în folderul drivers. Dacă nu sunt găsite fişiere jar, Essbase returnează o eroare Clasă negăsită (sau eroare la încărcarea driverului) atunci când testaţi conexiunea.
3. În ecranul Creare conexiune,
  1. Furnizaţi un nume pentru conexiunea JDBC. De exemplu, Oracle JDBC.
  2. În câmpul URL, furnizaţi şirul de conectare JDBC. De exemplu, jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com. Obţineţi şirul de conectare JDBC de la furnizorul JDBC.
    
    Formatul sintaxei de mai sus se aplică numai pentru Oracle Database. Consultaţi Mai multe exemple de conexiune pentru driverele JDBC generice dacă lucraţi cu alţi furnizori.
  3. Pentru câmpurile Utilizator şi Parolă, introduceţi acreditările pentru un utilizator care este autorizat pentru accesarea bazei de date.
  4. În câmpul Driver, introduceţi numele calificat integral al clasei pentru driverul JDBC. De exemplu, oracle.jdbc.driver.OracleDriver.
  Pentru driverele Oracle, specificaţi URL-ul utilizând următoarele instrucţiuni pentru sintaxă:
  - Dacă baza de date Oracle este înregistrată cu un listener, puteţi utiliza numele de serviciu în URL în loc de SID, utilizând sintaxa prescurtată jdbc:oracle:thin:@<host>:<port>/<servicename>. Exemplu:
```
jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com
```
  - Exemplul următor utilizează numele de serviciu cu sintaxa lungă.
```
jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(host=myserver.example.com)(protocol=tcp)(port=1521))(CONNECT_DATA=(SERVICE_NAME=orclpdb.example.com)))
```
  - Pentru a utiliza ID sistemului Oracle (SID) care identifică în mod unic baza de date utilizaţi sintaxa jdbc:oracle:thin:@<host>:<port>:<SID>. De exemplu,
```
jdbc:oracle:thin:@myhost:1521:orcl
```
  - Dacă utilizaţi Autonomous Data Warehouse, în sintaxa URL, trebuie să includeţi variabila de mediu TNS_ADMIN specificând calea către wallet. Walletul poate fi oriunde pe maşina serverului Essbase, dar trebuie să furnizaţi calea integrală, utilizând o sintaxă precum jdbc:oracle:thin:@database_service_name?TNS_ADMIN=walletpath.
    
    Exemplu pentru Linux
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/scratch/oracle_home/dist/essbase/drivers/adwConn
```
    Exemplu pentru Windows
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN="C:\\Oracle123\\Middleware\\Oracle_Home\\essbase\\drivers\\adwConn"
```
    Exemplu pentru o implementare OCI
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/u01/data/essbase/catalog/users/firstname.lastname@example.com/adwconn
```
  Exemplele de mai sus funcţionează numai pentru Oracle Database. Consultaţi Mai multe exemple de conexiune pentru driverele JDBC generice dacă lucraţi cu alţi furnizori.
4. Faceţi clic pe Testare ca să validaţi conexiunea, iar dacă validarea se efectuează cu succes, faceţi clic pe Creare.
5. Verificaţi dacă a fost creată cu succes conexiune şi dacă apare în lista de conexiuni.
Creaţi surse de date prin conexiunile driverelor JDBC generice.
1. Faceţi clic pe Surse de date, apoi pe Creare sursă de date.
2. Din caseta listă derulantă Conexiune, selectaţi numele conexiunii pe care aţi creat-o; de exemplu, Oracle JDBC. Conexiunile la nivel de aplicaţie au ca prefix numele aplicaţiei, în formatul appName.connectionName.
3. Introduceţi un nume pt. sursa de date; de exemplu, OracleDB_Datasource.
4. Opţional, introduceţi o descriere a sursei de date; de exemplu, SAMPLE_BASIC_TABLE în baza de date Oracle.
5. În câmpul Interogare, introduceţi interogarea SQL adecvată, care să selecteze datele pe care doriţi să le puneţi la dispoziţie în această sursă de date.
6. Faceţi clic pe Înainte. Dacă instrucţiunea SQL a fost scrisă corect pentru a interoga un tabel, sunt completate coloanele interogate.
7. Setaţi coloanele numerice la Dublu, apoi faceţi clic pe Înainte.
8. Dacă este cazul, schimbaţi parametrii sursei, apoi faceţi clic pe Înainte. Pentru informaţii despre utilizarea parametrilor, consultaţi Implementare parametri pentru sursele de date.
9. Verificaţi datele în panoul de previzualizare. Ar trebui să vedeţi rezultatele interogării care a preluat coloanele de date din sursa externă.
10. Dacă previzualizarea arată cum trebuie, faceţi clic pe Creare pt. a finaliza crearea sursei de date.