Kapcsolatok és adatforrások létrehozása általános JDBC-illesztőprogramokhoz

Ezzel a munkafolyamat segítségével engedélyezheti, hogy az Essbase bármilyen JDBC adatforráshoz csatlakozzon, az Essbase kiszolgálóra feltöltött illesztőprogramok segítségével.

Ha Ön az Essbase telepítési rendszergazda, beállíthatja, hogy az Essbase az Essbase kiszolgálógépre feltöltött kívánt illesztőprogramokat használja. Az Oracle tesztelte az Essbase JDBC-kapcsolatot az Oracle-illesztőprogramok használatával. Más gyártók JDBC-illesztőprogramjainak használatához ellenőrizze az illesztőprogram dokumentációjában a JDBC-adatforrás URL-címének és hitelesítő adatainak megadására vonatkozó követelményeket. A teljesítménnyel kapcsolatos lépésekért tekintse át a gyártó JDBC dokumentációját.

Megjegyzés:

Győződjön meg arról, hogy az Essbase alkalmazáshoz használt JDBC-illesztőprogram tiszteletben tartja az eredménykészlet feldolgozása során a memória vezérléséhez használt setFetchSize metódust. Az adatbetöltési és dimenzióépítési folyamatok optimális teljesítménye érdekében az Essbase hálózati hívásonként 1000 rekordot kér le.

A Essbase konfigurálása általános JDBC-illesztőprogramok használatára:

Csatlakozzon az Essbase kiszolgáló géphez SSH használatával..
Hozzon létre manuálisan egy meghajtók könyvtárat a <Essbase termék kezdőlapja> könyvtárban a kiszolgáló példányon.

Győződjön meg arról, hogy a meghajtók kisbetűs, mivel az elérési útvonal nagy- és kisbetű érzékeny.
A gyártó webhelyéről töltse le a használni kívánt JDBC-illesztő JAR-okat.

Az Essbase által támogatott Oracle Database JDBC illesztőprogram a ojdbc8.jar.

Ha Autonomous Data Warehouse-t használ, akkor le kell töltenie a teljes archívumot (ojdbc8-full.tar.gz), amely az Oracle JDBC Thin illesztőprogramot és a kísérő JAR-okat tartalmazza.
Töltse fel a JDBC-illesztőprogram-csomagokat a Essbase példány meghajtók könyvtárába.

Minden adatbázis-illesztőprogramnak csak egy verzióját töltse fel a meghajtók könyvtárba. Például ne töltse fel az sqljdbc41.jar és az sqljdbc42.jar fájlt, különben az Essbase a régebbit fogja használni (mivel az szerepel először a CLASSPATH-ban).

Ha a Autonomous Data Warehouse-t használja, akkor bontsa ki az archívumot (ojdbc8-full.tar.gz), és helyezze át a teljes tartalmát közvetlenül a meghajtók könyvtárba (nem egy almappába).
Hozzon létre kapcsolatot a JDBC-illesztőprogramokhoz.
1. Az Essbase webes felületén kattintson a Források, majd a Kapcsolatok elemre.
  
  Ha az alkalmazás szintű kapcsolat és adatforrás definiálását nem globális, hanem alkalmazás szinten szeretné végrehajtani, a Források oldal helyett az Alkalmazások oldalon kezdeményezze a műveletet, kattintson egy alkalmazás nevére, majd a Források elemre.
2. Kattintson a Kapcsolat létrehozása lehetőségre, és válassza a JDBC elemet.
  
  A JDBC-illesztőprogram megtalálásához az Essbase a meghajtók mappában keresgél. Ha nem található jar fájl, az Essbase a kapcsolat tesztelésekor Class Not Found (vagy az illesztőprogram betöltésének sikertelensége) hibát ad vissza.
3. A Kapcsolat létrehozása képernyőn:
  1. Adjon nevet a JDBC-kapcsolatnak. Például: Oracle JDBC.
  2. Az URL mezőben adja meg a JDBC kapcsolat karakterláncát. Például: jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com. A JDBC-csatlakozási karakterlánc beszerzése a JDBC-szolgáltatótól.
    
    A fenti szintaxisformátum csak az Oracle Database szolgáltatásra vonatkozik. Más szolgáltatókkal való használat esetén lásd: További kapcsolati példák általános JDBC-illesztőprogramokhoz.
  3. A Felhasználó és a Jelszó mezőkbe adja meg az adatbázishoz való hozzáférésre jogosult felhasználó hitelesítő adatait.
  4. Az Illesztőprogram mezőben adja meg a JDBC-illesztőprogram teljes körűen minősített osztálynevét. Például: oracle.jdbc.driver.OracleDriver.
  Oracle-illesztőprogramok esetében az URL-címet a következő szintaxis-útmutatások szerint adja meg:
  - Ha az Oracle adatbázis egy figyelővel van regisztrálva, akkor az URL-címben az SID helyett a szolgáltatás nevét használhatja a rövid jdbc:oracle:thin:@<host>:<port>/<servicename> szintaxis segítségével. Példa:
```
jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com
```
  - A következő példa a szolgáltatás név hosszú szintaxist használja.
```
jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(host=myserver.example.com)(protocol=tcp)(port=1521))(CONNECT_DATA=(SERVICE_NAME=orclpdb.example.com)))
```
  - Az adatbázist egyedileg azonosító Oracle System ID (SID) használatához használja a jdbc:oracle:thin:@<host>:<port>:<SID> szintaxist. Például:
```
jdbc:oracle:thin:@myhost:1521:orcl
```
  - Ha a Autonomous Data Warehouse-t használja, az URL szintaxisában fel kell tüntetnie a TNS_ADMIN környezeti változót, amely megadja a tárca elérési útvonalát. A tárca bárhol lehet az Essbase kiszolgálón, de meg kell adnia a teljes elérési utat az alábbi szintaxissal: jdbc:oracle:thin:@database_service_name?TNS_ADMIN=walletpath.
    
    Példa Linux operációs rendszer esetén
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/scratch/oracle_home/dist/essbase/drivers/adwConn
```
    Példa Windows operációs rendszer esetén
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN="C:\\Oracle123\\Middleware\\Oracle_Home\\essbase\\drivers\\adwConn"
```
    Példa OCI telepítésére
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/u01/data/essbase/catalog/users/firstname.lastname@example.com/adwconn
```
  A fenti példák csak az Oracle Database szolgáltatásra vonatkoznak. Más szolgáltatókkal való használat esetén lásd: További kapcsolati példák általános JDBC-illesztőprogramokhoz.
4. A kapcsolat ellenőrzéséhez kattintson a Teszt gombra, és ha az sikeres, kattintson a Létrehozás lehetőségre.
5. Győződjön meg róla, hogy sikeres volt-e a kapcsolat létrehozása, és megjelenik-e az új kapcsolat a kapcsolatok listájában.
Adatforrások létrehozása az általános JDBC-illesztőprogram-kapcsolatokon keresztül.
1. Kattintson az Adatforrások elemre, és válassza az Adatforrás létrehozása elemet.
2. A Kapcsolat legördülő listában válassza ki az előbb létrehozott kapcsolat nevét, például Oracle JDBC. Az alkalmazásszintű kapcsolatok előtagja az alkalmazás neve, formátuma pedig: appName.connectionName.
3. Adjon nevet az új adatforrásnak, például ezt: OracleDB_Datasource.
4. Tetszés szerint leírást is adhat az adatforrás részére, például így: SAMPLE_BASIC_TABLE az Oracle adatbázison.
5. A Lekérdezés mezőben adjon meg olyan lekérdezési SQL utasítást, amelyik kiválasztja az azokat az adatokat, amelyeket Ön ebből az adatforrásból elérhetővé kíván tenni.
6. Kattintson a Tovább gombra. Ha az SQL utasítás helyesen kérdezte le a táblát, akkor a lekérdezett oszlopok ki vannak töltve.
7. Változtassa meg a szám adattípusú oszlopokat dupla pontosságúra, és kattintson a Tovább gombra.
8. Ha szükséges és lehetséges, változtasson meg további forrás vonatkozású paramétereket is, és kattintson a Tovább gombra. A paraméterek használatával kapcsolatos tudnivalókért lásd: Paraméterek implementálása adatforrásokhoz.
9. Nézze meg az előnézeti panelt. A lekérdezés eredményének a külső forrásból beolvasott oszlopokkal együtt kell megjelenni.
10. Ha az előnézet jónak tűnik, kattintson a Létrehozás gombra, hogy befejezze az adatforrás létrehozását.