Workiva-ondersteuningscentrum

Met de JDBC-connector kunt u commando's in een keten gebruiken om gestructureerde querytaal (SQL)-bewerkingen uit te voeren in on-premises oplossingen die Java® database connectivity (JDBC) ondersteunen. Met deze connector kunt u bijvoorbeeld:

• SQL-opdrachten uitvoeren, inclusief een CREATE of UPDATE verklaring of SELECT query
• Details over een databasetabel ophalen
• Records invoegen in een database via JDBC

Opmerking: Om verbinding te maken met Amazon® Redshift®, IBM® Db2®, Microsoft® SQL Server®, MySQL®, NetSuite® JDBC, Oracle® Relational Database Management System (RDBMS) of Autonomous Data Warehouse (ADW), Postgres®, SAP HANA® JDBC, of Snowflake®, gebruik dan de respectievelijke connector.

Vereisten

Om de JDBC-verbinding te beveiligen, gebruikt de connector basisverificatie met gebruikersnaam en wachtwoord. Om de connector in te stellen, hebt u het volgende nodig:

• Een aangewezen integratiegebruiker die is ingesteld in de oplossing waarmee u verbinding maakt.
• De verificatiegegevens van de integratiegebruiker.
• De URL van de JDBC-verbinding, zoals jdbc:solution://host:port/database
• Een GroundRunner speciaal voor de connector, aangezien CloudRunners niet worden ondersteund.
• De JDBC-driver voor de verbinding, inclusief de classnaam en het pad op het bestandssysteem van GroundRunner.
• Om aangepaste Java-opties te bieden wanneer u deze connector gebruikt, stelt u de JDK_JAVA_OPTIONS omgevingsvariabele in voor de GroundRunner. Als u bijvoorbeeld Databricks gebruikt, zou u het volgende gebruiken:
  JDK_JAVA_OPTIONS="--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED". Dit is vergelijkbaar met de configuratievariabelen die zijn ingesteld in GroundRunners installeren en beheren.
  Belangrijk: U moet de computer waarop de GroundRunner werkt opnieuw opstarten nadat u deze variabele hebt ingesteld.

Opmerking: De driver moet zich op de GroundRunner bevinden, aangezien .jar bestanden niet als Resources geüpload kunnen worden.

De JDBC-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 rechtsboven.
2. Selecteer onder Connector Connection JDBC en de GroundRunner die u met de verbinding wilt gebruiken.
   
3. Voer onder Basisinfo een unieke naam en beschrijving in om de verbinding te helpen identificeren.

4. Onder Eigenschappen, voert u de details van de verbinding in:
   

   Eigendom	Details
   Gebruikersnaam	Voer de gebruikersnaam voor 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:solution://host:port/database.
   JDBC-stuurklasse	Voer de class-naam voor het .jar-bestand van het JDBC-stuurprogramma in. Voor Sybase® voert u bijvoorbeeld com.sybase.jdbc.sybdriver in.
   Pad naar JDBC-stuurprogramma	Voer het pad in naar de installatie van de JDBC-driver op het bestandssysteem van GroundRunner.

   Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met Advanced Encryption Standard (AES)-256 codering.

5. Selecteer de omgevingen die u met de verbinding wilt gebruiken en klik op Opslaan.
6. Sluit de computer waarop GroundRunner draait af en herstart deze om de JVM opnieuw te initialiseren.
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 JDBC-verbinding mislukt:

• Controleer de verificatiegegevens van de integratiegebruiker.
• Controleer de URL voor de JDBC-verbinding, inclusief de server, poort en database.
• Controleer de JDBC-stuurprogrammaklasse of het pad dat is ingevoerd voor de connector.

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