Centro assistenza di Workiva

Con il connettore Postgres, puoi utilizzare i comandi in una catena per eseguire operazioni in linguaggio di query strutturato (SQL) in sistemi di database PostgreSQL, come Amazon® Aurora®. Ad esempio, con questo connettore puoi:

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

Prerequisiti

Per attivare la connessione al database PostgreSQL, il connettore utilizza la connettività del database Java (JDBC), protetta da un'autenticazione di base con nome utente e password. Per configurare il connettore, avrai bisogno di:

• Un utente di integrazione designato creato nel database per il connettore
• Nome utente e password dell'utente dell'integrazione
• L'URL della connessione JDBC, ad esempio jdbc:postgresql://localhost:5432/sample
• Per connettersi a un database on-premise, un GroundRunner per la connessione

Nota: Per connetterti a un database PostgreSQL nel cloud, usa il CloudRunner predefinito.

Configura il connettore Postgres

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 Builder catena, clicca su Connessioni compare_arrows e poi su Crea in alto a destra.
2. Sotto Connettore Connessione, seleziona Postgres e il runner 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 del connettore:
   
   

   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:postgresql://<server>:<port>/<database>. Per includere le proprietà opzionali della connessione, aggiungile come stringa di query, ad esempio jdbc:postgresql://localhost:5432/sample?<options>. Ad esempio, per stabilire una connessione Secure Sockets Layer (SSL), aggiungi ?ssl=true. Nota: Per impostazione predefinita, la porta è 5432; tuttavia, potrebbe essere diversa per il tuo ambiente.

   Nota: Tutte le credenziali sensibili vengono automaticamente crittografate e memorizzate con la crittografia Advanced Encryption Standard (AES)-256. Per motivi di sicurezza, evita di includere le credenziali dell'utente come proprietà facoltative nella proprietà Connection URL.

5. Seleziona gli ambienti da utilizzare per la connessione e clicca su Salva.
6. 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 al database PostreSQL fallisce:

• • Verifica le credenziali di autenticazione dell'utente dell'integrazione.
  • Controlla l'URL della connessione JDBC, compresi il server e la porta.
  • Se la connessione è a un database on-premise, controlla il GroundRunner selezionato 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.