SQL-module

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 een 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 definitief in de database opgeslagen (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 die een API aanbieden (gebruik REST of SOAP voor interne API's).

Instellen

Tijdens de installatie: vink op de pagina Modules de optie SQL Server aan. Het installatieprogramma toont dan twee pagina's (zie De BrynQ Agent installeren):

  • SQL Server-verbinding: kies de server en de aanmeldmethode, Windows-authenticatie of SQL Server-authenticatie (alleen deze vraagt om een gebruikersnaam en wachtwoord). Geavanceerd... toont het ODBC-Stuurprogramma en de Extra verbindingsopties (standaard Encrypt=no;TrustServerCertificate=yes). Klik op Verbinding testen: je ziet Verbinding geslaagd of de reden waarom het mislukte. Bij een herinstallatie kies je Huidige instellingen behouden (aanbevolen) of Instellingen wijzigen.
  • Databases: Alleen de databases die ik selecteer (aanbevolen) (de standaard) of Alle databases op deze server. Een database die niet in de lijst staat, kun je toevoegen via Database staat niet in de lijst?.

Daarna: open het lokale beheerdashboard (http://127.0.0.1:7071/admin, op de server zelf) > SQL:

VeldWat je invult
ODBC-driverKies de SQL Server ODBC-driver die op de server is geïnstalleerd, bijvoorbeeld ODBC Driver 18 for SQL Server.
ServerKies de SQL Server uit de lijst, of vul de naam in, bijvoorbeeld sql-host\instance.
AuthenticatieWindows-authenticatie of SQL-gebruikersnaam / wachtwoord.
Gebruikersnaam / WachtwoordAlleen bij SQL-authenticatie: de SQL Server-login. Bij een opgeslagen wachtwoord staat Opgeslagen op deze server; klik op Wachtwoord vervangen om een nieuw wachtwoord in te voeren.
Databases die BrynQ gebruiktAlle databases, of alleen de databases onder Geselecteerde databases.
Geavanceerde ODBC-optiesExtra verbindingsopties. Standaard: Encrypt=no;TrustServerCertificate=yes.

Klik op Valideren en opslaan. De Agent test de verbinding voordat hij de instellingen opslaat. Verbinding testen controleert de opgeslagen instellingen opnieuw. De instellingen, inclusief het wachtwoord, worden alleen op de server opgeslagen. Wachtwoorden met ;, { of } werken.

💡 Databases die BrynQ gebruikt beperkt de toegang niet. Het legt alleen vast welke databases de BrynQ-interfaces gebruiken. Wil je beperken wat BrynQ kan lezen of wijzigen, geef de SQL-login dan alleen rechten op die databases.
⚠ 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 zietWat je doet
"SQL is enabled, but no local SQL connection is configured"Vul de pagina SQL in het beheerdashboard in en klik op Valideren en opslaan.
Valideren en opslaan of Verbinding testen misluktControleer de servernaam en de driver. Controleer of het account (zie het kader hierboven) zich kan aanmelden bij SQL Server.
"SQL Server heeft deze aanmelding geweigerd" / "SQL Server heeft de Windows-aanmelding geweigerd"Met een SQL-login: controleer de gebruikersnaam en het wachtwoord. Met Windows-authenticatie: geef het computeraccount (zie het kader hierboven) toegang tot SQL Server. Of schakel over naar de andere aanmeldmethode.
"Query failed. See the agent logs for details."De query zelf is mislukt, bijvoorbeeld omdat een tabel niet bestaat of het account onvoldoende rechten heeft. Bekijk C:\ProgramData\BrynQ\Agent\logs\agent (de logbestanden application en requests).
"The connection-string header is no longer supported"De interface gebruikt een oude manier om verbinding te maken. Neem contact op met BrynQ-support om de interface bij te werken; de verbinding wordt nu op de server ingesteld.
Een module 404 Not FoundDe SQL-module is niet ingeschakeld. Voer het installatieprogramma opnieuw uit en vink SQL Server aan op de pagina Modules.

Meer: Problemen met de BrynQ Agent oplossen.