Centro assistenza di Workiva

Con il connettore JDBC, puoi utilizzare i comandi in una catena per eseguire operazioni in linguaggio di query strutturato (SQL) in soluzioni on-premises che supportano la connettività di database Java® (JDBC). Ad esempio, con questo connettore puoi:

• Eseguire comandi SQL, tra cui un'istruzione CREA o AGGIORNA o una query SELEZIONA
• Recupera i dettagli di una tabella di database
• Inserire record in un database tramite JDBC

Nota: Per connettersi a Amazon® Redshift®, IBM® Db2®, Microsoft® SQL Server®, MySQL®, NetSuite® JDBC, Oracle® Relational Database Management System (RDBMS) o Autonomous Data Warehouse (ADW), Postgres®, SAP HANA® JDBC, o Snowflake®, utilizza invece il connettore corrispondente.

Prerequisiti

Per proteggere la connessione JDBC, il connettore utilizza un'autenticazione di base con nome utente e password. Per configurare il connettore, avrai bisogno di:

• Un utente designato per l'integrazione impostato nella soluzione a cui ti stai connettendo.
• Le credenziali di autenticazione dell'utente dell'integrazione.
• L'URL della connessione JDBC, come ad esempio jdbc:solution://host:port/database
• Un GroundRunner dedicato al connettore, poiché i CloudRunner non sono supportati.
• Il driver JDBC per la connessione, compreso il nome della classe e il percorso nel file system di GroundRunner.
• Per fornire opzioni Java personalizzate quando si utilizza questo connettore, imposta la variabile d'ambiente JDK_JAVA_OPTIONS per GroundRunner. Ad esempio, se utilizzi Databricks, devi utilizzare quanto segue:
  JDK_JAVA_OPTIONS="--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED". Questo è simile alle variabili di configurazione impostate in Installare e gestire i GroundRunner. 
  Importante: Dopo aver impostato questa variabile, devi riavviare il computer su cui sta operando il GroundRunner.

Nota: Il driver deve trovarsi sul GroundRunner, in quanto i file .jar non possono essere caricati come risorse.

Configura il connettore JDBC

Nota: Per rendere il connettore disponibile per l'uso nelle catene della tua organizzazione, un amministratore della sicurezza dell'org deve prima abilitarlo da Configurazione.

1. Da Chain Builder, clicca su Connections compare_arrows, e poi su Create in alto a destra.
2. In Connector Connection, seleziona JDBC e il GroundRunner da utilizzare con la connessione.
   
3. In Informazioni di base, inserisci un nome e una descrizione unici per identificare la connessione.

4. In Proprietà, inserisci i dettagli della connessione:
   

   Proprietà	Dettagli
   Nome utente	Inserisci il nome utente dell'utente di integrazione del connettore.
   Password	Inserisci la password per la proprietà Nome utente.
   URL di connessione	Inserisci l'URL della connessione JDBC, ad esempio jdbc:solution://host:port/database.
   Classe dell'unità JDBC	Inserisci il nome della classe del file .jar del driver JDBC. Ad esempio, per Sybase®, inserisci com.sybase.jdbc.sybdriver.
   Percorso del driver JDBC	Inserisci il percorso dell'installazione del driver JDBC nel file system di GroundRunner.

   Nota: Tutte le credenziali sensibili vengono automaticamente crittografate e memorizzate con la crittografia Advanced Encryption Standard (AES)-256.

5. Seleziona gli ambienti da utilizzare per la connessione e clicca su Salva.
6. Spegni e riavvia il computer su cui è in esecuzione GroundRunner per reinizializzare la JVM.
7. Per testare la connessione, crea ed esegui una catena con il comando Ottieni la definizione della tabella del connettore e verifica che restituisca un output valido.

Risoluzione dei problemi

Se la connessione JDBC fallisce:

• Verifica le credenziali di autenticazione dell'utente dell'integrazione.
• Controlla l'URL della connessione JDBC, compresi il server, la porta e il database.
• Verifica il nome della classe o il percorso del driver JDBC inserito per il connettore.

Se la connessione non riesce a eseguire un comando, verifica che i suoi input (come la sintassi SQL o la tabella) siano validi.