Centro assistenza di Workiva

Con il connettore Snowflake® JDBC, puoi utilizzare i comandi in una catena per eseguire operazioni in linguaggio di query strutturato (SQL) nei database Snowflake. 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 Snowflake
• Inserire record in un database Snowflake

Nota: Questo connettore è stato realizzato da Workiva e si collega a un sistema di terze parti. Sebbene il nostro team di assistenza possa aiutare a configurare questo connettore all'interno del tuo spazio di lavoro, non siamo in grado di risolvere i problemi o di fornire assistenza in altro modo per qualsiasi problema che abbia origine al di fuori della piattaforma Workiva.

Prerequisiti

Per abilitare la connessione a Snowflake, l'amministratore della sicurezza dell'org deve prima abilitare da Configurazione.

Il connettore stesso utilizza la connettività del database Java (JDBC), protetta da un'autenticazione di base o a coppie di chiavi. Per configurare il connettore, avrai bisogno di:

• Un utente di integrazione designato creato in Snowflake per il connettore, oltre al nome utente e alla password dell'utente di integrazione.
  

  Nota: L'autenticazione di base non sarà più supportata a partire da novembre 2025. Ti consigliamo di utilizzare l'autenticazione a coppia di chiavi. Per saperne di più.

• (Facoltativo) Un file di chiave privata per abilitare l'autenticazione della coppia di chiavi.
• L'URL della connessione JDBC, ad esempio jdbc:snowflake://[accountName].snowflakecomputing.com/?[options]
• Per connettersi a un database Snowflake on-premise, un GroundRunner per la connessione. (Per connetterti a un'istanza cloud di Snowflake, usa il CloudRunner predefinito).

Imposta il connettore Snowflake

1. Da Builder catena, clicca su Connessioni compare_arrows e poi su Crea in alto a destra.
2. In Connector Connection, seleziona Snowflake JDBC 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. (Facoltativo) Alla voce Resources, carica il file della tua chiave privata. Dovrai inserire il nome esatto di questo file nel campo "File chiave privato" nel passaggio successivo.
5. In Proprietà, inserisci i dettagli del connettore:
   
   

   Proprietà	Dettagli
   Nome utente	Inserisci il nome utente con cui autenticarti. Se viene fornito un file di chiave privata, l'autenticazione avverrà automaticamente con questo nome utente.
   Password	Inserisci la password per la proprietà Nome utente. Se viene fornito un file di chiave privata, inserisci qui la password. Nota: Lasciare vuoto per i file chiave non crittografati.
   URL di connessione	Inserisci l'URL della connessione JDBC, ad esempio jdbc:snowflake://[accountName].snowflakecomputing.com/. Per includere le proprietà opzionali della connessione, aggiungile come stringa di query. Ad esempio, per interrompere automaticamente l'accesso se non riesce a connettersi entro un minuto, aggiungi ?loginTimeout=60.
   File chiave privata	(Opzionale) Utilizzato per l'autenticazione con la chiave pubblica del server. Il nome utente e la password devono essere inseriti nei campi precedenti. Per saperne di più: Autenticazione e rotazione delle coppie di chiavi Nota: Il nome del file deve corrispondere a un file caricato come risorsa di connessione.

   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.

6. Seleziona gli ambienti da utilizzare per la connessione e clicca su Salva.
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 a Snowflake fallisce:
  • Verifica le credenziali di autenticazione.
  • Se si utilizza l'autenticazione a coppia di chiavi, assicurati che il nome del file caricato tramite Resources corrisponda al nome del file inserito nel campo Private Key File.
  • Controlla l'URL della connessione JDBC, compreso il nome dell'account.
  • 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.
• Se un comando Snowflake fallisce con il messaggio di errore Incoming request with IP/Token XX.XX.XX.XX is not allowed to access Snowflake, fai riferimento a questo articolo di Snowflake per indicazioni su come aggiungere l'indirizzo IP richiesto ( CloudRunner o GroundRunner) all'elenco degli IP consentiti nella tua istanza Snowflake.