Workiva Support Center

Mit dem Snowflake® JDBC Connector können Sie Befehle in einer Kette verwenden, um SQL-Operationen (Structured Query Language) in Snowflake-Datenbanken durchzuführen. Mit diesem Konnektor können Sie beispielsweise Folgendes tun:

• Ausführen von SQL-Befehlen, einschließlich einer CREATE oder UPDATE Anweisung oder SELECT Abfrage
• Abrufen von Details über eine Tabelle in Snowflake
• Einfügen von Datensätzen in eine Snowflake-Datenbank

Hinweis: Dieser Konnektor wird von Workiva hergestellt und verbindet sich mit einem System eines Drittanbieters. Unser Support-Team kann Ihnen zwar bei der Konfiguration dieses Konnektors innerhalb Ihres Arbeitsbereichs behilflich sein, aber wir sind nicht in der Lage, Fehler zu beheben oder anderweitig bei Problemen zu helfen, die ihren Ursprung außerhalb der Workiva-Plattform haben.

Voraussetzungen

Um die Verbindung zu Snowflake zu aktivieren, muss ein Org-Sicherheitsadministrator sie zunächst unter Konfiguration aktivieren.

Der Konnektor selbst verwendet Java-Datenbankkonnektivität (JDBC), die entweder mit einfacher oder mit Schlüsselpaar-Authentifizierung gesichert ist. Zur Einrichtung des Konnektors benötigen Sie Folgendes:

• Ein bestimmter Integrationsbenutzer, der in Snowflake für den Konnektor erstellt wurde, sowie der Benutzername und das Kennwort des Integrationsbenutzers.
  

  Hinweis: Die Basisauthentifizierung wird ab November 2025 nicht mehr unterstützt. Wir empfehlen stattdessen die Verwendung der Schlüsselpaar-Authentifizierung. Erfahren Sie mehr.

• (Optional) Eine private Schlüsseldatei zur Aktivierung der Schlüsselpaar-Authentifizierung.
• Die URL der JDBC-Verbindung, z. B. jdbc:snowflake://[accountName].snowflakecomputing.com/?[options]
• Um eine Verbindung zu einer lokalen Snowflake-Datenbank herzustellen, ein GroundRunner für die Verbindung. (Um eine Verbindung zu einer Cloud-Instanz von Snowflake herzustellen, verwenden Sie den Standard-CloudRunner).

Einrichten des Snowflake-Konnektors

1. Klicken Sie unter Chain-Generator auf Verbindungen  compare_arrows und dann auf Erstellen oben rechts.
2. Unter Connector Connection wählen Sie Snowflake JDBC und den Runner, der mit der Verbindung verwendet werden soll.
   
3. Geben Sie unter Basisinformationen einen eindeutigen Namen und eine Beschreibung ein, um die Verbindung zu identifizieren.
4. (Optional) Laden Sie unter Ressourcen Ihre private Schlüsseldatei hoch. Im nächsten Schritt müssen Sie genau diesen Dateinamen in das Feld "Private Schlüsseldatei" eingeben.
5. Geben Sie unter Eigenschaften die Details des Connectors ein:
   
   

   Eigenschaft	Details
   Benutzername	Geben Sie den Benutzernamen ein, mit dem Sie sich authentifizieren möchten. Wenn unten eine private Schlüsseldatei angegeben ist, wird sie automatisch mit diesem Benutzernamen authentifiziert.
   Kennwort	Geben Sie das Passwort für die Eigenschaft Benutzername ein. Wenn unten eine private Schlüsseldatei angegeben ist, geben Sie hier das Passwort ein. Hinweis: Bei unverschlüsselten Schlüsseldateien leer lassen.
   Verbindungs-URL	Geben Sie die URL für die JDBC-Verbindung ein, z. B. jdbc:snowflake://[accountName].snowflakecomputing.com/. Um optionale Eigenschaften für die Verbindung hinzuzufügen, fügen Sie sie als Abfragezeichenfolge an. Um beispielsweise eine Anmeldung automatisch zu unterbrechen, wenn die Verbindung nicht innerhalb einer Minute hergestellt werden kann, fügen Sie ?loginTimeout=60 hinzu.
   Datei mit privatem Schlüssel	(Optional) Wird für die Authentifizierung mit dem öffentlichen Schlüssel des Servers verwendet. Der Benutzername und das Passwort müssen in die obigen Felder eingegeben werden. Erfahren Sie mehr: Schlüsselpaar-Authentifizierung und Schlüsselpaar-Rotation Hinweis: Der Dateiname muss mit einer als Verbindungsressource hochgeladenen Datei übereinstimmen.

   Hinweis: Alle sensiblen Anmeldedaten werden automatisch verschlüsselt und mit Advanced Encryption Standard (AES)-256-Verschlüsselung gespeichert. Vermeiden Sie es aus Sicherheitsgründen, Benutzeranmeldeinformationen als optionale Eigenschaften in die Eigenschaft Connection URL aufzunehmen.

6. Wählen Sie die Umgebungen aus, die für die Verbindung verwendet werden sollen, und klicken Sie auf Speichern.
7. Um die Verbindung zu testen, erstellen Sie eine Kette und führen Sie diese mit dem Befehl Tabellendefinition beziehen des Konnektors aus und prüfen Sie, ob eine gültige Ausgabe zurückgegeben wird.

Fehlersuche

• Wenn die Verbindung zu Snowflake fehlschlägt:
  • Überprüfen Sie die Authentifizierungsdaten.
  • Wenn Sie die Schlüsselpaar-Authentifizierung verwenden, stellen Sie sicher, dass der Dateiname, der über Resources hochgeladen wurde, mit dem Dateinamen übereinstimmt, der in das Feld Private Key File eingegeben wurde.
  • Überprüfen Sie die URL für die JDBC-Verbindung, einschließlich des Kontonamens.
  • Wenn Sie eine Verbindung zu einer lokalen Datenbank herstellen, überprüfen Sie den GroundRunner, der für den Connector ausgewählt wurde.
• Wenn die Verbindung einen Befehl nicht ausführen kann, überprüfen Sie, ob die Eingaben, wie die SQL-Syntax oder die Tabelle, gültig sind.
• Wenn ein Snowflake-Befehl mit der Fehlermeldung Eingehende Anfrage mit IP/Token XX.XX.XX.XX darf nicht auf Snowflake zugreifen fehlschlägt, finden Sie in diesem Snowflake-Artikel Hinweise zum Hinzufügen der erforderlichen IP-Adresse (entweder CloudRunner oder GroundRunner) zur Liste der zulässigen IPs in Ihrer Snowflake-Instanz.