Workiva kundestøttesenter

Med Oracle® RDBMS | ADW Connector kan du bruke kommandoer i en kjede for å utføre SQL-operasjoner (Structured Query Language) i Oracle Relational Database Management System (RDBMS) eller Autonomous Data Warehouse® (ADW). Med denne kontakten kan du for eksempel

• Utføre SQL-kommandoer, inkludert en CREATE eller UPDATE setning eller SELECT spørring
• Hent detaljer om en tabell i Oracle RDBMS eller ADW
• Sett inn poster i Oracle RDBMS eller ADW

Merk: Denne kontakten er bygget av Workiva og kobles til et tredjepartssystem. Supportteamet vårt kan hjelpe deg med å konfigurere denne koblingen i arbeidsområdet ditt, men vi kan ikke feilsøke eller på annen måte hjelpe deg med problemer som oppstår utenfor Workiva-plattformen.

Krav

For å aktivere tilkoblingen til Oracle-databasen bruker konnektoren Java Database Connectivity (JDBC), sikret med grunnleggende brukernavn- og passordautentisering. For å sette opp kontakten trenger du

• En utpekt integrasjonsbruker som er opprettet i Oracle RDBMS eller ADW for kontakten
• Integrasjonsbrukerens brukernavn og passord
• JDBC-tilkoblingens URL, for eksempel jdbc:oracle:thin:@db201905221856_high?TNS_ADMIN=./
• For å koble til Oracle ADW, må databasens klientlegitimasjon eller lommebokfiler
• For å koble til en lokal database, en GroundRunner for tilkoblingen

Versjoner som støttes

Oracle® RDBMS | ADW-kontakten er kompatibel med følgende databaseversjoner:

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

ADW lommebokfiler

For å aktivere en tilkobling til Oracle ADW må du først laste ned databasens klientlegitimasjon eller lommebokfiler. Når du konfigurerer kontakten, laster du opp disse lommebokfilene under Resources:

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

For å angi plasseringen av disse ressursene i kontaktens Connection URL -egenskap, skriver du inn TNS_ADMIN -banen basert på GroundRunners operativsystem:

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

Merk: Hvis kontakten bruker en CloudRunner, må du bruke banen TNS_ADMIN=./.

Konfigurer Oracle RDBMS | ADW-tilkoblingen

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 Oracle RDBMS | ADW og løperen som skal brukes med connectoren.
   
3. Under Basic Info angir du et unikt navn og en beskrivelse for å identifisere tilkoblingen.
4. For å koble til Oracle ADW, under Resources, laster du opp databasens lommebokfiler.
5. Under Properties angir du kontaktens detaljer:
   
   

   Egenskap	Detaljer
   Brukernavn	Skriv inn brukernavnet til integrasjonsbrukeren for kontakten.
   Passord	Skriv inn passordet for egenskapen Username.
   URL for tilkobling	Skriv inn URL-adressen for JDBC-tilkoblingen, for eksempel jdbc:oracle:thin:@db201905221856_high?TNS_ADMIN=./. For Oracle RDBMS legger til eventuelle valgfrie egenskaper for tilkoblingen. For Oracle ADW legger du til TNS_ADMIN -banen for databasens lommebokfiler, basert på den valgte løperen og operativsystemet. Merk: Som standard er porten for Oracle RDBMS 1521; dette kan imidlertid være annerledes i ditt miljø.

   Merk: Alle sensitive opplysninger krypteres automatisk og lagres med Advanced Encryption Standard (AES)-256-kryptering. Av sikkerhetshensyn bør du unngå å inkludere brukerlegitimasjon som valgfrie egenskaper i egenskapen Connection URL.

6. Velg miljøene som skal brukes med tilkoblingen, og klikk på Lagre.
7. 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 tilkoblingen til Oracle RDBMS eller ADW mislykkes:

• Bekreft integrasjonsbrukerens autentiseringsinformasjon.
• Kontroller URL-adressen for JDBC-tilkoblingen.
• Hvis du kobler til en lokal database, må du kontrollere GroundRunner som er valgt for kontakten.
• Hvis du kobler til Oracle ADW, må du kontrollere at databasens lommebokfiler er lastet opp under Resources, og verifisere TNS_ADMIN -banen i Connection URL -egenskapen. Last om nødvendig ned lommebokfilene fra Oracle ADW og last dem opp på nytt under Resources.

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