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 mit Snowflake über die Verbindung.

Man greift auf den Snowflake-Connector über die Registerkarte Projektendpunkte und Connectors der Designkomponentenpalette zu (siehe Designkomponentenpalette).

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer Snowflake-Verbindung verwendet. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann zum Erstellen von Aktivitätsinstanzen verwendet, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) dienen 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.

Hinweis

Dieser Connector ist ein auf dem Connector SDK basierender Connector, auf den sich Jitterbit bei der Kommunikation von Änderungen an mit dem Connector SDK erstellten Connectors beziehen kann.

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

Voraussetzungen

Der Snowflake-Connector erfordert die Verwendung einer Agent-Version 10.1 oder später. Diese Agent-Versionen laden automatisch die neueste Version des Connectors herunter, wenn erforderlich.

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. Ab diesem Zeitpunkt wird die passwortbasierte Authentifizierung nicht mehr unterstützt.

Fehlerbehebung

Falls Probleme mit dem Snowflake-Connector auftreten, werden diese 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 werden bekanntermaßen inaktiv, 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-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Bei Verwendung von privaten Agenten 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: