Dzięki konektorowi Snowflake® JDBC możesz używać poleceń w łańcuchu do wykonywania operacji w strukturalnym języku zapytań (SQL) w bazach danych Snowflake. Na przykład, za pomocą tego złącza możesz:
- Wykonaj polecenia SQL, w tym instrukcję
CREATElubUPDATElub zapytanieSELECT - Pobierz szczegóły dotyczące tabeli w Snowflake
- Wstaw rekordy do bazy danych Snowflake
Uwaga: To złącze jest zbudowane przez Workiva i łączy się z systemem innej firmy. Chociaż nasz zespół pomocy technicznej może pomóc w skonfigurowaniu tego łącznika w Twojej przestrzeni roboczej, nie jesteśmy w stanie rozwiązywać problemów ani w inny sposób pomagać w przypadku jakichkolwiek problemów, które powstały poza platformą Workiva.
Wymagania wstępne
Aby włączyć połączenie z płatkiem śniegu, administrator bezpieczeństwa organizacji musi najpierw włączyć je z Konfiguracja.
Sam konektor wykorzystuje łączność z bazą danych Java (JDBC), zabezpieczoną uwierzytelnianiem podstawowym lub parą kluczy. Aby skonfigurować złącze, będziesz potrzebować
- Wyznaczony użytkownik integracji utworzony w Snowflake dla łącznika oraz nazwa użytkownika i hasło użytkownika integracji.
Uwaga: Autoryzacja podstawowa nie będzie już obsługiwana od listopada 2025 r. Zamiast tego zalecamy korzystanie z uwierzytelniania parami kluczy. Dowiedz się więcej.
- (Opcjonalnie) Plik klucza prywatnego umożliwiający uwierzytelnianie parą kluczy .
- Adres URL połączenia JDBC, taki jak
jdbc:snowflake://[accountName].snowflakecomputing.com/?[options] - Aby połączyć się z lokalną bazą danych Snowflake, GroundRunner dla połączenia. (Aby połączyć się z instancją Snowflake w chmurze, użyj domyślnego CloudRunnera)
Skonfiguruj złącze Snowflake
- Na stronie Chain Builder kliknij Connections, a następnie Create w prawym górnym rogu.
- W sekcji Connector Connection wybierz Snowflake JDBC i runner do użycia z połączeniem.
- W sekcji Basic Info wprowadź unikalną nazwę i opis, aby ułatwić identyfikację połączenia.
- (Opcjonalnie) W sekcji Resources prześlij plik klucza prywatnego. W następnym kroku musisz wprowadzić dokładną nazwę pliku w polu "Plik klucza prywatnego".
- W sekcji Properties wprowadź szczegóły łącznika:
Właściwość Szczegóły Nazwa użytkownika Wprowadź nazwę użytkownika do uwierzytelnienia. Jeśli poniżej podano plik klucza prywatnego, nastąpi automatyczne uwierzytelnienie do tej nazwy użytkownika. Hasło Wprowadź hasło dla właściwości Username. Jeśli poniżej znajduje się plik klucza prywatnego, wprowadź tutaj hasło.
Uwaga: Pozostaw puste dla niezaszyfrowanych plików kluczy.
Adres URL połączenia Wprowadź adres URL połączenia JDBC, np.
jdbc:snowflake://[accountName].snowflakecomputing.com/.Aby dołączyć opcjonalne właściwości dla połączenia, dołącz je jako ciąg zapytania. Na przykład, aby automatycznie przekroczyć limit czasu logowania, jeśli nie uda się połączyć w ciągu minuty, dodaj
?loginTimeout=60.Plik klucza prywatnego (Opcjonalnie) Służy do uwierzytelniania za pomocą klucza publicznego serwera. Nazwa użytkownika i hasło powinny zostać wprowadzone w polach powyżej.
Dowiedz się więcej: Uwierzytelnianie par kluczy i rotacja par kluczy
Uwaga: Nazwa pliku musi być zgodna z plikiem przesłanym jako zasób połączenia.
Uwaga: Wszystkie poufne dane uwierzytelniające są automatycznie szyfrowane i przechowywane przy użyciu szyfrowania Advanced Encryption Standard (AES) -256. Ze względów bezpieczeństwa unikaj włączania poświadczeń użytkownika jako opcjonalnych właściwości w ramach właściwości Connection URL.
- Wybierz środowiska, które mają być używane z połączeniem i kliknij Zapisz.
- Aby przetestować połączenie, utwórz i uruchom łańcuch z poleceniem Get Table Definition konektora i sprawdź, czy zwraca prawidłowe dane wyjściowe.
Rozwiązywanie problemów
- Jeśli połączenie ze Snowflake nie powiedzie się:
- Zweryfikuj dane uwierzytelniające.
- Jeśli korzystasz z uwierzytelniania za pomocą pary kluczy, upewnij się, że nazwa pliku przesłanego przez Resources jest zgodna z nazwą pliku wprowadzoną w polu Private Key File.
- Sprawdź adres URL połączenia JDBC, w tym nazwę konta.
- Jeśli łączysz się z lokalną bazą danych, sprawdź GroundRunner wybrany dla łącznika.
- Jeśli połączenie nie wykona polecenia, sprawdź, czy jego dane wejściowe, takie jak składnia SQL lub tabela, są prawidłowe.
- Jeśli polecenie Snowflake nie powiedzie się z komunikatem o błędzie Przychodzące żądanie z IP/Token XX.XX.XX.XX nie ma dostępu do Snowflake, zapoznaj się z tym artykułem Snowflake, aby uzyskać wskazówki dotyczące dodawania wymaganego adresu IP ( CloudRunner lub GroundRunner) do listy dozwolonych adresów IP w instancji Snowflake.