Centro assistenza di Workiva

Con il connettore Oracle® RDBMS | ADW, puoi utilizzare i comandi in una catena per eseguire operazioni in linguaggio di query strutturato (SQL) in Oracle Relational Database Management System (RDBMS) o Autonomous Data Warehouse® (ADW). Ad esempio, con questo connettore puoi:

• Eseguire comandi SQL, tra cui un'istruzione CREA o AGGIORNA o una query SELEZIONA
• Recuperare i dettagli di una tabella in Oracle RDBMS o ADW
• Inserire record in Oracle RDBMS o ADW

Nota: Questo connettore è stato realizzato da Workiva e si collega a un sistema di terze parti. Sebbene il nostro team di assistenza possa aiutare a configurare questo connettore all'interno del tuo spazio di lavoro, non siamo in grado di risolvere i problemi o di fornire assistenza in altro modo per qualsiasi problema che abbia origine al di fuori della piattaforma Workiva.

Requisiti

Per attivare la connessione al database Oracle, il connettore utilizza la connettività del database Java (JDBC), protetta da un'autenticazione di base con nome utente e password. Per configurare il connettore, avrai bisogno di:

• Un utente designato per l'integrazione creato in Oracle RDBMS o ADW per il connettore
• Nome utente e password dell'utente dell'integrazione
• L'URL della connessione JDBC, ad esempio jdbc:oracle:thin:@db201905221856_high?TNS_ADMIN=./
• Per connettersi a Oracle ADW, le credenziali client o i file di portafoglio del database
• Per connettersi a un database on-premise, un GroundRunner per la connessione

Versioni supportate

Il connettore Oracle® RDBMS | ADW è compatibile con le seguenti versioni di database:

• 21.x
• 19.x
• 18.3
• 12.2
• 12.1
• 11.2.0.4

File di portafoglio ADW

Per attivare una connessione a Oracle ADW, per prima cosa scarica le credenziali del database o i file del portafoglio. Quando configuri il connettore, caricherai questi file di portafoglio in Risorse:

• cwallet.sso.lck\n* ewallet.p12.lck
• cwallet.sso
• ewallet.p12
• keystore.jks
• sqlnet.ora
• tnsnames.ora
• truststore.jks
• ojdbc.properties

Per indicare la posizione di queste risorse nella proprietà Connection URL del connettore, inserisci il percorso TNS_ADMIN in base al sistema operativo del GroundRunner:

• Per UNIX, TNS_ADMIN=./
• Per Microsoft® Windows®, TNS_ADMIN=.

Nota: Se il connettore utilizza un CloudRunner, utilizza il percorso TNS_ADMIN=./.

Configura il connettore Oracle RDBMS | ADW

Nota: Per rendere il connettore disponibile per l'uso nelle catene della tua organizzazione, un amministratore della sicurezza dell'org deve prima abilitarlo da Configurazione.

1. Da Builder catena, clicca su Connessioni compare_arrows e poi su Crea in alto a destra.
2. In Connector Connection, seleziona Oracle RDBMS | ADW e il runner da utilizzare con il connettore.
   
3. In Informazioni di base, inserisci un nome e una descrizione unici per identificare la connessione.
4. Per connetterti a Oracle ADW, alla voce Resources, carica i file del portafoglio del database.
5. In Proprietà, inserisci i dettagli del connettore:
   
   

   Proprietà	Dettagli
   Nome utente	Inserisci il nome utente dell'utente di integrazione del connettore.
   Password	Inserisci la password per la proprietà Nome utente.
   URL di connessione	Inserisci l'URL della connessione JDBC, ad esempio jdbc:oracle:thin:@db201905221856_high?TNS_ADMIN=./. Per Oracle RDBMS, aggiungi qualsiasi proprietà opzionale per la connessione. Per Oracle ADW, aggiungi il percorso TNS_ADMIN per i file del portafoglio del database, in base al runner selezionato e al suo sistema operativo. Nota: Per impostazione predefinita, la porta di Oracle RDBMS è 1521; tuttavia, questa potrebbe essere diversa per il tuo ambiente.

   Nota: Tutte le credenziali sensibili vengono automaticamente crittografate e memorizzate con la crittografia Advanced Encryption Standard (AES)-256. Per motivi di sicurezza, evita di includere le credenziali dell'utente come proprietà facoltative nella proprietà Connection URL.

6. Seleziona gli ambienti da utilizzare per la connessione e clicca su Salva.
7. Per testare la connessione, crea ed esegui una catena con il comando Ottieni la definizione della tabella del connettore e verifica che restituisca un output valido. 

Risoluzione dei problemi

Se la connessione a Oracle RDBMS o ADW fallisce:

• Verifica le credenziali di autenticazione dell'utente dell'integrazione.
• Controlla l'URL della connessione JDBC.
• Se ti connetti a un database on-premise, controlla il GroundRunner selezionato per il connettore.
• Se ti connetti a Oracle ADW, verifica che i file del portafoglio del database siano caricati in Resources, e verifica il percorso TNS_ADMIN nella proprietà Connection URL. Se necessario, scarica i file del portafoglio da Oracle ADW e caricali nuovamente in Resources.

Se la connessione non riesce a eseguire un comando, verifica che i suoi input, come la sintassi SQL o la tabella, siano validi.