Med Snowflake® JDBC Connector kan du använda kommandon i en kedja för att utföra SQL-operationer (Structured Query Language) i Snowflake-databaser. Med den här kontakten kan du t.ex:
- Exekvera SQL-kommandon, inklusive en
CREATEellerUPDATE-sats ellerSELECT-fråga - Hämta information om en tabell i Snowflake
- Infoga poster i en Snowflake-databas
Obs: Denna kontakt är byggd av Workiva och ansluts till ett system från tredje part. Vår support kan hjälpa till att konfigurera den här anslutningen i din arbetsyta, men vi kan inte felsöka eller på annat sätt hjälpa till med problem som uppstår utanför Workiva-plattformen.
Förkunskapskrav
För att aktivera anslutningen till Snowflake måste en säkerhetsadministratör i organisationen först aktivera den från Konfiguration.
Själva anslutningen använder JDBC (Java Database Connectivity) och är värdepapperiserad med antingen grundläggande autentisering eller nyckelparsautentisering. För att sätta upp kontakten behöver du:
- En utsedd integrationsanvändare som skapats i Snowflake för anslutningen, samt integrationsanvändarens användarnamn och lösenord.
Obs: Basic auth kommer inte längre att ha support från och med november 2025. Vi rekommenderar att du använder nyckelparsautentisering istället. Läs mer.
- (Valfritt) En privat nyckelfil för att aktivera autentisering av nyckelpar.
- JDBC-anslutningens URL, t.ex.
jdbc:snowflake://[kontonamn].snowflakecomputing.com/?[alternativ] - För att ansluta till en lokal Snowflake-databas, en GroundRunner för anslutningen. (För att ansluta till en molninstans av Snowflake använder du standard CloudRunner).
Konfigurera Snowflake-anslutningen
- Från Chain Builder, klicka på Connections , och sedan Create längst upp till höger.
- Under Connector Connection väljer du Snowflake JDBC och den körare som ska användas med anslutningen.
- Under Basic Info anger du ett unikt namn och en beskrivning som hjälper dig att identifiera anslutningen.
- (Valfritt) Under Resources, ladda upp din privata nyckelfil. Du måste ange exakt det här filnamnet i fältet "Private key file" i nästa steg.
- Under Properties anger du kontaktens detaljer:
Egenskap Information Användarnamn Ange det användarnamn som du vill autentisera dig med. Om en privat nyckelfil anges nedan kommer den automatiskt att autentiseras till detta användarnamn. Lösenord Ange lösenordet för egenskapen Username. Om en privat nyckelfil tillhandahålls nedan anger du lösenordet här.
Obs: Lämna tomt för okrypterade nyckelfiler.
URL för anslutning Ange URL:en för JDBC-anslutningen, till exempel
jdbc:snowflake://[kontonamn].snowflakecomputing.com/.För att inkludera valfria egenskaper för anslutningen, lägg till dem som en frågesträng. Om du till exempel vill att en inloggning automatiskt ska ha en timeout om den inte går att ansluta inom en minut, lägger du till
?loginTimeout=60.Fil med privat nyckel (Valfritt) Används för autentisering med serverns publika nyckel. Användarnamn och lösenord ska anges i fälten ovan.
Läs mer om detta: Autentisering av nyckelpar och rotation av nyckelpar
Anm.: Filnamnet måste matcha en fil som laddats upp som en anslutningsresurs.
Obs: Alla känsliga uppgifter krypteras automatiskt och lagras med Advanced Encryption Standard (AES)-256-kryptering. Av säkerhetsskäl bör du undvika att inkludera användaruppgifter som valfria egenskaper i egenskapen Connection URL.
- Välj de miljöer som ska användas med anslutningen och klicka på Save.
- Testa anslutningen genom att skapa och köra en kedja med kommandot Get Table Definition från connector och kontrollera att den returnerar en giltig utdata.
Felsökning
- Om anslutningen till Snowflake går sönder:
- Verifiera autentiseringsuppgifterna.
- Om du använder autentisering med nyckelpar ska du se till att filnamnet som laddas upp via Resources stämmer överens med filnamnet som anges i fältet Private Key File.
- Kontrollera URL:en för JDBC-anslutningen, inklusive kontonamnet.
- Om du ansluter till en lokal databas ska du kontrollera vilken GroundRunner som valts för anslutningen.
- Om anslutningen inte kan utföra ett kommando ska du kontrollera att dess indata, t.ex. SQL-syntaxen eller tabellen, är giltiga.
- Om ett Snowflake-kommando misslyckas med felmeddelandet Incoming request with IP/Token XX.XX.XX.XX is not allowed to access Snowflake, se denna Snowflake-artikel för vägledning om hur du lägger till den IP-adress som krävs (antingen CloudRunner eller GroundRunner) i listan över tillåtna IP-adresser i din Snowflake-instans.