Vytvorenie pripojení a dátových zdrojov pre všeobecné ovládače JDBC

Pomocou tohto postupu umožníte službe Essbase pripojiť sa k ľubovoľnému dátovému zdroju JDBC prostredníctvom ovládačov, ktoré nahráte na server Essbase.

Ak ste administrátor nasadenia Essbase, môžete službu Essbase konfigurovať tak, aby používala preferované ovládače, ktoré nahráte na server Essbase. Spoločnosť Oracle testovala pripojenie JDBC služby Essbase pomocou ovládačov Oracle. Ak chcete používať ovládače JDBC od iných dodávateľov, v dokumentácii ovládača skontrolujte požiadavky na zadanie adresy URL a dokladov dátového zdroja JDBC. Všetky kroky súvisiace s výkonom nájdete v dokumentácii dodávateľa JDBC.

Poznámka:

Uistite sa, že ovládač JDBC, ktorý používate s Essbase, rešpektuje metódu setFetchSize na riadenie pamäte použitej pri spracovaní množiny výsledkov. Pre optimálny výkon procesov zavedenia dát a vytvorenia dimenzií načítava Essbase 1 000 záznamov na jedno sieťové volanie.

Ako konfigurovať Essbase na použitie generických ovládačov JDBC:

Pripojte sa na server Essbase pomocou kľúča SSH.
Manuálne vytvorte adresár drivers na <domovskej stránke produktu Essbase> v inštancii servera.

Skontrolujte, či je celý výraz drivers napísaný malými písmenami, pretože v ceste sa rozlišujú veľké a malé písmená.
Na lokalite dodávateľa si stiahnite súbory JAR ovládača JDBC, ktoré chcete použiť.

Ovládač JDBC databázy Oracle podporovaný službou Essbase je ojdbc8.jar.

Ak používate databázu Autonomous Data Warehouse, je potrebné stiahnuť celý archív (ojdbc8-full.tar.gz) obsahujúci ovládač Oracle JDBC Thin a pomocné súbory JAR.
Nahrajte súbory JAR ovládača JDBC do adresára drivers v inštancii Essbase.

Nahrajte len jednu verziu každého ovládača databázy do adresára drivers. Napríklad nenahrávajte súbor sqljdbc41.jar aj sqljdbc42.jar, pretože služba Essbase použije starší z nich (ktorý sa zobrazuje ako prvý v CLASSPATH).

Ak používate databázu Autonomous Data Warehouse, extrahujte archív (ojdbc8-full.tar.gz) a presuňte celý obsah priamo do adresára drivers (nie do podpriečinka).
Vytvorte pripojenia k ovládačom JDBC.
1. Vo webovom rozhraní Essbase kliknite na položku Zdroje a potom na položku Pripojenia.
  
  Alebo ak chcete pripojenie a dátový zdroj definovať na úrovni aplikácie, nie globálne, namiesto stránky Zdroje začnite na stránke Aplikácie, kliknite na názov aplikácie a potom kliknite na položku Zdroje.
2. Kliknite na položku Vytvoriť pripojenie a vyberte položku JDBC.
  
  Služba Essbase hľadá ovládač JDBC v priečinku drivers. Ak sa nenájde žiadny súbor jar, pri testovaní pripojenia služba Essbase vráti chybu „Trieda sa nenašla“ (alebo chybu zlyhania zavedenia ovládača).
3. V okne Vytvoriť pripojenie:
  1. Zadajte názov pripojenia JDBC. Napríklad Oracle JDBC.
  2. V poli adresy URL zadajte pripojovací reťazec JDBC. Príklad: jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com. Získajte pripojovací reťazec JDBC od poskytovateľa JDBC.
    
    Formát syntaxe vyššie sa vzťahuje iba na databázu Oracle. Ak pracujete s inými poskytovateľmi, pozrite si časť Ďalšie príklady pripojenia pre všeobecné ovládače JDBC.
  3. V poliach Používateľ a Heslo zadajte doklady používateľa, ktorý má oprávnenie na prístup do databázy.
  4. V poli Ovládač zadajte plne kvalifikovaný názov triedy ovládača JDBC. Príklad: oracle.jdbc.driver.OracleDriver.
  Pre ovládače Oracle zadajte adresu URL pomocou nasledujúcich pokynov pre syntax:
  - Ak je databáza Oracle zaregistrovaná v prijímači, namiesto SID môžete v adrese URL použiť názov služby pomocou skrátenej syntaxe jdbc:oracle:thin:@<host>:<port>/<servicename>. Príklad:
```
jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com
```
  - V nasledujúcom príklade je použitý názov služby s dlhou syntaxou.
```
jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(host=myserver.example.com)(protocol=tcp)(port=1521))(CONNECT_DATA=(SERVICE_NAME=orclpdb.example.com)))
```
  - Ak chcete použiť ID systému Oracle (SID), ktoré jednoznačne identifikuje databázu, použite syntax jdbc:oracle:thin:@<host>:<port>:<SID>. Príklad:
```
jdbc:oracle:thin:@myhost:1521:orcl
```
  - Ak používate databázu Autonomous Data Warehouse, v syntaxi adresy URL je potrebné zahrnúť premennú prostredia TNS_ADMIN, ktorá určuje cestu k walletu. Wallet môže byť kdekoľvek na serveri Essbase, ale je potrebné zadať celú cestu pomocou syntaxe, ako je napríklad jdbc:oracle:thin:@database_service_name?TNS_ADMIN=walletpath.
    
    Príklad pre systém Linux
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/scratch/oracle_home/dist/essbase/drivers/adwConn
```
    Príklad pre systém Windows
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN="C:\\Oracle123\\Middleware\\Oracle_Home\\essbase\\drivers\\adwConn"
```
    Príklad v nasadení OCI
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/u01/data/essbase/catalog/users/firstname.lastname@example.com/adwconn
```
  Príklady vyššie fungujú iba pre databázu Oracle. Ak pracujete s inými poskytovateľmi, pozrite si časť Ďalšie príklady pripojenia pre všeobecné ovládače JDBC.
4. Kliknite na položku Testovať na overenie pripojenia a v prípade úspechu kliknite na položku Vytvoriť.
5. Overte, že pripojenie bolo úspešne vytvorené a zobrazuje sa v zozname pripojení.
Vytvorte dátové zdroje pomocou generických pripojení ovládača JDBC.
1. Kliknite na položku Dátové zdroje a potom na položku Vytvoriť dátový zdroj.
2. V rozbaľovacom poli Pripojenie vyberte názov pripojenia, ktoré ste práve vytvorili, napríklad Oracle JDBC. Pripojenia na úrovni aplikácie majú ako predponu názov aplikácie vo formáte appName.connectionName.
3. Zadajte názov dátového zdroja, napríklad OracleDB_Datasource.
4. Môžete pridať popis dátového zdroja, napríklad SAMPLE_BASIC_TABLE v databáze Oracle.
5. V poli Dopyt zadajte príslušný dopyt SQL na výber dát, ktoré chcete sprístupniť v tomto dátovom zdroji.
6. Kliknite na tlačidlo Ďalej. Ak príkaz SQL správne vykonal dopyt na tabuľku, stĺpce použité v dopyte sú vyplnené.
7. Zmeňte prípadné numerické stĺpce na hodnotu Double a kliknite na tlačidlo Ďalej.
8. Podľa potreby zmeňte ďalšie parametre špecifické pre zdroj a kliknite na tlačidlo Ďalej. Informácie o používaní parametrov nájdete v časti Implementácia parametrov pre dátové zdroje.
9. Pozrite sa na panel ukážky. Mali by ste vidieť výsledky vyvolávania stĺpcov dát z externého zdroja pomocou dopytu.
10. Ak ukážka vyzerá správne, kliknutím na tlačidlo Vytvoriť dokončite vytváranie dátového zdroja.