Centrum wsparcia Workiva

Dzięki konektorowi JDBC możesz używać poleceń w łańcuchu do wykonywania operacji w strukturalnym języku zapytań (SQL) w rozwiązaniach lokalnych, które obsługują łączność z bazą danych Java® (JDBC). Na przykład, za pomocą tego złącza możesz:

• Wykonaj polecenia SQL, w tym instrukcję CREATE lub UPDATE lub zapytanie SELECT
• Pobierz szczegóły dotyczące tabeli bazy danych
• Wstawianie rekordów do bazy danych przez JDBC

Uwaga: Aby połączyć się z Amazon® Redshift®, IBM® Db2®, Microsoft® SQL Server®, MySQL®, NetSuite® JDBC, Oracle® Relational Database Management System (RDBMS) lub Autonomous Data Warehouse (ADW), Postgres®, SAP HANA® JDBC, lub Snowflake®, użyj zamiast tego odpowiedniego łącznika.

Wymagania wstępne

Aby zabezpieczyć połączenie JDBC, konektor używa podstawowego uwierzytelniania nazwy użytkownika i hasła. Aby skonfigurować złącze, będziesz potrzebować

• Wyznaczony użytkownik integracji skonfigurowany w rozwiązaniu, z którym się łączysz.
• Dane uwierzytelniające użytkownika integracji.
• Adres URL połączenia JDBC, taki jak jdbc:solution://host:port/database
• GroundRunner dedykowany dla złącza; CloudRunners nie są obsługiwane.
• Sterownik JDBC dla połączenia, w tym jego nazwa klasy i ścieżka w systemie plików GroundRunner.
• Jeśli potrzebujesz dostarczyć/włączyć niestandardowe opcje Java podczas korzystania z konektora, uruchom GroundRunner z ustawioną zmienną środowiskową JDK_JAVA_OPTIONS.
  Na przykład, jeśli używasz Databricks, użyj następującego:
  JDK_JAVA_OPTIONS="--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED"

Uwaga: Sterownik musi znajdować się na urządzeniu GroundRunner - pliki .jar nie mogą być przesyłane do pola Resources.

Skonfiguruj złącze JDBC

Uwaga: Aby udostępnić łącznik do użytku w łańcuchach organizacji, administrator bezpieczeństwa organizacji najpierw włącza go z Konfiguracja.

1. Na stronie Chain Builder kliknij Connectionscompare_arrows, a następnie Create w prawym górnym rogu.
2. W sekcji Connector Connection wybierz JDBC i GroundRunner do użycia z połączeniem.
   
3. W sekcji Basic Info wprowadź unikalną nazwę i opis, aby ułatwić identyfikację połączenia.

4. W sekcji Properties wprowadź szczegóły połączenia:
   

   Właściwość	Szczegóły
   Nazwa użytkownika	Wprowadź nazwę użytkownika integracji konektora.
   Hasło	Wprowadź hasło dla właściwości Username.
   Adres URL połączenia	Wprowadź adres URL połączenia JDBC, np. jdbc:solution://host:port/database.
   Klasa napędu JDBC	Wprowadź nazwę klasy dla pliku .jar sterownika JDBC. Na przykład dla Sybase® wpisz com.sybase.jdbc.sybdriver.
   Ścieżka do sterownika JDBC	Wprowadź ścieżkę do instalacji sterownika JDBC w systemie plików GroundRunner.

   Uwaga: Wszystkie poufne dane uwierzytelniające są automatycznie szyfrowane i przechowywane przy użyciu szyfrowania Advanced Encryption Standard (AES) -256.

5. Wybierz środowiska, które mają być używane z połączeniem i kliknij Zapisz.
6. Aby przetestować połączenie, utwórz i uruchom łańcuch z poleceniem Get Table Definition konektora i sprawdź, czy zwraca prawidłowe dane wyjściowe.

Rozwiązywanie problemów

Jeśli połączenie JDBC nie powiedzie się:

• Zweryfikuj poświadczenia uwierzytelniania użytkownika integracji.
• Sprawdź adres URL połączenia JDBC, w tym jego serwer, port i bazę danych.
• Zweryfikuj nazwę klasy sterownika JDBC lub ścieżkę wprowadzoną dla łącznika.

Jeśli połączenie nie wykona polecenia, sprawdź, czy jego dane wejściowe - takie jak składnia SQL lub tabela - są prawidłowe.