Workiva-ondersteuningscentrum

Met de Snowflake® JDBC-connector kunt u opdrachten in een keten gebruiken om SQL -bewerkingen (Structured Query Language) uit te voeren in Snowflake-databases. Met deze connector kunt u bijvoorbeeld het volgende doen:

• Voer SQL-opdrachten uit, inclusief een CREATE of UPDATE statement of SELECT query
• Details over een tabel in Snowflake ophalen.
• Voeg records in een Snowflake-database in.

Opmerking: Deze connector is gebouwd door Workiva en maakt verbinding met een systeem van derden. Hoewel ons supportteam u kan helpen bij het configureren van deze connector binnen uw werkruimte, kunnen we geen problemen oplossen of anderszins ondersteuning bieden bij problemen die buiten het Workiva-platform ontstaan.

Voorwaarden

Om de verbinding met Snowflake mogelijk te maken, moet een beveiligingsbeheerder van de organisatie deze eerst inschakelen via Configuratie.

De connector zelf maakt gebruik van Java-databaseconnectiviteit (JDBC), beveiligd met basisauthenticatie of authenticatie met sleutelparen. Om de connector in te stellen, hebt u het volgende nodig:

• Een in Snowflake aangemaakte integratiegebruiker voor de connector, plus de gebruikersnaam en het wachtwoord van die integratiegebruiker.

  Opmerking: Basisauthenticatie wordt vanaf november 2025 niet meer ondersteund. Wij raden aan om in plaats daarvan authenticatie met sleutelparen te gebruiken. Leer meer.

• (Optioneel) Een privé-sleutelbestand om authenticatie met sleutelparen mogelijk te maken .
• De URL van de JDBC-verbinding, bijvoorbeeld jdbc:snowflake://[accountName].snowflakecomputing.com/?[options]
• Om verbinding te maken met een on-premise Snowflake-database, een GroundRunner voor de verbinding. (Gebruik de standaard CloudRunner om verbinding te maken met een Snowflake-cloudinstantie.)

mTLS-verbindingen met Snowflake

Als u een mTLS-verbinding met Snowflake nodig hebt, raden we u aan de HTTPS-connector te gebruiken in plaats van de Snowflake JDBC-connector. We ondersteunen momenteel geen automatische rotatie van mTLS-certificaten, dus de certificaten moeten handmatig via de verbinding worden bijgewerkt en opgeslagen wanneer ze worden gewijzigd.

Configureer de Snowflake-connector.

1. Klik in Chain Builderop Connectionscompare_arrowsen vervolgens op Create rechtsboven.
2. Selecteer onder Connector Connectionde optie Snowflake JDBCen de runner die u met de verbinding wilt gebruiken.
   
3. Voer onder Basisinfoeen unieke naam en beschrijving in om de verbinding te identificeren.
4. (Optioneel) Upload onder Resourcesuw privésleutelbestand. U moet deze exacte bestandsnaam invoeren in het veld "Privésleutelbestand" in de volgende stap.

5. Voer onder Eigenschappende details van de connector in:
   

   Eigendom	Details
   Gebruikersnaam	Voer de gebruikersnaam in waarmee u zich wilt aanmelden. Als hieronder een privésleutelbestand wordt opgegeven, wordt de authenticatie met deze gebruikersnaam automatisch uitgevoerd.
   Wachtwoord	Voer het wachtwoord in voor de eigenschap Gebruikersnaam. Als er hieronder een bestand met een privésleutel wordt weergegeven, voer dan hier het wachtwoord in.   Opmerking: Laat dit veld leeg voor niet-versleutelde sleutelbestanden.
   Verbindings-URL	Voer de URL voor de JDBC-verbinding in, bijvoorbeeld jdbc:snowflake://[accountName].snowflakecomputing.com/. Om optionele eigenschappen voor de verbinding toe te voegen, voegt u deze toe als een queryreeks.Om bijvoorbeeld een login automatisch te laten verlopen als de verbinding binnen een minuut niet tot stand komt, voegt u ?loginTimeout=60toe.
   Privé-sleutelbestand	(Optioneel) Wordt gebruikt voor authenticatie met de publieke sleutel van de server. Voer de gebruikersnaam en het wachtwoord in de bovenstaande velden in. Meer informatie: Sleutelpaarverificatie en sleutelpaarrotatie Opmerking: De bestandsnaam moet overeenkomen met een bestand dat als verbindingsbron is geüpload.

   Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met behulp van de Advanced Encryption Standard (AES)-256-codering. Vermijd om veiligheidsredenen het opnemen van gebruikersgegevens als optionele eigenschappen binnen de eigenschap Verbindings-URL

   .
6. Selecteer de omgevingen die u met de verbinding wilt gebruiken en klik op Opslaan.
7. Om de verbinding te testen, maak en voer een keten uit met de opdracht GetTable Definition van de connector en controleerof deze een geldige uitvoer retourneert.

Probleemoplossing

• Als de verbinding met Snowflake mislukt:
  • Controleer de authenticatiegegevens.
  • Als u authenticatie met sleutelparen gebruikt, zorg er dan voor dat de bestandsnaam die via Resources wordt geüpload, overeenkomt met de bestandsnaam die is ingevoerd in het veld Private Key File.
  • Controleer de URL van de JDBC-verbinding, inclusief de accountnaam.
  • Als u verbinding maakt met een on-premise database, controleer dan de GroundRunner die voor de connector is geselecteerd.
• Als de verbinding een opdracht niet kan uitvoeren, controleer dan of de invoer, zoals de SQL-syntaxis of de tabel, geldig is.
• Als een Snowflake-opdracht mislukt met de foutmelding Inkomend verzoek met IP/Token XX.XX.XX.XX heeft geen toegang tot Snowflake, raadpleeg dan dit Snowflake-artikel voor instructies over het toevoegen van het vereiste IP-adres (CloudRunner of GroundRunner) aan de lijst met toegestane IP-adressen in uw Snowflake-instantie.