Workiva-ondersteuningscentrum

Met de Microsoft® SQL Server®-connector kunt u commando's in een keten gebruiken om gestructureerde querytaal (SQL)-bewerkingen uit te voeren in Microsoft SQL Server-databases, met inbegrip van oplossingen zoals Microsoft Dynamics® Great Plains® (GP) of Yardi® Private Cloud. Met deze connector kunt u bijvoorbeeld:

• SQL-opdrachten uitvoeren, inclusief een CREATE of UPDATE verklaring of SELECT query
• Details over een tabel in SQL Server ophalen
• Records invoegen in een SQL Server-database

Opmerking: Deze connector is gebouwd door Workiva en maakt verbinding met een systeem van derden. Hoewel ons Support team kan helpen bij het configureren van deze connector binnen uw workspace, kunnen wij geen problemen oplossen of op een andere manier helpen met problemen die hun oorsprong vinden buiten het Workiva platform.

Vereisten

Om de verbinding met de SQL Server-database mogelijk te maken, maakt de connector gebruik van Java-databaseconnectiviteit (JDBC), beveiligd met een basisgebruikersnaam en wachtwoordverificatie. Om de connector in te stellen, hebt u het volgende nodig:

• Een aangewezen integratiegebruiker die in SQL Server is aangemaakt voor de connector
• De gebruikersnaam en het wachtwoord van de integratiegebruiker
• De URL van de JDBC-verbinding, zoals jdbc:sqlserver://localhost:1433;[opties]
• Om verbinding te maken met een lokale SQL Server-database, een GroundRunner voor de verbinding

Ondersteunde versies

De Microsoft® SQL Server®-connector is compatibel met de volgende databaseversies:

• Azure SQL-database
• Azure Synapse Analytics
• Azure SQL beheerde instantie
• SQL Server 2022
• SQL Server 2019
• SQL Server 2017
• SQL Server 2016
• SQL Server 2014

De Microsoft SQL Server-connector instellen

Opmerking: Om de connector beschikbaar te maken voor gebruik in de ketens van uw organisatie, moet een beveiligingsbeheerder van de org deze eerst inschakelen vanuit Configuratie.

1. Ga naar Chain Builder, klik op Connectionscompare_arrows, en vervolgens op Create rechtsboven.
2. Selecteer onder Connector Connection, Microsoft SQL Server en de runner die u met de verbinding wilt gebruiken.
   
3. Voer onder Basisinfo een unieke naam en beschrijving in om de verbinding te helpen identificeren.
4. Voer onder Eigenschappen de gegevens van de connector in:
   
   

   Eigendom	Details
   Gebruikersnaam	Voer de gebruikersnaam van de SQL Server-integratiegebruiker van de connector in.
   Wachtwoord	Voer het wachtwoord in voor de eigenschap Username.
   URL verbinding	Voer de URL voor de JDBC-verbinding in, zoals jdbc:sqlserver://<server>:<port>. Om optionele eigenschappen voor de verbinding op te nemen, voegt u ze toe na een puntkomma, zoals jdbc:sqlserver://localhost:1433;<options>. Om bijvoorbeeld verbinding te maken met een database met Active Directory® geïntegreerde beveiliging: ;databasename=<database>;integratedSecurity=True;authenticationScheme=NTLM Opmerking: Standaard is de poort 1433; dit kan echter voor uw omgeving anders zijn.

   Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met Advanced Encryption Standard (AES)-256 codering. Vermijd om veiligheidsredenen het opnemen van gebruikersreferenties als optionele eigenschappen binnen de eigenschap Connection URL.

5. Selecteer de omgevingen die u met de verbinding wilt gebruiken en klik op Opslaan.
6. Om de verbinding te testen, maakt een ketting aan en voert deze uit met de opdracht Get Table Definition van de connector en controleert of deze een geldige uitvoer oplevert.

Probleemoplossing

Als de verbinding met SQL Server mislukt:

• Controleer de verificatiegegevens van de integratiegebruiker.
• Controleer de URL voor de JDBC-verbinding, inclusief de server en poort.
• Als u verbinding maakt met een on-premises database, controleer dan de GroundRunner die voor de connector is geselecteerd.

Als de verbinding een opdracht niet kan uitvoeren, controleer dan of de invoer, zoals de SQL-syntaxis of tabel, geldig is.