Workiva kundestøttesenter

Med Snowflake® JDBC Connector 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øre SQL-kommandoer, inkludert en CREATE eller UPDATE setning eller SELECT spørring
• Hent informasjon om en tabell i Snowflake
• Sette inn poster i en Snowflake-database

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

Forutsetninger

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

Selve konnektoren bruker Java-databasekonnektivitet (JDBC), som er sikret med enten grunnleggende autentisering eller nøkkelparautentisering. For å sette opp kontakten trenger du

• En utpekt integrasjonsbruker som er opprettet i Snowflake for kontakten, samt integrasjonsbrukerens brukernavn og passord.
  

  Merk: Basic auth vil ikke lenger støttes fra og med november 2025. Vi anbefaler at du bruker nøkkelparautentisering i stedet. Lær mer om dette.

• (Valgfritt) En privat nøkkelfil for å aktivere nøkkelparautentisering.
• JDBC-tilkoblingens URL, for eksempel jdbc:snowflake://[accountName].snowflakecomputing.com/?[options]
• Hvis du vil koble til en lokal Snowflake-database, bruker du en GroundRunner for tilkoblingen. (For å koble til en skyinstans av Snowflake bruker du standard CloudRunner)

Konfigurer Snowflake-kontakten

1. Fra Chain Builder klikker du på Connectionscompare_arrows, og deretter Create øverst til høyre.
2. Under Connector Connection velger du Snowflake JDBC og løperen som skal brukes med tilkoblingen.
   
3. Under Basic Info angir du et unikt navn og en beskrivelse for å identifisere tilkoblingen.
4. (Valgfritt) Under Resources laster du opp den private nøkkelfilen. Du må oppgi nøyaktig dette filnavnet i feltet "Private key file" i neste trinn.
5. Under Properties angir du kontaktens detaljer:
   
   

   Egenskap	Detaljer
   Brukernavn	Skriv inn brukernavnet du vil autentisere deg med. Hvis en privat nøkkelfil er oppgitt nedenfor, vil den automatisk autentiseres mot dette brukernavnet.
   Passord	Skriv inn passordet for egenskapen Username. Hvis en privat nøkkelfil er oppgitt nedenfor, skriver du inn passordet her. Merk: La stå tom for ukrypterte nøkkelfiler.
   URL for tilkobling	Skriv inn URL-adressen for JDBC-tilkoblingen, for eksempel jdbc:snowflake://[kontonavn].snowflakecomputing.com/. Hvis du vil inkludere valgfrie egenskaper for tilkoblingen, legger du dem til som en spørringsstreng. Hvis du for eksempel vil at en innlogging automatisk skal tidsavbrytes hvis den ikke kobler seg til i løpet av ett minutt, legger du til ?loginTimeout=60.
   Fil med privat nøkkel	(Valgfritt) Brukes for autentisering med serverens offentlige nøkkel. Brukernavn og passord skal oppgis i feltene ovenfor. Lær mer om dette: Nøkkelparautentisering og nøkkelparrotasjon Merknad: Filnavnet må samsvare med en fil som er lastet opp som en tilkoblingsressurs.

   Merk: Alle sensitive opplysninger krypteres automatisk og lagres med Advanced Encryption Standard (AES)-256-kryptering. Av sikkerhetshensyn bør du unngå å inkludere brukerlegitimasjon som valgfrie egenskaper i egenskapen Connection URL.

6. Velg miljøene som skal brukes med tilkoblingen, og klikk på Lagre.
7. For å teste tilkoblingen kan du opprette og kjøre en kjede med -kontaktens Get Table Definition -kommando, og kontrollere at den returnerer en gyldig utdata.

Feilsøking

• Hvis tilkoblingen til Snowflake mislykkes:
  • Bekreft autentiseringsinformasjonen.
  • Hvis du bruker autentisering av nøkkelpar, må du kontrollere at filnavnet som lastes opp via Resources, samsvarer med filnavnet som er angitt i feltet Private Key File.
  • Kontroller URL-adressen for JDBC-tilkoblingen, inkludert kontonavnet.
  • Hvis du kobler til en lokal database, må du kontrollere at GroundRunner er valgt for koblingen.
• Hvis tilkoblingen ikke klarer å utføre en kommando, må du kontrollere at inndataene, for eksempel SQL-syntaksen eller tabellen, er gyldige.
• Hvis en Snowflake-kommando mislykkes med feilmeldingen Innkommende forespørsel med IP/Token XX.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-forekomsten din.