Workiva supportcenter

Med JDBC Connector kan du använda kommandon i en kedja för att utföra SQL-operationer (Structured Query Language) i lokala lösningar som har support för JDBC (Java® Database Connectivity). Med den här kontakten kan du t.ex:

• Exekvera SQL-kommandon, inklusive en CREATE eller UPDATE -sats eller SELECT -fråga
• Hämta information om en databastabell
• Infoga poster i en databas via JDBC

Obs: För att ansluta till Amazon® Redshift®, IBM® Db2®, Microsoft® SQL Server®, MySQL®, NetSuite® JDBC, Oracle® Relational Database Management System (RDBMS) eller Autonomous Data Warehouse (ADW), Postgres®, SAP HANA® JDBC, eller Snowflake®, använd istället respektive connector.

Förkunskapskrav

För att säkra JDBC-anslutningen använder connectorn grundläggande autentisering med användarnamn och lösenord. För att sätta upp kontakten behöver du:

• En utsedd integrationsanvändare som har konfigurerats i den lösning du ansluter till.
• Autentiseringsuppgifter för integrationsanvändaren.
• JDBC-anslutningens URL, t.ex. jdbc:solution://host:port/database
• En GroundRunner dedikerad till connectorn, eftersom CloudRunners inte stöds.
• JDBC-drivrutinen för anslutningen, inklusive dess klassnamn och sökväg i GroundRunners filsystem.
• För att tillhandahålla anpassade Java-alternativ när du använder den här anslutningen, ange miljövariabeln JDK_JAVA_OPTIONS för GroundRunner.Om du till exempel använder Databricks använder du följande:
  JDK_JAVA_OPTIONS="--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED". Detta liknar konfigurationsvariablerna som anges i Installera och hantera GroundRunners.
  Viktigt: Du måste starta om datorn som GroundRunner körs på efter att du har ställt in den här variabeln.

Obs: Drivrutinen måste finnas på GroundRunner, eftersom .jar -filer inte kan laddas upp som resurser.

Konfigurera JDBC-anslutningen

Obs: För att göra kontakten tillgänglig för användning i din organisations kedjor, en org säkerhetsadministratör först aktivera den från Konfiguration.

1. Från Kedjebyggareklickar du på Anslutningarcompare_arrowsoch sedan på Skapa längst upp till höger.
2. Under Anslutning för anslutningväljer du JDBC och den GroundRunner som ska användas med anslutningen.
   
3. Under Basic Info anger du ett unikt namn och en beskrivning som hjälper dig att identifiera anslutningen.

4. Under Properties anger du information om anslutningen:
   

   Egenskap	Information
   Användarnamn	Ange användarnamnet för connectorens integrationsanvändare.
   Lösenord	Ange lösenordet för egenskapen Username.
   URL för anslutning	Ange URL:en för JDBC-anslutningen, till exempel jdbc:solution://host:port/database.
   JDBC drivklass	Ange klassnamnet för JDBC-drivrutinens .jar-fil. För Sybase® anger du till exempel com.sybase.jdbc.sybdriver.
   Sökväg till JDBC-drivrutin	Ange sökvägen till JDBC-drivrutinens installation på GroundRunners filsystem.

   Obs: Alla känsliga uppgifter krypteras automatiskt och lagras med Advanced Encryption Standard (AES)-256-kryptering.

5. Välj de miljöer som ska användas med anslutningen och klicka på Save.
6. Stäng av och starta om datorn som GroundRunner körs på för att ominitiera JVM:n.
7. Testa anslutningen genom att skapa och köra en kedja med kommandot Get Table Definition från connector och kontrollera att den returnerar en giltig utdata.

Felsökning

Om JDBC-anslutningen misslyckas:

• Verifiera autentiseringsuppgifterna för integrationsanvändaren.
• Kontrollera URL:en för JDBC-anslutningen, inklusive server, port och databas.
• Kontrollera klassnamnet eller sökvägen för JDBC-drivrutinen som angetts för anslutningen.

Om anslutningen inte kan utföra ett kommando, kontrollera att dess indata (t.ex. SQL-syntax eller tabell) är giltiga.