SQL-module

Wat de module doet

Met de SQL-module kan BrynQ query's uitvoeren op een Microsoft SQL Server-database in je netwerk. BrynQ stuurt één of meer query's, de Agent voert ze uit via een ODBC-driver en stuurt het resultaat terug. Query's die beginnen met INSERT, UPDATE of DELETE worden in de database vastgelegd (commit).

Wanneer gebruik je hem

Een interface moet gegevens lezen uit een on-premise SQL Server-database, bijvoorbeeld een HR-, salaris- of ERP-database.
Een interface moet gegevens schrijven naar zo'n database.

Niet voor: clouddatabases die BrynQ rechtstreeks kan bereiken, of applicaties met een API (gebruik REST of SOAP voor interne API's).

Instellen

Tijdens de installatie: selecteer de module SQL. Het installatieprogramma toont dan de SQL-pagina's. Zie De BrynQ Agent installeren, stap 4.

Daarna: open het lokale beheerdashboard > SQL Connection Profile:

Veld	Wat je invult
ODBC Driver	De SQL Server ODBC-driver die op de server is geïnstalleerd, bijvoorbeeld ODBC Driver 18 for SQL Server.
Server	De naam van de SQL Server, bijvoorbeeld sql-host\instance.
Authentication	Windows-authenticatie, of SQL-gebruikersnaam en -wachtwoord.
Username / Password	Alleen bij SQL-authenticatie: de SQL Server-login.
Database Access	Alle databases, of alleen de databases onder Selected Databases.
Advanced ODBC Options	Extra verbindingsopties. Standaard: Encrypt=no;TrustServerCertificate=yes.

Klik op Validate and Save. De Agent test de verbinding voordat hij de instellingen opslaat. De instellingen, inclusief het wachtwoord, worden alleen op de server opgeslagen.

⚠ Welk account wordt gebruikt bij Windows-authenticatie? De Agent draait als Windows-service onder het account Local System. Bij Windows-authenticatie ziet SQL Server daarom het eigen account van de server: NT AUTHORITY\SYSTEM als SQL Server op dezelfde server draait, of het computeraccount (DOMAIN\SERVERNAME$) als SQL Server op een andere server draait. Geef dat account de databaserechten die BrynQ nodig heeft, of gebruik in plaats daarvan een SQL-login.

💡 Minimale rechten: de rechten van het SQL-account bepalen wat BrynQ in de database kan doen. Geef het alleen de rechten die de interface nodig heeft, bijvoorbeeld alleen-lezen als BrynQ alleen gegevens leest.

Problemen oplossen

Wat je ziet	Wat je doet
"SQL is enabled, but no local SQL connection is configured"	Vul het SQL Connection Profile in het beheerdashboard in en klik op Validate and Save.
Validate and Save mislukt	Controleer de servernaam en de driver. Controleer of het account (zie het kader hierboven) kan inloggen op SQL Server.
"Query failed. See the agent logs for details."	De query zelf is mislukt, bijvoorbeeld omdat een tabel niet bestaat of het account niet genoeg rechten heeft. Bekijk C:\ProgramData\BrynQ\Agent\logs\agent (de application- en requests-logs).
"The connection-string header is no longer supported"	De interface gebruikt een oude manier van verbinden. Neem contact op met BrynQ support om de interface bij te werken; de verbinding wordt nu op de server ingesteld.
Een module 404 Not Found	De SQL-module is niet ingeschakeld. Voer het installatieprogramma opnieuw uit en selecteer SQL.

Meer: Problemen met de BrynQ Agent oplossen.