Workiva Support Center

Mit dem Microsoft® SQL Server®-Connector können Sie Befehle in einer Kette verwenden, um SQL-Operationen (Structured Query Language) in Microsoft SQL Server-Datenbanken durchzuführen, einschließlich Lösungen wie Microsoft Dynamics® Great Plains® (GP) oder Yardi® Private Cloud. 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 SQL Server
• Einfügen von Datensätzen in eine SQL Server-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.

Anforderungen

Um die Verbindung zur SQL Server-Datenbank zu ermöglichen, verwendet der Konnektor die Java Database Connectivity (JDBC), die durch eine einfache Authentifizierung mit Benutzernamen und Passwort gesichert ist. Zur Einrichtung des Konnektors benötigen Sie Folgendes:

• Ein bestimmter Integrationsbenutzer, der in SQL Server für den Konnektor erstellt wurde
• Der Benutzername und das Passwort des Integrationsbenutzers
• Die URL der JDBC-Verbindung, z. B. jdbc:sqlserver://localhost:1433;[options]
• Um eine Verbindung zu einer lokalen SQL Server-Datenbank herzustellen, ein GroundRunner für die Verbindung

Unterstützte Versionen

Der Microsoft® SQL Server®-Konnektor ist mit den folgenden Datenbankversionen kompatibel:

• Azure SQL-Datenbank
• Azure Synapse Analytics
• Azure SQL Verwaltete Instanz
• SQL-Server 2022
• SQL Server 2019
• SQL Server 2017
• SQL Server 2016
• SQL Server 2014

Einrichten des Microsoft SQL Server-Konnektors

Hinweis: Um den Konnektor für die Verwendung in den Ketten Ihrer Organisation verfügbar zu machen, muss ein Sicherheitsadministrator der Organisation ihn zunächst aktivieren unter Konfiguration.

1. Klicken Sie unter Chain-Generator auf Verbindungen  compare_arrows und dann auf Erstellen oben rechts.
2. Wählen Sie unter Connector Verbindung, Microsoft SQL Server und den für die Verbindung zu verwendenden Runner.
   
3. Geben Sie unter Basisinformationen einen eindeutigen Namen und eine Beschreibung ein, um die Verbindung zu identifizieren.
4. Geben Sie unter Eigenschaften die Details des Connectors ein:
   
   

   Eigenschaft	Details
   Benutzername	Geben Sie den Benutzernamen des SQL Server-Integrationsbenutzers des Connectors ein.
   Kennwort	Geben Sie das Passwort für die Eigenschaft Benutzername ein.
   Verbindungs-URL	Geben Sie die URL für die JDBC-Verbindung ein, z. B. jdbc:sqlserver://<server>:<port>. Um optionale Eigenschaften für die Verbindung hinzuzufügen, hängen Sie sie nach einem Semikolon an, z. B. jdbc:sqlserver://localhost:1433;<options>. Zum Beispiel, um eine Verbindung zu einer Datenbank mit integrierter Active Directory®-Sicherheit herzustellen: ;databasename=<database>;integratedSecurity=True;authenticationScheme=NTLM Hinweis: Standardmäßig ist der Port 1433; dies kann jedoch in Ihrer Umgebung anders sein.

   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.

5. Wählen Sie die Umgebungen aus, die für die Verbindung verwendet werden sollen, und klicken Sie auf Speichern.
6. 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 SQL Server fehlschlägt:

• Überprüfen Sie die Authentifizierungsdaten des Integrationsbenutzers.
• Überprüfen Sie die URL für die JDBC-Verbindung, einschließlich des Servers und des Ports.
• Wenn Sie eine Verbindung zu einer lokalen Datenbank herstellen, überprüfen Sie den für den Connector ausgewählten GroundRunner.

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.