Workiva-ondersteuningscentrum

Met de Oracle® RDBMS | ADW-connector kunt u opdrachten in een keten gebruiken om gestructureerde querytaal (SQL)-bewerkingen uit te voeren in Oracle Relational Database Management System (RDBMS) of Autonomous Data Warehouse® (ADW). Met deze connector kunt u bijvoorbeeld:

• SQL-opdrachten uitvoeren, inclusief een CREATE of UPDATE verklaring of SELECT query
• Details ophalen over een tabel in Oracle RDBMS of ADW
• Records invoegen in Oracle RDBMS of ADW

Opmerking: Deze connector is gebouwd door Workiva en maakt verbinding met een systeem van derden. Hoewel ons Support team kan helpen bij het configureren van deze connector binnen uw workspace, kunnen wij geen problemen oplossen of op een andere manier helpen met problemen die hun oorsprong vinden buiten het Workiva platform.

Vereisten

Om de verbinding met de Oracle database mogelijk te maken, gebruikt de connector Java database connectivity (JDBC), beveiligd met basisgebruikersnaam en wachtwoordverificatie. Om de connector in te stellen, hebt u het volgende nodig:

• Een aangewezen integratiegebruiker die is aangemaakt in Oracle RDBMS of ADW voor de connector
• De gebruikersnaam en het wachtwoord van de integratiegebruiker
• De URL van de JDBC-verbinding, zoals jdbc:oracle:thin:@db201905221856_high?TNS_ADMIN=./
• Om verbinding te maken met Oracle ADW, moeten de clientgegevens of portemonneebestanden van de database
• Om verbinding te maken met een on-premise database, een GroundRunner voor de verbinding

Ondersteunde versies

De Oracle® RDBMS | ADW connector is compatibel met de volgende databaseversies:

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

ADW portefeuillebestanden

Om een verbinding met Oracle ADW mogelijk te maken, downloadt u eerst de clientgegevens of portemonneebestanden van de database. Wanneer u de connector instelt, uploadt u deze portemonneebestanden onder Resources:

• cwallet.sso.lckn* ewallet.p12.lck
• cwallet.sso
• ewallet.p12
• sleutelbewaarplaats.jks
• sqlnet.ora
• tnsnames.ora
• truststore.jks
• ojdbc.properties

Om de locatie van deze bronnen in de connector's Connection URL property aan te geven, vult u het TNS_ADMIN pad in, gebaseerd op het besturingssysteem van GroundRunner:

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

Opmerking: Als de connector een CloudRunner gebruikt, gebruik dan het pad TNS_ADMIN=./.

De Oracle RDBMS | ADW-connector instellen

Opmerking: Om de connector beschikbaar te maken voor gebruik in de ketens van uw organisatie, moet een beveiligingsbeheerder van de org deze eerst inschakelen vanuit Configuratie.

1. Ga naar Chain Builder, klik op Connectionscompare_arrows, en vervolgens op Create rechts bovenaan.
2. Selecteer onder Connector Connection, Oracle RDBMS | ADW en de runner die u met de connector wilt gebruiken.
   
3. Voer onder Basisinfo een unieke naam en beschrijving in om de verbinding te helpen identificeren.
4. Om verbinding te maken met Oracle ADW, onder Resources, uploadt u de portemonneebestanden van de database.
5. Voer onder Eigenschappen de gegevens van de connector in:
   
   

   Eigendom	Details
   Gebruikersnaam	Voer de gebruikersnaam van de integratiegebruiker van de connector in.
   Wachtwoord	Voer het wachtwoord in voor de eigenschap Username.
   URL verbinding	Voer de URL voor de JDBC-verbinding in, zoals jdbc:oracle:thin:@db201905221856_high?TNS_ADMIN=./. Voor Oracle RDBMS, voegt u alle optionele eigenschappen toe voor de verbinding. Voeg voor Oracle ADW het pad TNS_ADMIN toe voor de portemonneebestanden van de database, op basis van de geselecteerde runner en het besturingssysteem. Opmerking: Standaard is de poort voor Oracle RDBMS 1521; dit kan echter voor uw omgeving anders zijn.

   Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met Advanced Encryption Standard (AES)-256 codering. Vermijd om veiligheidsredenen het opnemen van gebruikersreferenties als optionele eigenschappen binnen de eigenschap Connection URL.

6. Selecteer de omgevingen die u met de verbinding wilt gebruiken en klik op Opslaan.
7. Om de verbinding te testen, maakt een ketting aan en voert deze uit met de opdracht Get Table Definition van de connector en controleert of deze een geldige uitvoer oplevert. 

Probleemoplossing

Als de verbinding met Oracle RDBMS of ADW mislukt:

• Controleer de verificatiegegevens van de integratiegebruiker.
• Controleer de URL voor de JDBC-verbinding.
• Als u verbinding maakt met een on-premise database, controleer dan de GroundRunner die voor de connector is geselecteerd.
• Als u verbinding maakt met Oracle ADW, controleer dan of de portemonneebestanden van de database zijn geüpload onder Resources, en controleer hun TNS_ADMIN pad in de Connection URL eigenschap. Download indien nodig de portemonneebestanden van Oracle ADW en upload ze opnieuw onder Resources.

Als de verbinding een opdracht niet kan uitvoeren, controleer dan of de invoer, zoals de SQL-syntaxis of tabel, geldig is.