Workiva-ondersteuningscentrum

Met de Snowflake® JDBC-connector kunt u commando's in een keten gebruiken om gestructureerde querytaal (SQL)-bewerkingen in Snowflake-databases uit te voeren. Met deze connector kunt u bijvoorbeeld:

• SQL-opdrachten uitvoeren, inclusief een CREATE of UPDATE verklaring of SELECT query
• Details over een tabel in Snowflake ophalen
• Records invoegen in een Snowflake-database

Opmerking: Deze connector is gebouwd door Workiva en maakt verbinding met een systeem van derden. Hoewel ons Support team kan helpen bij het configureren van deze connector binnen uw workspace, kunnen wij geen problemen oplossen of op een andere manier helpen met problemen die hun oorsprong vinden buiten het Workiva platform.

Vereisten

Om de verbinding met de Snowflake in te schakelen, moet een org-beveiligingsbeheerder deze eerst inschakelen vanaf Configuratie.

De connector zelf gebruikt Java database connectiviteit (JDBC), beveiligd met basis- of sleutelpaarauthenticatie. Om de connector in te stellen, hebt u het volgende nodig:

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

  Opmerking: Basic auth wordt vanaf november 2025 niet langer ondersteund. Wij raden aan om in plaats daarvan sleutelpaarauthenticatie te gebruiken. Meer informatie.

• (Optioneel) Een privésleutelbestand om sleutelpaarauthenticatie in te schakelen.
• De URL van de JDBC-verbinding, zoals jdbc:snowflake://[accountnaam].snowflakecomputing.com/?[opties]
• Om verbinding te maken met een on-premise Snowflake database, een GroundRunner voor de verbinding. (Om verbinding te maken met een cloud-instantie van Snowflake, gebruikt u de standaard CloudRunner)

De Snowflake-connector instellen

1. Ga naar Chain Builder, klik op Connectionscompare_arrows, en vervolgens op Create rechtsboven.
2. Selecteer onder Connector Connection Snowflake JDBC en de runner die u met de verbinding wilt gebruiken.
   
3. Voer onder Basisinfo een unieke naam en beschrijving in om de verbinding te helpen identificeren.
4. (Optioneel) Upload uw privésleutelbestand onder Resources. In de volgende stap moet u deze exacte bestandsnaam invoeren in het veld "Private key file" (Privé sleutelbestand).
5. Voer onder Eigenschappen de gegevens van de connector in:
   
   

   Eigendom	Details
   Gebruikersnaam	Voer de gebruikersnaam in waarmee u zich wilt verifiëren. Als hieronder een bestand met een privésleutel is opgegeven, zal het automatisch verifiëren op deze gebruikersnaam.
   Wachtwoord	Voer het wachtwoord in voor de eigenschap Username. Als hieronder een bestand met een privésleutel wordt geleverd, voert u hier het wachtwoord in. Opmerking: Blanco laten voor niet-gecodeerde sleutelbestanden.
   URL verbinding	Voer de URL voor de JDBC-verbinding in, zoals jdbc:snowflake://[accountnaam].snowflakecomputing.com/. Om optionele eigenschappen voor de verbinding op te nemen, voegt u ze toe als een querystring. Om bijvoorbeeld een aanmelding automatisch te time-outen als het niet lukt om binnen een minuut verbinding te maken, voegt u ?loginTimeout=60 toe.
   Privé sleutelbestand	(Optioneel) Gebruikt voor verificatie met de openbare sleutel van de server. De gebruikersnaam en het wachtwoord moeten in de bovenstaande velden worden ingevoerd. Meer informatie: Sleutelpaarauthenticatie 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 Advanced Encryption Standard (AES)-256 codering. Vermijd om veiligheidsredenen het opnemen van gebruikersreferenties als optionele eigenschappen binnen de eigenschap Connection URL.

6. Selecteer de omgevingen die u met de verbinding wilt gebruiken en klik op Opslaan.
7. Om de verbinding te testen, maakt een ketting aan en voert deze uit met de opdracht Get Table Definition van de connector en controleert of deze een geldige uitvoer oplevert.

Probleemoplossing

• Als de verbinding met Snowflake mislukt:
  • Controleer de verificatiegegevens.
  • Als u auth met sleutelparen gebruikt, zorg er dan voor dat de bestandsnaam die u uploadt via Resources overeenkomt met de bestandsnaam die is ingevoerd in het veld Private Key File.
  • Controleer de URL voor 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 tabel, geldig is.
• Als een Snowflake-opdracht mislukt met het foutbericht Inkomend verzoek met IP/Token XX.XX.XX.XX is niet toegestaan voor toegang tot Snowflake, raadpleeg dan dit Snowflake-artikel voor begeleiding bij het toevoegen van het vereiste IP-adres (ofwel CloudRunner of GroundRunner) aan de Toegestaan IP-lijst in uw Snowflake-instantie.