Centrum wsparcia Workiva

Dzięki łącznikowi Snowflake® JDBC możesz używać poleceń w łańcuchu, aby wykonywać operacje języka zapytań strukturalnych (SQL) w bazach danych Snowflake. Na przykład za pomocą tego łącznika możesz:

• Wykonywanie poleceń SQL, w tym instrukcji CREATE lub UPDATE albo zapytania SELECT
• Pobierz szczegóły dotyczące tabeli w Snowflake
• Wstawianie rekordów do bazy danych Snowflake

Uwaga: Ten łącznik został stworzony przez firmę Workiva i łączy się z systemem innej firmy. Chociaż nasz zespół wsparcia może pomóc Ci skonfigurować ten łącznik w Twojej przestrzeni roboczej, nie jesteśmy w stanie rozwiązywać problemów ani udzielać pomocy w przypadku problemów, które mają swoje źródło poza platformą Workiva.

Wymagania wstępne

Aby umożliwić połączenie z Snowflake, administrator bezpieczeństwa organizacji musi najpierw włączyć je w Konfiguracji.

Sam łącznik wykorzystuje łączność z bazą danych Java (JDBC) zabezpieczoną uwierzytelnianiem podstawowym lub za pomocą pary kluczy. Aby skonfigurować łącznik, będziesz potrzebować:

• Wyznaczony użytkownik integracji utworzony w Snowflake dla łącznika, a także nazwa użytkownika i hasło użytkownika integracji.

  Uwaga: Od listopada 2025 r. uwierzytelnianie podstawowe nie będzie już obsługiwane. Zamiast tego zalecamy korzystanie z uwierzytelniania za pomocą pary kluczy. Dowiedz się więcej.

• (Opcjonalnie) Plik klucza prywatnego umożliwiający uwierzytelnianie za pomocą pary kluczy.
• Adres URL połączenia JDBC, taki jak jdbc:snowflake://[nazwa_konta].snowflakecomputing.com/?[opcje]
• Aby połączyć się z lokalną bazą danych Snowflake, GroundRunner dla połączenia. (Aby połączyć się z instancją w chmurze Snowflake, użyj domyślnego CloudRunner.)

Połączenia mTLS ze Snowflake

Jeśli potrzebujesz połączenia mTLS ze Snowflake, zalecamy użycie łącznika HTTPs zamiast łącznika Snowflake JDBC. Obecnie nie obsługujemy automatycznej rotacji certyfikatów mTLS, więc certyfikaty musiałyby być ręcznie aktualizowane za pośrednictwem połączenia i zapisywane po zmianie.

Skonfiguruj łącznik Snowflake

1. W Chain Builderkliknij Connectionscompare_arrows, a następnie Create w prawym górnym rogu.
2. W obszarze Połączenie złączawybierz Snowflake JDBCi moduł uruchamiający, który ma być używany z połączeniem.
   
3. W polu Informacje podstawowewprowadź unikalną nazwę i opis, aby ułatwić identyfikację połączenia.
4. (Opcjonalnie) W obszarze Zasobyprześlij plik swojego klucza prywatnego. W następnym kroku będziesz musiał wpisać tę dokładną nazwę pliku w polu „Plik klucza prywatnego”.

5. W obszarze Właściwościwprowadź szczegóły łącznika:
   

   Właściwość	Szczegóły
   Nazwa użytkownika	Wprowadź nazwę użytkownika, aby dokonać uwierzytelnienia. Jeśli poniżej znajduje się plik z kluczem prywatnym, zostanie on automatycznie uwierzytelniony przy użyciu tej nazwy użytkownika.
   Hasło	Wprowadź hasło dla właściwości Nazwa użytkownika. Jeśli poniżej znajduje się plik z kluczem prywatnym, wpisz tutaj hasło.   Uwaga: Pozostaw puste pole w przypadku niezaszyfrowanych plików kluczy.
   Adres URL połączenia	Wprowadź adres URL połączenia JDBC, na przykład jdbc:snowflake://[nazwa_konta].snowflakecomputing.com/. Aby uwzględnić opcjonalne właściwości połączenia, dołącz je jako ciąg zapytania.Na przykład, aby automatycznie wyłączyć logowanie, jeśli w ciągu minuty nie uda się nawiązać połączenia, należy dodać ?loginTimeout=60.
   Plik klucza prywatnego	(Opcjonalnie) Służy do uwierzytelniania przy użyciu klucza publicznego serwera. Nazwę użytkownika i hasło należy wpisać w pola powyżej. Dowiedz się więcej: Uwierzytelnianie za pomocą par kluczy i rotacja par kluczy Uwaga: Nazwa pliku musi odpowiadać nazwie pliku przesłanego jako zasób połączenia.

   Uwaga: Wszystkie poufne dane uwierzytelniające są automatycznie szyfrowane i przechowywane przy użyciu algorytmu Advanced Encryption Standard (AES)-256. Ze względów bezpieczeństwa należy unikać uwzględniania danych uwierzytelniających użytkownika jako opcjonalnych właściwości we właściwości Adres URL połączenia

   .
6. Wybierz środowiska, których chcesz używać z połączeniem i kliknij Zapisz.
7. Aby przetestować połączenie, utwórz i uruchom łańcuch za pomocą polecenia Pobierz definicję tabeliłącznikai sprawdź, czy zwraca on prawidłowy wynik.

Rozwiązywanie problemów

• Jeśli połączenie ze Snowflake nie powiedzie się:
  • Zweryfikuj dane uwierzytelniające.
  • Jeśli używasz uwierzytelniania za pomocą pary kluczy, upewnij się, że nazwa pliku przesłana za pomocą Zasoby jest zgodna z nazwą pliku wprowadzoną w polu Plik klucza prywatnego.
  • Sprawdź adres URL połączenia JDBC, w tym nazwę konta.
  • W przypadku łączenia się z lokalną bazą danych należy sprawdzić opcję GroundRunner wybraną dla łącznika.
• Jeżeli połączenie nie może wykonać polecenia, sprawdź, czy dane wejściowe, takie jak składnia SQL lub tabela, są prawidłowe.
• Jeśli polecenie Snowflake zakończy się niepowodzeniem i pojawi się komunikat o błędzie Żądanie przychodzące z adresem IP/tokenem XX.XX.XX.XX nie ma uprawnień dostępu do Snowflake, zapoznaj się z tym artykułem na temat Snowflake, aby uzyskać wskazówki dotyczące dodawania wymaganego adresu IP ( CloudRunner lub GroundRunner) do listy dozwolonych adresów IP w instancji Snowflake.