Złącze płatka śniegu

Zapytania o informacje ze Snowflake do wykorzystania w aplikacjach Tulip

Konektor Snowflake usprawnia sposób wysyłania zapytań o informacje z chmury danych Snowflake. Dokumentację Snowflake SQL REST API można znaleźć tutaj.

Kontakt wsparcia

Ten konektor został stworzony we współpracy z firmą Spaulding Ridge. Aby uzyskać więcej informacji lub zadać pytania, prosimy o kontakt z firmą Spaulding Ridge pod adresem info@spauldingridge.com.

Uwagi dotyczące konektora

Konektor Snowflake może stosunkowo łatwo manipulować pojedynczymi rekordami. Niestandardowe widżety mogą być konieczne do odpytywania wielu wierszy danych lub manipulowania danymi wyjściowymi w Tulip (interaktywna tabela itp.).

Snowflake OAuth wykorzystuje wbudowaną usługę Snowflake OAuth i obsługuje Tulip jako klienta niestandardowego. Dokumentację Snowflake OAuth można znaleźć tutaj. Szczegóły konfiguracji klienta niestandardowego można znaleźć tutaj.

Konfiguracja

Ta sekcja zawiera procedurę konfigurowania tokena OAuth z serwera OAuth Snowflake w celu nawiązania łączności z Tulip jako klientem, a także kroki konfiguracji konektora Snowflake w Tulip.

Zarejestruj Tulip jako aplikację kliencką w Snowflake

1. Zaloguj się do instancji Snowflake z użytkownikiem, który ma rolę/uprawnienia do tworzenia i zarządzania Security Integrations (ACCOUNTADMIN).
2. Utwórz nowy arkusz SQL w magazynie COMPUTE_WH.
3. Uruchom poniższy skrypt, aby utworzyć Security Integration typu OAuth. Nie zapomnij zaktualizować wartości INTEGRATION_NAME, TULIP_INSTANCE_NAME i TIME_IN_SECONDS.

CREATE OR REPLACE SECURITY INTEGRATION <INTEGRATION_NAME>TYPE = OAUTHENABLED = TRUEOAUTH_CLIENT = CUSTOMOAUTH_CLIENT_TYPE = 'CONFIDENTIAL'OAUTH_REDIRECT_URI = 'https://<TULIP_INSTANCE_NAME>.tulip.co/oauth-redirect-handler'OAUTH_ISSUE_REFRESH_TOKENS = TRUEOAUTH_ISSUE_REFRESH_TOKEN_VALIDITY = <TIME_IN_SECONDS>;

Uwaga: Ważność tokenu odświeżania może wynosić nawet 1 dzień (86400 sekund).

Zbieranie szczegółów konfiguracji OAuth w Tulip

1. Uruchom następujące polecenia, aby opisać właśnie utworzoną integrację zabezpieczeń iDESCRIBE SECURITY INTEGRATION ;
2. Zapisz poniższe szczegóły:OAUTH_CLIENT_IDOAUTH_REDIRECT_URIOAUTH_AUTHORIZATION_ENDPOINTOAUTH_TOKEN_ENDPOINT
3. Uruchom:SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('<NAZWA_INTEGRACJI>');

nie tulip_intergation, ale TULIP_INTEGRATION.

1. Zapisz:OAUTH_CLIENT_SECRET

Skonfiguruj konektor Snowflake

1. Zaloguj się do Tulip i dodaj Snowflake Connector z biblioteki Tulip tutaj (Web lub Embedded).
2. Kliknij do środowiska produkcyjnego
3. Skonfiguruj następujące ustawienia:

Running On: Cloud Connector HostServer address: Twój adres url serwera konta snowflake w formacie .snowflakecomputing.comBase path: api/v2AuthenticationSelect either service or user OAuthAuthorization code URL - OAUTH_AUTHORIZATION_ENDPOINT from step 2Access token URL - OAUTH_TOKEN_ENDPOINT from step 2Client ID - OAUTH_CLIENT_ID from step 2Client Secret - OAUTH_CLIENT_SECRET from step 2Select check boxes forSend authentication headerEncode client ID during authentication

1. Kliknij Test. Nastąpi przejście do okna logowania do konta Snowflake.

Użytkownik musi się zalogować. Należy pamiętać, że jego domyślną rolą nie może być ACCOUNTADMIN, SECURITYADMIN ani ORGADMIN. Możesz zmienić domyślną rolę użytkowników dla OAuth, jak opisano szczegółowo w tym zasobie Snowflake: Zarządzanie zgodą użytkownika dla OAuth.

1. Po pomyślnym uwierzytelnieniu pojawi się komunikat z prośbą o wyrażenie zgody. Przeczytaj go uważnie, aby zrozumieć wykonywaną operację, a następnie kliknij Zezwól.

Możesz teraz bezpiecznie łączyć się ze Snowflake z Tulip!

Użycie

Istnieją dwie opcje rozpoczęcia korzystania z konektora:

Zacznij od dostosowania funkcji szablonu konektora do swoich specyficznych wymagań.

Postępuj zgodnie z instrukcjami testu jednostkowego Snowflake, aby uzyskać praktyczną demonstrację korzystania z konektora do zadań, w tym: pobierania wszystkich rekordów tabeli z tabeli Snowflake w Tulip, tworzenia nowego rekordu, aktualizowania istniejącego rekordu i usuwania rekordu.

Funkcje szablonów

Konektor Library zawiera następujące funkcje szablonów:Template: Query DatabaseOpis: Umożliwia przesłanie jednej lub więcej instrukcji SQL do wykonania.Metoda: POSTPunkt końcowy: /api/v2/statementsReference: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statementsTemplate: Check Query StatusDescription: Umożliwia sprawdzenie stanu wykonania instrukcji.Method: GETEndpoint: /api/v2/statements/{statementHandle}Reference: https://docs.snowflake.com/en/developer-guide/sql-api/reference#get-api-v2-statements-statementhandleTemplate: Cancel QueryOpis: Umożliwia anulowanie wykonania instrukcji.Method: POSTEndpoint: /api/v2/statements/{statementHandle}/cancelReference: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statements-statementhandle-cancel

Dodatkowe odniesienia

Ten przewodnik społeczności Snowflake zapewnia dodatkowy kontekst integracji Snowflake