Snowflake-Verbindung

Einführung

Eine Snowflake-Verbindung, die mit dem Snowflake-Connector erstellt wurde, ermöglicht den Zugriff auf Snowflake. Sobald eine Verbindung konfiguriert ist, können Instanzen von Snowflake-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind und entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Erstellen oder Bearbeiten einer Snowflake-Verbindung

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

• Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
• Der Seite Globale Endpunkte (siehe Erstellen eines globalen Endpunkts in Globalen Endpunkten).

Eine vorhandene Snowflake-Verbindung kann von diesen Standorten bearbeitet werden:

• Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
• Der Registerkarte Komponenten im Projektbereich (siehe Aktionsmenü für Komponenten in Projektbereich Komponentenregister).
• Der Seite Globale Endpunkte (siehe Bearbeiten eines globalen Endpunkts in Globalen Endpunkten).

Konfigurieren einer Snowflake-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Snowflake-Verbindung wird im Folgenden 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 sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht.

• Authentifizierung: Wählen Sie den Authentifizierungstyp, einen von Schlüssel-Paar, OAuth oder Passwort (veraltet):

  • Schlüssel-Paar: Wählen Sie diese Option, um ein Schlüssel-Paar zur Authentifizierung zu verwenden:

    • Host-Name: Geben Sie den Snowflake-Hostnamen ein. Dies ist der Snowflake-Kontoname (wie example-account123) und der Snowflake-Domainname von snowflakecomputing.com, die zusammengefügt werden, wie 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. Für weitere Informationen siehe die Snowflake-Dokumentation zu Schlüssel-Paar-Authentifizierung und Schlüssel-Paar-Rotation.

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

  • OAuth: Wählen Sie diese Option, um 3-beinige OAuth 2.0 zur Authentifizierung zu verwenden:

    • Host-Name: Geben Sie den Snowflake-Hostnamen ein. Dies ist der Snowflake-Kontoname (wie example-account123) und der Snowflake-Domainname von snowflakecomputing.com, die zusammengefügt werden, wie example-account123.snowflakecomputing.com.

    • Benutzername: Geben Sie den Snowflake-Benutzernamen ein.

    • OAuth-Anwendung: Wählen Sie eine Snowflake-Connector-Anwendung aus, die in der Management-Konsole auf der Seite App-Registrierungen konfiguriert ist. Weitere Informationen zur Konfiguration einer Snowflake-Connector-Anwendung auf der Seite App-Registrierungen finden Sie in den Snowflake 3-beinigen OAuth-Voraussetzungen.

    • Mit Snowflake anmelden: Klicken Sie, um sich über Snowflake in einem separaten Browser-Tab zu authentifizieren und Jitterbit die Zustimmung zu erteilen, auf die Snowflake-Anwendung zuzugreifen.

  • Passwort (Veraltet): Wählen Sie diese Option, um ein Passwort zur Authentifizierung zu verwenden:

    • Hostname: Geben Sie den Snowflake-Hostnamen ein. Dies ist der Snowflake-Kontoname (wie example-account123) und der Snowflake-Domainname von snowflakecomputing.com, die zusammengefügt werden, wie 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 Abschaffung der Authentifizierung mit nur einem Faktor

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

      Empfohlene Benutzeraktion

      Benutzeraktionen sind in zwei Phasen erforderlich:

      1. Bis 31. März 2025 muss die TYPE-Eigenschaft des Benutzerkontos, das Sie zur Verbindung mit Snowflake verwenden, auf LEGACY_SERVICE gesetzt werden, um die passwortbasierte Authentifizierung weiterhin nutzen zu können (siehe Benutzertypen). Ohne Benutzeraktion wird erwartet, dass bestehende Integrationen, die die Authentifizierung mit nur einem Faktor für Snowflake-Passwörter verwenden, im April 2025 zu scheitern beginnen.

      2. Bis November 2025 müssen Sie den Typ der Authentifizierung, der zur Verbindung mit Snowflake verwendet wird, auf OAuth 2.0 oder Schlüssel-Paar-Authentifizierung aktualisieren. Zu diesem Zeitpunkt wird die passwortbasierte Authentifizierung nicht mehr unterstützt.

• Konto: Geben Sie den Namen des Snowflake-Kontos ein.

• Datenbankname: Geben Sie den Namen der Snowflake-Datenbank ein.

• Schemasname: Geben Sie den Namen des Snowflake-Schemas 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 Namen des Snowflake-Warehouses ein.

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

    Wenn nicht ausgewählt (Standard), und ein einfaches Anführungszeichen (') im Payload vorhanden ist, wird zur Laufzeit ein Syntaxfehler zurückgegeben.

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

    Um die Zeile zu speichern, klicken Sie auf das Senden-Symbol 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 Bearbeiten-Symbol oder das Löschen-Symbol .

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

• Anführungszeichen für Snowflake-Identifikatoren verwenden: Wählen Sie diese Option, um Anführungszeichen um Snowflake-Identifikatoren wie Tabellennamen zu verwenden, um deren Groß- und Kleinschreibung zu bewahren, anstatt deren Großschreibung in Großbuchstaben zu konvertieren, was zu einem Fehler führen kann. Standardmäßig ist dies ausgewählt.

• Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Deaktivieren Sie die automatische Connector-Aktualisierung Organisationsrichtlinie.

• Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

• Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

• Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration 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 Nachricht fragt Sie, ob Sie die Verbindung wirklich löschen möchten.

Nächste Schritte

Nachdem eine Snowflake-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfsgrafik, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

• Get: Ruft eine CSV-Datei mit Tabellen- oder Ansichts-Daten von Snowflake ab und ist als Quelle in einem Vorgang vorgesehen.

• Query: Ruft eine CSV-Datei mit Tabellen- oder Ansichts-Daten von Snowflake ab und ist als Quelle in einem Vorgang vorgesehen.

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

• Stored Procedure aufrufen: Ruft eine in Snowflake erstellte gespeicherte Prozedur auf und ist als Ziel in einer Operation vorgesehen.

• Aktualisieren: Aktualisiert Tabellendaten in Snowflake und ist als Ziel in einer Operation vorgesehen.

• Löschen: Löscht Tabellendaten und Ansichtsdatensätze aus Snowflake und ist als Ziel in einer Operation vorgesehen.

• Einfügen: Fügt Tabellendaten (entweder als CSV-Datei oder direkt auf die Spalten einer Tabelle abgebildet) in Snowflake ein und ist als Ziel in einer Operation vorgesehen.