Snowflake-Verbindung in Jitterbit Studio

Einführung

Eine Snowflake-Verbindung, die mit dem Snowflake-Connector erstellt wird, stellt den Zugriff auf Snowflake her. Nach der Konfiguration einer Verbindung können Sie Instanzen von Snowflake-Aktivitäten erstellen, die dieser Verbindung zugeordnet sind und entweder als Quellen (zur Bereitstellung von Daten in einem Vorgang) oder als Ziele (zur Verarbeitung von Daten in einem Vorgang) verwendet werden.

Snowflake-Verbindung erstellen oder bearbeiten

Eine neue Snowflake-Verbindung wird mit dem Snowflake-Connector von einem dieser Orte aus erstellt:

• Die Registerkarte Projektendpunkte und Connectors der Designkomponentenpalette (siehe Designkomponentenpalette).
• Die Seite Globale Endpunkte (siehe Globalen Endpunkt erstellen in Globale Endpunkte).

Eine vorhandene Snowflake-Verbindung kann von diesen Orten aus bearbeitet werden:

• Die Registerkarte Projektendpunkte und Connectors der Designkomponentenpalette (siehe Designkomponentenpalette).
• Die Registerkarte Komponenten des Projektbereichs (siehe Menü „Komponentenaktionen" in Registerkarte „Komponenten" des Projektbereichs).
• Die Seite Globale Endpunkte (siehe Globalen Endpunkt bearbeiten in Globale Endpunkte).

Snowflake-Verbindung konfigurieren

Im Folgenden wird jedes Element der Benutzeroberfläche des Snowflake-Verbindungskonfigurationsbildschirms beschrieben.

• Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Snowflake-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch zur Identifizierung des Snowflake-Endpunkts verwendet, der sich auf eine bestimmte Verbindung und ihre Aktivitäten bezieht.

• Authentifizierung: Wählen Sie den Authentifizierungstyp aus, einer der folgenden: Schlüsselpaar, OAuth oder Passwort (veraltet):

  • Schlüsselpaar: Wählen Sie diese Option, um ein Schlüsselpaar für die Authentifizierung zu verwenden:

    • Hostname: Geben Sie den Snowflake-Hostnamen ein. Dies ist der Snowflake-Kontoname (z. B. example-account123) und der Snowflake-Domänenname snowflakecomputing.com, die zusammengefügt sind, z. B. example-account123.snowflakecomputing.com.

    • Benutzername: Geben Sie den Snowflake-Benutzernamen ein.

    • Spezifikation des privaten Schlüssels: Wählen Sie entweder Unverschlüsselt oder Verschlüsselter Schlüssel, um den Typ des verwendeten privaten Schlüssels zu identifizieren.

    • Privater Schlüssel: Geben Sie den privaten Schlüssel ein. Weitere Informationen finden Sie in der Snowflake-Dokumentation zu Schlüsselpaar-Authentifizierung und Schlüsselpaar-Rotation.

    • Passphrase: Wenn Verschlüsselter Schlüssel für die Spezifikation des privaten Schlüssels ausgewählt ist, geben Sie die Passphrase ein, die dem verschlüsselten privaten Schlüssel zugeordnet ist.

  • OAuth: Wählen Sie diese Option, um OAuth 2.0 mit drei Beinen für die Authentifizierung zu verwenden. Wichtige Hinweise zum Verhalten von Zugriffstoken und Aktualisierungstoken finden Sie unter Wichtige Hinweise.

• Hostname: Geben Sie den Snowflake-Hostnamen ein. Dies ist der Snowflake-Kontoname (z. B. example-account123) und der Snowflake-Domänenname snowflakecomputing.com, die zusammengefügt werden, z. B. example-account123.snowflakecomputing.com.

  -   **Benutzername:** Geben Sie den Snowflake-Benutzernamen ein.
  
  -   **OAuth-Anwendung:** Wählen Sie eine Snowflake-Connector-Anwendung aus, die auf der Seite [App-Registrierungen](/de/management-console/customizations/customizations-app-registrations/) der Management Console konfiguriert ist. Weitere Informationen zum Konfigurieren einer Snowflake-Connector-Anwendung auf der Seite **App-Registrierungen** finden Sie in den Snowflake-[Voraussetzungen für 3-legged OAuth](/de/integration-studio/design/connectors/snowflake/prerequisites/).
  
  -   **Mit Snowflake anmelden:** Klicken Sie, um sich über Snowflake in einem separaten Browser-Tab zu authentifizieren und geben Sie Jitterbit die Berechtigung, auf die Snowflake-Anwendung zuzugreifen.
  

  • Passwort (Veraltet): Wählen Sie diese Option, um ein Passwort für die Authentifizierung zu verwenden:

    • Hostname: Geben Sie den Snowflake-Hostnamen ein. Dies ist der Snowflake-Kontoname (z. B. example-account123) und der Snowflake-Domänenname snowflakecomputing.com, die zusammengefügt werden, z. B. example-account123.snowflakecomputing.com.

    • Benutzername und Passwort: Geben Sie den Snowflake-Benutzernamen und das Passwort ein.

      Snowflake stellt die Authentifizierung mit Einzel-Faktor-Passwort ein

      Snowflake stellt die Authentifizierung mit Einzel-Faktor-Passwort ein für alle Benutzer, einschließlich der für diesen Authentifizierungstyp Passwort (Veraltet) erforderlichen Service-Konten vom Typ LEGACY_SERVICE. Die Einstellung erfolgt in Phasen:

      • Zwischen Mai und Juli 2026 konnten keine neuen LEGACY_SERVICE-Konten erstellt werden; bestehende waren noch nicht betroffen.
      • Zwischen August und Oktober 2026 migriert Snowflake alle verbleibenden LEGACY_SERVICE-Konten auf TYPE=SERVICE auf rollierender, kontobasierter Basis und benachrichtigt jedes Konto über sein spezifisches Durchsetzungsdatum innerhalb dieses Zeitfensters. Nach der Migration kann sich ein TYPE=SERVICE-Konto nicht mehr mit einem Passwort authentifizieren.

      Wenn Ihr Snowflake-Konto betroffen ist, schlagen Verbindungen mit diesem Authentifizierungstyp fehl. Aktualisieren Sie die Verbindung, um stattdessen die Authentifizierung OAuth oder Key-Pair zu verwenden, und konfigurieren Sie das Snowflake-Benutzerkonto entsprechend.

• Konto: Geben Sie den Snowflake-Kontonamen ein.

• Datenbankname: Geben Sie den Snowflake-Datenbanknamen ein.

• Schemaname: Geben Sie den Snowflake-Schemanamen ein.

• Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

  • Rolle: Geben Sie die Snowflake-Rolle ein. Die verfügbaren Rollen sind GENERAL, PUBLIC und READONLY.

  • Warehouse-Name: Geben Sie den Snowflake-Warehouse-Namen ein.

  • Sonderzeichen escapen: Wenn diese Option aktiviert ist, wird ein einfaches Anführungszeichen (') escaped (\'), wenn es in einer Insert- oder Invoke Stored Procedure-Aktivität in der Request-Payload vorhanden ist.

    Wenn diese Option deaktiviert ist (Standard) und ein einfaches Anführungszeichen (') in einer Request-Payload vorhanden ist, wird zur Laufzeit ein Syntaxfehler zurückgegeben.

  • Benutzerdefinierte Verbindungseigenschaften: Klicken Sie auf das Plussymbol , um der zugehörigen Tabelle eine Zeile hinzuzufügen, und geben Sie einen Schlüssel und einen Wert für eine benutzerdefinierte Eigenschaft ein, die einem Snowflake-JDBC-Verbindungsparameter entspricht. Standardmäßig ist eine Zeile für JDBC_QUERY_RESULT_FORMAT mit dem Wert JSON definiert.

    Um die Zeile zu speichern, klicken Sie auf das Bestätigungssymbol in der rechten Spalte.

    Um eine einzelne Zeile zu bearbeiten oder zu löschen, bewegen Sie den Mauszeiger über die rechte Spalte und verwenden Sie das Bearbeitungssymbol oder das Löschsymbol .

Um alle Zeilen zu löschen, klicken Sie auf Alle löschen.

• Anführungszeichen für Snowflake-Identifizierer verwenden: Wählen Sie diese Option, um Snowflake-Identifizierer wie Tabellen- und Spaltennamen in dem SQL, das der Connector generiert, in Anführungszeichen zu setzen. Das Setzen von Anführungszeichen behält die Groß- und Kleinschreibung eines Identifizierers bei, anstatt ihn in Großbuchstaben umzuwandeln, was zu einem Fehler führen kann, und ermöglicht Identifizierer, die Sonderzeichen wie einen Bindestrich enthalten, die Snowflake als ungültige Syntax ablehnt, wenn sie nicht in Anführungszeichen gesetzt sind. Standardmäßig ist diese Option aktiviert.

• Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, lädt der Agent oder die Agents in der Agentgruppe, die der aktuellen Umgebung zugeordnet ist, die neueste Version des Connectors herunter. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Organisationsrichtlinie Automatisches Connector-Update deaktivieren .

• Speichern: Klicken Sie, um die Verbindungskonfiguration zu speichern und zu schließen.

• Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder vorhandenen Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

• Löschen: Nachdem Sie eine vorhandene Verbindungskonfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Verbindung löschen möchten.

Nächste Schritte

Nach dem Erstellen einer Snowflake-Verbindung platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu verarbeiten) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

• Get: Ruft eine CSV-Datei mit Tabellen- oder Ansichtsdaten aus Snowflake ab und ist für die Verwendung als Quelle in einem Vorgang vorgesehen.

• Query: Ruft eine CSV-Datei mit Tabellen- oder Ansichtsdaten aus Snowflake ab und ist für die Verwendung als Quelle in einem Vorgang vorgesehen.

• Query v2: Ruft eine CSV-Datei mit Tabellen- oder Ansichtsdaten über mehrere Snowflake-Schemas ab und ist für die Verwendung als Quelle in einem Vorgang vorgesehen.

• Merge: Fügt eine CSV-Datei mit Tabellendaten in Snowflake ein oder aktualisiert sie und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

• Invoke Stored Procedure: Ruft eine in Snowflake erstellte gespeicherte Prozedur auf und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

• Update: Aktualisiert Tabellendaten in Snowflake und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

• Delete: Löscht Tabellendaten und Ansichtsdaten aus Snowflake und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

• Insert: Fügt Tabellendaten (entweder als CSV-Datei oder direkt den Spalten einer Tabelle zugeordnet) in Snowflake ein und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.