Schneeflocken-Verbinder

Abfrage von Informationen aus Snowflake zur Verwendung mit Tulip-Anwendungen

Zielgruppe

Bitte beachten Sie, dass Snowflake ein technisches Programm ist, für das Ihr IT-Support möglicherweise die entsprechenden Rollen und Berechtigungen einrichten muss.

Kontakt zur Unterstützung

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

Zweck

Der Snowflake-Konnektor vereinfacht die Abfrage von Informationen aus einer Snowflake Data Cloud.

Hinweise zum Konnektor

• Der Snowflake-Konnektor wird verwendet, um Informationen aus Snowflake abzufragen; derzeit gibt es keine Funktionalität, um direkt in Snowflake zu schreiben. Dies kann mit anderen Tools wie der Tabellen-API erreicht werden.
• Der Snowflake-Connect kann einzelne Zeilen relativ einfach als Variablen ausgeben. Für die Abfrage mehrerer Datenzeilen sind benutzerdefinierte Widgets zur Bearbeitung von Arrays erforderlich.
• DieSnowflake-Dokumentation ist hier zu finden.

Einrichtung

Für die korrekte Nutzung ist Folgendes erforderlich: * Fähigkeit zur Erstellung von Sicherheitsanmeldeinformationen mit der Rolle ACCOUNTADMIN * Fähigkeit zur Verwendung von Refresh Tokens zur Generierung zusätzlicher Access Tokens (Sicherheitspräferenz der meisten Unternehmen)

Um diese Konnektivität zu aktivieren, müssen Sie OAUTH auf Ihrer Snowflake-Instanz aktivieren. 1. Melden Sie sich bei Ihrer Snowflake-Instanz mit einem Benutzer an, der die Rolle ACCOUNTADMIN hat. 2. Führen Sie das folgende Skript aus, um eine OAUTH-Sicherheitsintegration zu erstellen

CREATE OR REPLACE SECURITY INTEGRATION oauth_tulip_int TYPE = OAUTH ENABLED = TRUE OAUTH_CLIENT = CUSTOM OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' OAUTH_REDIRECT_URI = 'https://[instance].tulip.co' OAUTH_ISSUE_REFRESH_TOKEN_VALIDITY = 7776000 BLOCKED_ROLES_LIST = ('SYSADMIN')HINWEIS: Die Gültigkeit von Refresh Token kann bis zu 90 Tage betragen. Zugriffstoken werden programmatisch generiert, Refresh-Tokens werden jedoch manuell erstelltSnowflake bietet zusätzliche Dokumentation zu Sicherheitsanmeldeinformationen

Stellen Sie sicher, dass Sie die OAUTH_REDIRECT_URI auf die URL Ihrer Tulip-Instanz aktualisieren

1. Führen Sie die folgende describe-Anweisung aus, um die folgenden Werte zu erhalten:
2. OAUTH_CLIENT_ID
3. OAUTH_REDIRECT_URI
4. OAUTH_AUTHORIZATION_ENDPOINT
5. OAUTH_TOKEN_ENDPOINT

DESC SECURITY INTEGRATION oauth_tulip_int;

1. Führen Sie die folgende select-Anweisung aus, um die OAUTH-Client-Geheimnisse zu erhalten:
2. OAUTH_CLIENT_SECRET2
3. OAUTH_CLIENT_SECRET

select SYSTEM$SHOW_OAUTH_CLIENT_SECRETS( 'OAUTH_TULIP_INT' );5. Fordern Sie einen Autorisierungscode an, indem Sie zu folgender URL navigieren:https://<yoursnowflakeinstance>.snowflakecomputing.com/oauth/authorize?response_type=code&client_id=<OAUTH_CLIENT_ID>&redirect_uri=<encoded value ofOAUTH_REDIRECT_URI>* Dies führt Sie zu einem Anmeldefenster, melden Sie sich an und erlauben Sie 'oauth_tulip_int', um auf Ihr Snowflake-Konto zuzugreifen. * Sie werden zu einer Seite weitergeleitet, deren URL code='xxxxxxxx' enthält. Dies ist Ihr Auth Code Grant, speichern Sie diesen für die Verbindung innerhalb von Tulip.Bitte beachten Sie:* Alle Abfrageparameter müssen kodiert werden. Verwenden Sie ein Tool wie urlencoder.io, um den Text korrekt zu kodieren.

1. Melden Sie sich bei Tulip an und fügen Sie den Snowflake Connector aus der Tulip Bibliothek hinzu (Web oder Embedded)
2. Klicken Sie auf Produktion & Test & Entwicklung im Bereich Umgebungseinstellungen auf der linken Seite der Tulip UI
3. Aktualisieren Sie den Host auf die URL Ihrer Snowflake-Instanz:

Gehen Sie zu Ihrer Snowflake-Instanz und kopieren Sie Ihre Konto-URL, die sich in der unteren rechten Ecke Ihres Bildschirms befindet (dort befindet sich eine Schaltfläche, die Sie anklicken können, um sie zu kopieren).

1. Jetzt können Sie von Tulip aus eine sichere Verbindung zu Snowflake herstellen. Einige Beispielfunktionen sind im Inhalt der Bibliothek enthalten, darunter die Autorisierung und das Abrufen eines OAUTH-Tokens.Beispiel: Verwenden Sie den in Schritt 5 generierten Auth Code als Wert für refresh_token in der Vorlage "Get OAuth2 Token".

Verwendung

Sobald das Access Token generiert wurde, kann es als Bearer Token in einer SQL-Anfrage an Snowflake verwendet werden.

Stellen Sie sicher, dass die Abfragen auf POST-Anfrage eingestellt sind und dass /api/v2/statements am Ende der Host-URL für Datenbankabfragen hinzugefügt wird.

Zusätzliche Referenzen

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