Workiva kundestøttesenter

Med Snowflake® JDBC-koblingen kan du bruke kommandoer i en kjede for å utføre SQL-operasjoner (Structured Query Language) i Snowflake-databaser. Med denne kontakten kan du for eksempel:

• Utfør SQL-kommandoer, inkludert en CREATE - eller UPDATE -setning eller SELECT -spørring
• Hent detaljer om en tabell i Snowflake
• Sette inn poster i en Snowflake-database

Merknad: Denne koblingen er bygget av Workiva og kobles til et tredjepartssystem. Selv om supportteamet vårt kan hjelpe deg med å konfigurere denne koblingen i arbeidsområdet ditt, kan vi ikke feilsøke eller på annen måte hjelpe med problemer som oppstår utenfor Workiva-plattformen.

Forutsetninger

For å aktivere tilkoblingen til Snowflake, må en sikkerhetsadministrator i organisasjonen først aktivere den fra Konfigurasjon.

Selve koblingen bruker Java-databasetilkobling (JDBC), sikret med enten grunnleggende autentisering eller nøkkelparautentisering. For å sette opp koblingen trenger du:

• En angitt integrasjonsbruker opprettet i Snowflake for koblingen, pluss integrasjonsbrukerens brukernavn og passord.

  Merknad: Grunnleggende autentisering støttes ikke lenger fra november 2025. Vi anbefaler å bruke nøkkelpar-autentisering i stedet. Lær mer.

• (Valgfritt) En privat nøkkelfil for å aktivere nøkkelparautentisering.
• URL-adressen til JDBC-tilkoblingen, for eksempel jdbc:snowflake://[kontonavn].snowflakecomputing.com/?[alternativer]
• For å koble til en lokal Snowflake-database, en GroundRunner for tilkoblingen. (For å koble til en skyinstans av Snowflake, bruk standard CloudRunner.)

mTLS-tilkoblinger til Snowflake

Hvis du trenger en mTLS-tilkobling til Snowflake, anbefaler vi at du bruker HTTPs -koblingen i stedet for Snowflake JDBC-koblingen. Vi støtter for øyeblikket ikke automatisk rotasjon av mTLS-sertifikater, så sertifikatene må oppdateres manuelt via tilkoblingen og lagres når de endres.

Konfigurer Snowflake-koblingen

1. Fra Kjedebyggerklikker du på Tilkoblingercompare_arrowsog deretter på Opprett øverst til høyre.
2. Under Connector Connectionvelger du Snowflake JDBCog løperen som skal brukes med tilkoblingen.
   
3. Under Grunnleggende informasjonskriver du inn et unikt navn og en beskrivelse for å identifisere forbindelsen.
4. (Valgfritt) Under Ressurserlaster du opp den private nøkkelfilen din. Du må skrive inn nøyaktig dette filnavnet i feltet «Privat nøkkelfil» i neste trinn.

5. Under Egenskaperskriver du inn detaljene for koblingen:
   

   Egenskap	Detaljer
   Brukernavn	Skriv inn brukernavnet som skal autentiseres med. Hvis en privat nøkkelfil er oppgitt nedenfor, vil den automatisk autentiseres til dette brukernavnet.
   Passord	Skriv inn passordet for egenskapen Brukernavn. Hvis en privat nøkkelfil er oppgitt nedenfor, skriv inn passordet her.   Merk: La stå tomt for ukrypterte nøkkelfiler.
   Tilkoblings-URL	Skriv inn URL-en for JDBC-tilkoblingen, for eksempel jdbc:snowflake://[kontonavn].snowflakecomputing.com/. For å inkludere valgfrie egenskaper for tilkoblingen, legg dem til som en spørrestreng.Hvis du for eksempel vil automatisk tidsavbryte en pålogging hvis den ikke kobler til innen et minutt, legger du til ?loginTimeout=60.
   Privat nøkkelfil	(Valgfritt) Brukes for autentisering med serverens offentlige nøkkel. Brukernavn og passord skal skrives inn i feltene ovenfor. Lær mer: Nøkkelparautentisering og nøkkelparrotasjon Merknad: Filnavnet må samsvare med en fil som er lastet opp som en tilkoblingsressurs.

   Merk: All sensitiv påloggingsinformasjon krypteres automatisk og lagres med Advanced Encryption Standard (AES)-256-kryptering. Av sikkerhetshensyn bør du unngå å inkludere brukerlegitimasjon som valgfrie egenskaper i egenskapen Tilkoblings-URL

   .
6. Velg miljøene som skal brukes med tilkoblingen, og klikk på Lagre.
7. For å teste forbindelsen, opprett og kjør en kjede med -koblingens Get Table Definition-kommando, og bekreft at den returnerer en gyldig utdata.

Feilsøking

• Hvis tilkoblingen til Snowflake mislykkes:
  • Bekreft autentiseringslegitimasjonen.
  • Hvis du bruker nøkkelpar-autentisering, må du sørge for at filnavnet som lastes opp via Ressurser samsvarer med filnavnet som er angitt i feltet Privat nøkkelfil.
  • Sjekk URL-en for JDBC-tilkoblingen, inkludert kontonavnet.
  • Hvis du kobler til en lokal database, må du sjekke GroundRunner som er valgt for koblingen.
• Hvis tilkoblingen ikke klarer å utføre en kommando, må du kontrollere at inndataene, for eksempel SQL-syntaks eller -tabell, er gyldige.
• Hvis en Snowflake-kommando mislykkes med feilmeldingen Innkommende forespørsel med IP/Token XX.XX.XX.XX har ikke tilgang til Snowflake, kan du se denne Snowflake-artikkelen for veiledning om hvordan du legger til den nødvendige IP-adressen (enten CloudRunner eller GroundRunner) i listen over tillatte IP-adresser i Snowflake-instansen din.