Schneeflocken-Verbinder

Abfrage von Informationen aus Snowflake zur Verwendung mit Tulip-Anwendungen

Der Snowflake Connector vereinfacht die Abfrage von Informationen aus einer Snowflake Data Cloud. Die Snowflake SQL REST API Dokumentation finden Sie hier.

Support-Kontakt

Dieser Connector wurde in Zusammenarbeit mit Spaulding Ridge entwickelt. Für weitere Informationen oder Fragen wenden Sie sich bitte an Spaulding Ridge unter info@spauldingridge.com

Hinweise zum Konnektor

Der Snowflake-Konnektor kann einzelne Datensätze relativ einfach bearbeiten. Für die Abfrage mehrerer Datenzeilen oder die Bearbeitung von Ausgaben in Tulip (interaktive Tabelle usw.) können benutzerdefinierte Widgets erforderlich sein.

Snowflake OAuth verwendet den in Snowflake integrierten OAuth-Dienst und unterstützt Tulip als benutzerdefinierten Client. Die Snowflake OAuth-Dokumentation finden Sie hier. Details zur Konfiguration des benutzerdefinierten Clients finden Sie hier.

Einrichtung

In diesem Abschnitt wird beschrieben, wie ein OAuth-Token vom OAuth-Server von Snowflake konfiguriert wird, um eine Verbindung mit Tulip als Client herzustellen, und wie der Snowflake Connector in Tulip eingerichtet wird.

Tulip als Client-Anwendung in Snowflake registrieren

1. Melden Sie sich bei Ihrer Snowflake-Instanz mit einem Benutzer an, der die Rolle/Berechtigung hat, Sicherheitsintegrationen zu erstellen und zu verwalten (ACCOUNTADMIN).
2. Erstellen Sie ein neues SQL-Arbeitsblatt im Lager COMPUTE_WH.
3. Führen Sie das folgende Script aus, um eine Sicherheitsintegration vom Typ OAuth zu erstellen. Vergessen Sie nicht, die Werte für INTEGRATION_NAME, TULIP_INSTANCE_NAME und TIME_IN_SECONDS zu aktualisieren.

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>;

Hinweis: Die Gültigkeit des Refresh Token kann bis zu 1 Tag (86400 Sekunden) betragen.

Sammeln Sie Details für die OAuth-Konfiguration in Tulip

1. Führen Sie die folgenden Befehle aus, um die gerade erstellte Sicherheitsintegration zu beschreiben undDESCRIBE SECURITY INTEGRATION ;
2. Schreiben Sie die folgenden Details auf:OAUTH_CLIENT_IDOAUTH_REDIRECT_URIOAUTH_AUTHORIZATION_ENDPOINTOAUTH_TOKEN_ENDPOINT
3. Ausführen:SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('<INTEGRATION_NAME>');

**muss voll ausgeschrieben sein,**z.B. nicht tulip_intergation sondern TULIP_INTEGRATION

1. Notieren Sie:OAUTH_CLIENT_SECRET

Konfigurieren Sie Ihren Snowflake-Konnektor

1. Loggen Sie sich in Tulip ein und fügen Sie hier den Snowflake Connector aus der Tulip Bibliothek hinzu (Web oder Embedded).
2. Klicken Sie in die Produktionsumgebung
3. Setzen Sie die folgenden Einstellungen:

Ausgeführt auf: Cloud Connector HostServer Adresse: Ihre Snowflake-Konto-Server-Url im Format .snowflakecomputing.comBase path: api/v2AuthenticationWählen Sie entweder Dienst oder Benutzer OAuthAuthorization code URL - OAUTH_AUTHORIZATION_ENDPOINT aus Schritt 2Access token URL - OAUTH_TOKEN_ENDPOINT aus Schritt 2Client ID - OAUTH_CLIENT_ID aus Schritt 2Client Secret - OAUTH_CLIENT_SECRET aus Schritt 2Aktivieren Sie die Kontrollkästchen fürSend authentication headerEncode client ID during authentication

1. Klicken Sie auf Testen. Sie werden zum Anmeldefenster Ihres Snowflake-Kontos weitergeleitet.

Ein Benutzer muss sich anmelden. Beachten Sie, dass seine Standardrolle nicht ACCOUNTADMIN, SECURITYADMIN oder ORGADMIN sein darf. Sie können die Standardrolle des Benutzers für OAuth ändern, wie in dieser Snowflake-Ressource beschrieben: Verwalten der Benutzerzustimmung für OAuth.

1. Nach erfolgreicher Authentifizierung wird eine Meldung zur Zustimmung angezeigt. Bitte lesen Sie diese sorgfältig durch, um den Vorgang zu verstehen, der durchgeführt wird, und klicken Sie dann auf Zulassen.

Jetzt können Sie sich von Tulip aus sicher mit Snowflake verbinden!

Verwendung

Sie haben zwei Möglichkeiten, den Konnektor zu verwenden:

Beginnen Sie mit der Anpassung der Funktionen der Konnektorvorlage an Ihre spezifischen Anforderungen.

Folgen Sie den Snowflake Unit Test Anweisungen für eine praktische Demonstration der Verwendung des Konnektors für Aufgaben wie: Abrufen aller Tabellendatensätze aus einer Snowflake Tabelle in Tulip, Erstellen eines neuen Datensatzes, Aktualisieren eines bestehenden Datensatzes und Löschen eines Datensatzes.

Vorlagenfunktionen

Der Library-Konnektor enthält die folgenden Vorlagenfunktionen:Vorlage: Abfrage der DatenbankBeschreibung: Ermöglicht es Ihnen, eine oder mehrere SQL-Anweisungen zur Ausführung zu übermitteln.Methode: POSTEndpoint: /api/v2/statementsReferenz: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statementsTemplate: Check Query StatusBeschreibung: Ermöglicht es Ihnen, den Status der Ausführung einer Anweisung zu überprüfen.method: GETEndpoint: /api/v2/statements/{statementHandle}Referenz: https://docs.snowflake.com/en/developer-guide/sql-api/reference#get-api-v2-statements-statementhandleTemplate: Cancel QueryDescription: Ermöglicht es Ihnen, die Ausführung einer Anweisung abzubrechen.Method: POSTEndpoint: /api/v2/statements/{statementHandle}/cancelReferenz: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statements-statementhandle-cancel

Zusätzliche Referenzen

Dieser Leitfaden der Snowflake-Community bietet zusätzlichen Kontext zur Snowflake-Integration