Zum Inhalt springen

Snowflake-Connector in Jitterbit Studio

Zusammenfassung

Der Snowflake-Connector stellt Zugriff auf Snowflake her.

Der Snowflake-Connector bietet eine Schnittstelle zum Erstellen einer Snowflake-Verbindung, die Grundlage für die Generierung von Snowflake-Aktivitätsinstanzen. Diese Aktivitäten interagieren nach der Konfiguration über die Verbindung mit Snowflake.

Der Snowflake-Connector wird über die Registerkarte Projektendpunkte und Connectors der Palette der Designkomponenten aufgerufen (siehe Palette der Designkomponenten).

Connector-Übersicht

Dieser Connector wird verwendet, um zunächst eine Snowflake-Verbindung zu konfigurieren. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) verwendet werden sollen.

Zusammen werden eine bestimmte Snowflake-Verbindung und ihre Aktivitäten als Snowflake-Endpunkt bezeichnet:

Snowflake-Aktivitätstypen

  • Get: Ruft eine CSV-Datei mit Tabellen- oder Ansichtsdaten aus Snowflake ab und soll als Quelle in einem Vorgang verwendet werden.

  • Query: Ruft eine CSV-Datei mit Tabellen- oder Ansichtsdaten aus Snowflake ab und soll als Quelle in einem Vorgang verwendet werden.

  • Query v2: Ruft eine CSV-Datei mit Tabellen- oder Ansichtsdaten über mehrere Snowflake-Schemas ab und soll als Quelle in einem Vorgang verwendet werden.

  • Merge: Fügt eine CSV-Datei mit Tabellendaten in Snowflake ein oder aktualisiert sie und soll als Ziel in einem Vorgang verwendet werden.

  • Invoke Stored Procedure: Ruft eine in Snowflake erstellte gespeicherte Prozedur auf und soll als Ziel in einem Vorgang verwendet werden.

  • Update: Aktualisiert Tabellendaten in Snowflake und soll als Ziel in einem Vorgang verwendet werden.

  • Delete: Löscht Tabellen- und Ansichtsdaten aus Snowflake und soll als Ziel in einem Vorgang verwendet werden.

  • Insert: Fügt Tabellendaten (entweder als CSV-Datei oder direkt den Spalten einer Tabelle zugeordnet) in Snowflake ein und soll als Ziel in einem Vorgang verwendet werden.

Mit diesem Connector erstellte Endpunkte sind in der Endpunkt-Nutzungsberichterstellung enthalten und werden auf Ihre Lizenz angerechnet.

Voraussetzungen

Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Bei privaten Agenten können Sie diese Updates mit der Organisationsrichtlinie Disable Auto Connector Update aussetzen.

Um die 3-beinige OAuth 2.0 (3LO)-Authentifizierung mit dem Snowflake-Connector zu verwenden, sind zusätzliche Voraussetzungen erforderlich. Agent-Version 10.83 / 11.21 oder später ist erforderlich, um 3LO zu verwenden.

Snowflake-Benutzereigenschaft TYPE muss auf LEGACY_SERVICE gesetzt werden und zukünftige Einstellung der Single-Factor-Authentifizierung

Snowflake hat angekündigt, dass die Single-Factor-Authentifizierung eingestellt wird, was Integrationen betrifft, die sich mit Snowflake über ein Passwort verbinden. Alle Benutzer des Snowflake-Connectors, die den Authentifizierungstyp Password (Deprecated) verwenden, sind betroffen.

Empfohlene Benutzeraktion

Benutzeraktion ist in zwei Phasen erforderlich:

  1. Bis zum 31. März 2025 muss die TYPE-Eigenschaft des Benutzerkontos, das Sie zum Verbinden mit Snowflake verwenden, auf LEGACY_SERVICE gesetzt werden, um die passwortbasierte Authentifizierung weiterhin nutzen zu können (siehe Types of users). Ohne Benutzeraktion werden vorhandene Integrationen mit Snowflake-Authentifizierung mit einfachem Passwort voraussichtlich ab April 2025 fehlschlagen.

  2. Bis November 2025 müssen Sie die Authentifizierungsmethode für die Verbindung mit Snowflake auf OAuth 2.0 oder Schlüsselpaar-Authentifizierung aktualisieren. Zu diesem Zeitpunkt wird die passwortbasierte Authentifizierung nicht mehr unterstützt.

Fehlerbehebung

Falls Probleme mit dem Snowflake-Connector auftreten, werden folgende Schritte zur Fehlerbehebung empfohlen:

  1. Klicken Sie auf die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agent heruntergeladen wird (sofern nicht die Organisationsrichtlinie Disable Auto Connector Update verwendet wird).

    Hinweis

    Snowflake Developer Instances gehen bekanntermaßen in den Ruhezustand, wenn Sie sich nicht kürzlich in der Snowflake-Benutzeroberfläche angemeldet oder die Instanz verwendet haben. Falls eine Tabelle nicht mit verfügbaren Objekten gefüllt wird, stellen Sie zunächst sicher, dass die Snowflake-Instanz aktiv ist, und stellen Sie dann sicher, dass Sie verbunden sind, indem Sie die Snowflake-Verbindung erneut öffnen und die Anmeldedaten erneut testen.

  2. Überprüfen Sie die Operationsprotokolle auf Informationen, die während der Ausführung der Operation geschrieben wurden.

  3. Aktivieren Sie das Debug-Logging für Operationen (für Cloud-Agents oder für private Agents), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Bei Verwendung von privaten Agents können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

  5. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Operation troubleshooting.

  6. Informationen zu Problemen und Lösungen, die speziell für den Snowflake-Connector gelten, finden Sie im Leitfaden Connector troubleshooting: