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 (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu verarbeiten) 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 Design-Komponentenpalette (siehe Design-Komponentenpalette).
• 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 Design-Komponentenpalette (siehe Design-Komponentenpalette).
• 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 verwendet, um den Snowflake-Endpunkt zu identifizieren, der sich auf eine bestimmte Verbindung und ihre Aktivitäten bezieht.

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

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

    • Host-Name: Geben Sie den Snowflake-Host-Namen 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 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 Zugriffs- 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 unter 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 Ihre Zustimmung, dass Jitterbit auf die Snowflake-Anwendung zugreifen darf.
  

  • 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.

      Die TYPE-Eigenschaft des Snowflake-Benutzers muss auf LEGACY_SERVICE gesetzt werden und zukünftige Einstellung der Authentifizierung mit einem Faktor

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

      Empfohlene Benutzeraktion

      Eine 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 zu verwenden (siehe Benutzertypen). Ohne Benutzeraktion werden bestehende Integrationen mit Snowflake-Authentifizierung mit einem Faktor voraussichtlich ab April 2025 fehlschlagen.

      2. Bis November 2025 müssen Sie den Authentifizierungstyp 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.

• 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 Speichersymbol in der rechten Spalte.

Um eine einzelne Zeile zu bearbeiten oder zu löschen, fahren Sie mit der Maus ü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 Verwendung der Organisationsrichtlinie Automatische Connector-Aktualisierung 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

Nachdem eine Snowflake-Verbindung erstellt wurde, 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.