Creare connessioni e origini dati per driver JDBC generici

Utilizzare questo workflow per consentire a Essbase di connettersi a qualsiasi origine dati JDBC mediante i driver caricati nel server Essbase.

Se si dispone del ruolo Amministratore della distribuzione Essbase è possibile configurare Essbase per l'utilizzo dei driver preferenziali caricati nel computer server Essbase. Il personale Oracle ha eseguito i test della connettività JDBC a Essbase utilizzando i driver Oracle. Per utilizzare i driver JDBC di altri fornitori, consultare la documentazione del driver interessato per i requisiti di specifica dell'URL e delle credenziali dell'origine dati JDBC. Per qualsiasi passo relativo alle prestazioni, fare riferimento alla documentazione JDBC del fornitore.

Nota:

Assicurarsi che il driver JDBC utilizzato con Essbase rispetti il metodo setFetchSize per il controllo della memoria usata durante l'elaborazione del set di risultati. Per garantire prestazioni ottimali per i processi di caricamento dei dati e generazione delle dimensioni, Essbase recupera 1000 record per chiamata di rete.

Per configurare Essbase per l'utilizzo di driver JDBC generici, effettuare le operazioni riportate di seguito.

Connettersi al computer server Essbase mediante la shell SSH.
Creare manualmente una directory drivers nella <home prodotto Essbase> dell'istanza del server.

Specificare la cartella drivers con caratteri minuscoli, in quanto il percorso distingue tra maiuscole e minuscole.
Dal sito del fornitore, scaricare i file JAR dei driver JDBC che si desidera utilizzare.

Il driver JDBC del database Oracle supportato da Essbase è ojdbc8.jar.

Se si utilizza Autonomous Data Warehouse, è necessario scaricare l'archivio completo (ojdbc8-full.tar.gz), che contiene il driver Thin JDBC Oracle e i file JAR complementari.
Caricare i file JAR del driver JDBC nella directory drivers dell'istanza Essbase.

Caricare una sola versione di ciascun driver di database nella directory drivers. Ad esempio, non caricare sia sqljdbc41.jar che sqljdbc42.jar, altrimenti Essbase utilizzerà il file meno recente dei due (in quanto visualizzato per primo in CLASSPATH).

Se si utilizza Autonomous Data Warehouse, estrarre il contenuto dell'archivio (ojdbc8-full.tar.gz) e spostarlo direttamente nella directory drivers (non in una sottocartella).
Creare le connessioni ai driver JDBC.
1. Nell'interfaccia Web di Essbase fare clic su Origini, quindi su Connessioni.
  
  Per definire invece la connessione e l'origine dati a livello di applicazione anziché a livello globale, iniziare dalla pagina Applicazioni anziché dalla pagina Origini, fare clic sul nome di un'applicazione, quindi fare clic su Origini.
2. Fare clic su Crea connessione e selezionare JDBC.
  
  Per trovare il driver JDBC, Essbase effettua una ricerca nella cartella drivers. Se non viene trovato alcun file jar, Essbase restituirà un errore Classe non trovata (o caricamento del driver non riuscito) durante il test della connessione.
3. Nella schermata Crea connessione effettuare le operazioni riportate di seguito.
  1. Fornire un nome per la connessione JDBC. Ad esempio, Oracle JDBC.
  2. Nel campo URL specificare la stringa di connessione JDBC. Ad esempio, jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com. Ottenere la stringa di connessione JDBC dal provider JDBC.
    
    Il formato di sintassi precedente è valido solo per il database Oracle. Se si utilizzano altri provider, vedere Altri esempi di connessione per driver JDBC generici.
  3. Per i campi Utente e Password, immettere le credenziali di un utente autorizzato ad accedere al database.
  4. Nel campo Driver immettere il nome classe completamente qualificato del driver JDBC. Ad esempio, oracle.jdbc.driver.OracleDriver.
  Per i driver Oracle, specificare l'URL utilizzando le istruzioni di sintassi riportate di seguito.
  - Se il database Oracle è registrato con un listener, è possibile utilizzare il nome del servizio al posto del SID nell'URL, utilizzando la sintassi breve jdbc:oracle:thin:@<host>:<porta>/<nome servizio>. Esempio:
```
jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com
```
  - Nell'esempio seguente viene utilizzato il nome del servizio con la sintassi lunga.
```
jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(host=myserver.example.com)(protocol=tcp)(port=1521))(CONNECT_DATA=(SERVICE_NAME=orclpdb.example.com)))
```
  - Per utilizzare l'ID di sistema Oracle (SID) che identifica in modo univoco il database, utilizzare la sintassi jdbc:oracle:thin:@<host>:<porta>:<SID>. Ad esempio,
```
jdbc:oracle:thin:@myhost:1521:orcl
```
  - Se si utilizza Autonomous Data Warehouse, nella sintassi dell'URL è necessario includere la variabile di ambiente TNS_ADMIN, che specifica il percorso del wallet. Il wallet può essere memorizzato in una posizione qualsiasi del computer server Essbase, ma è necessario fornire il percorso completo utilizzando una sintassi simile alla seguente: jdbc:oracle:thin:@nome_servizio_database?TNS_ADMIN=percorso wallet.
    
    Esempio per l'ambiente Linux
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/scratch/oracle_home/dist/essbase/drivers/adwConn
```
    Esempio per l'ambiente Windows
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN="C:\\Oracle123\\Middleware\\Oracle_Home\\essbase\\drivers\\adwConn"
```
    Esempio per una distribuzione OCI
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/u01/data/essbase/catalog/users/firstname.lastname@example.com/adwconn
```
  Gli esempi precedenti sono validi solo per il database Oracle. Se si utilizzano altri provider, vedere Altri esempi di connessione per driver JDBC generici.
4. Fare clic su Test per convalidare la connessione e, in caso di esito positivo, fare clic su Crea.
5. Verificare che la connessione sia stata effettivamente creata e sia visualizzata nella lista delle connessioni.
Creare le origini dati per le connessioni del driver JDBC generico.
1. Fare clic su Origini dati, quindi su Crea origine dati.
2. Dalla casella a discesa Connessione selezionare il nome della connessione appena creata, ad esempio Oracle JDBC. Per le connessioni a livello di applicazione viene inserito come prefisso il nome della connessione nel formato appName.connectionName.
3. Fornire un nome per l'origine dati, ad esempio OracleDB_Datasource.
4. Se necessario, fornire la descrizione dell'origine dati, ad esempio SAMPLE_BASIC_TABLE in Oracle Database.
5. Nel campo Query specificare la query SQL appropriata che selezioni i dati da rendere disponibili nell'origine dati.
6. Fare clic su Avanti. Se l'istruzione SQL era corretta per l'esecuzione della query su una tabella, le colonne interessate dalla query vengono popolate.
7. Modificare le colonne numeriche impostandole su Double e fare clic su Avanti.
8. Modificare tutti i parametri specifici dell'origine aggiuntivi, se applicabile, e fare clic su Avanti. Per informazioni sull'uso dei parametri, vedere Implementare i parametri per le origini dati.
9. Rivedere il pannello di anteprima. Dovrebbero essere visibili i risultati della query che recupera le colonne di dati dall'origine esterna.
10. Se l'anteprima ha un aspetto corretto, fare clic su Crea per completare la creazione dell'origine dati.