Workiva kundestøttesenter

Med JDBC Connector kan du bruke kommandoer i en kjede for å utføre SQL-operasjoner (Structured Query Language) i lokale løsninger som støtter JDBC (Java® Database Connectivity). Med denne kontakten kan du for eksempel

• Utføre SQL-kommandoer, inkludert en CREATE eller UPDATE setning eller SELECT spørring
• Hent informasjon om en databasetabell
• Sett inn poster i en database via JDBC

Merk følgende: For å koble til 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®, skal du i stedet bruke den respektive kontakten.

Forutsetninger

For å sikre JDBC-tilkoblingen bruker kontakten grunnleggende brukernavn- og passordautentisering. For å sette opp kontakten trenger du

• En utpekt integrasjonsbruker som er satt opp i løsningen du er koblet til.
• Integrasjonsbrukerens autentiseringsopplysninger.
• JDBC-tilkoblingens URL, for eksempel jdbc:solution://host:port/database
• En GroundRunner dedikert til kontakten; CloudRunners støttes ikke.
• JDBC-driveren for tilkoblingen, inkludert klassenavn og bane i GroundRunners filsystem.
• Hvis du trenger å levere/aktivere egendefinerte Java-alternativer når du bruker kontakten, kjører du GroundRunner med miljøvariabelen JDK_JAVA_OPTIONS angitt.
  Hvis du for eksempel bruker Databricks, bruker du følgende:
  JDK_JAVA_OPTIONS="--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED"

Merk: Driveren må være plassert på GroundRunner - .jar-filer kan ikke lastes opp til Resources-feltet.

Konfigurer JDBC-kontakten

Merk: For å gjøre kontakten tilgjengelig for bruk i organisasjonens kjeder, må en sikkerhetsadministrator i organisasjonen først aktivere den fra Configuration.

1. Fra Chain Builder klikker du på Connectionscompare_arrows, og deretter Create øverst til høyre.
2. Under Connector Connection velger du JDBC og GroundRunner som skal brukes med tilkoblingen.
   
3. Under Basic Info angir du et unikt navn og en beskrivelse for å identifisere tilkoblingen.

4. Under Properties angir du detaljer om tilkoblingen:
   

   Egenskap	Detaljer
   Brukernavn	Skriv inn brukernavnet til integrasjonsbrukeren for kontakten.
   Passord	Skriv inn passordet for egenskapen Username.
   URL for tilkobling	Skriv inn URL-en for JDBC-tilkoblingen, for eksempel jdbc:solution://host:port/database.
   JDBC-stasjonsklasse	Skriv inn klassenavnet for JDBC-driverens .jar-fil. For Sybase® skriver du for eksempel inn com.sybase.jdbc.sybdriver.
   Sti til JDBC-driveren	Angi banen til JDBC-driverens installasjon på GroundRunners filsystem.

   Merk: Alle sensitive opplysninger krypteres automatisk og lagres med Advanced Encryption Standard (AES)-256-kryptering.

5. Velg miljøene som skal brukes med tilkoblingen, og klikk på Lagre.
6. For å teste tilkoblingen kan du opprette og kjøre en kjede med -kontaktens Get Table Definition -kommando, og kontrollere at den returnerer en gyldig utdata.

Feilsøking

Hvis JDBC-tilkoblingen mislykkes:

• Bekreft integrasjonsbrukerens autentiseringsopplysninger.
• Kontroller URL-adressen for JDBC-tilkoblingen, inkludert server, port og database.
• Kontroller JDBC-driverklassenavnet eller banen som er angitt for kontakten.

Hvis tilkoblingen ikke klarer å utføre en kommando, må du kontrollere at inndataene - for eksempel SQL-syntaksen eller tabellen - er gyldige.