Datenbanken und ERP: SQL Server, PostgreSQL, MySQL und VPN-Tunnel
Der Agent fragt die ERP-Datenbank nur lesend mit einem eigenen Login ab und lernt die Struktur dank dem Mapping. Hier finden Sie die Skripte für Ihre IT.
Stand:
Immer nur lesend
Kaiross führt nur SELECT-Abfragen aus: Es prüft jede Abfrage vor der Ausführung, nutzt die Berechtigungen des Logins (nur Lesen) und setzt Timeout und Zeilenlimit. Daten für Diagramme und Exporte werden erneut aus der Datenbank gelesen, ohne über das Modell zu laufen.
SQL Server: eigener Login
Bitten Sie Ihren DBA, einen Login zu erstellen, den nur Kaiross verwendet. Skript für den Serveradministrator (ersetzen Sie die Platzhalter in < >):
USE [master];
CREATE LOGIN [<login_kaiross>] WITH PASSWORD = N'<password>', CHECK_POLICY = ON, DEFAULT_DATABASE = [<database>];
GO
USE [<database>];
CREATE USER [<login_kaiross>] FOR LOGIN [<login_kaiross>];
GRANT SELECT ON SCHEMA::[dbo] TO [<login_kaiross>];
GRANT VIEW DEFINITION TO [<login_kaiross>];
GRANT VIEW DATABASE STATE TO [<login_kaiross>];
GO - Fügen Sie den Login nicht zu
db_owner,db_datawriteroder Serverrollen hinzu. VIEW DATABASE STATEist optional: Es macht Zeilenzählungen genauer und schneller.- Sensible Tabellen (z. B. Personaldaten) schliessen Sie mit
DENYaus:
DENY SELECT ON OBJECT::[dbo].[<table>] TO [<login_kaiross>]; Das Passwort wird nur im Kaiross-Konnektor eingegeben, der es im Vault speichert: Schreiben Sie es nicht in E-Mails oder Tickets.
PostgreSQL: eigene Rolle
CREATE ROLE kaiross LOGIN PASSWORD '<password>';
GRANT pg_read_all_data TO kaiross; Oder erlauben Sie nur das Lesen der benötigten Tabellen:
GRANT USAGE ON SCHEMA public TO kaiross;
GRANT SELECT ON public.<table> TO kaiross; Kaiross öffnet die Sitzung im Modus READ ONLY mit statement_timeout und Zeilenlimit.
MySQL und MariaDB: eigener Benutzer
Bitten Sie den DBA um einen Benutzer, den nur Kaiross verwendet, mit ausschliesslich der Berechtigung SELECT:
CREATE USER 'kaiross'@'%' IDENTIFIED BY '<password>';
GRANT SELECT ON <database>.* TO 'kaiross'@'%'; Oder erteilen Sie Leserechte nur für die benötigten Tabellen:
GRANT SELECT ON <database>.<table> TO 'kaiross'@'%'; Kaiross öffnet Sitzung und Abfragen nur lesend (READ ONLY), mit einer vom Server erzwungenen Höchstdauer und einem Zeilenlimit. Funktioniert mit MySQL 5.7+ und MariaDB 10.3+.
Bei SSL lassen Sie Erforderlich oder wählen Erforderlich + Zertifikat prüfen: Deaktiviert (nur in VPN) nur innerhalb eines Tunnels.
Die Verbindung erstellen
- Öffnen Sie Integrationen → SQL Server (oder PostgreSQL, MySQL / MariaDB) und klicken Sie auf Neue Verbindung.
- Geben Sie Host, Port, Datenbank, Benutzer und Passwort ein. Liegt der Server im Firmennetz, wählen Sie bei Erreichbar über den VPN-Tunnel.
- Bei einem von SQL Server erzeugten (selbstsignierten) Zertifikat aktivieren Sie Self-signed-Zertifikat akzeptieren.
- Klicken Sie auf Verbindung testen und speichern Sie. Verknüpfen Sie die Verbindung dann im Tab MCP und Datenbanken mit dem Agenten.
Felder und Tools im Detail: SQL Server, PostgreSQL, MySQL / MariaDB.
WireGuard-VPN-Tunnel
Um einen Server im Firmennetz zu erreichen, braucht es einen WireGuard-Server auf Ihrer Seite (Router oder Firewall mit WireGuard oder eine kleine VM), der über einen UDP-Port erreichbar ist.
- Öffnen Sie in Kaiross Einstellungen → Netzwerk / VPN und klicken Sie auf Neuer Tunnel.
- Wählen Sie unter Modus entweder Konfiguration einfügen (die
.conf-Datei Ihrer IT) oder Schlüssel generieren: Sie geben Kaiross zugewiesene Adresse, Server-Endpoint, Öffentlicher Schlüssel des Servers, Erreichbare Netze und bei Bedarf Internes DNS (optional) an. - Klicken Sie auf Speichern und prüfen. Bei Schlüssel generieren übergeben Sie der IT den Öffentlicher Schlüssel von Kaiross für den WireGuard-Server.
- Geben Sie bei Erreichbarkeit prüfen (optional) den Port des Servers an (z. B. 1433) und klicken Sie auf Test: Es muss Handshake erfolgreich erscheinen.
[Interface]
PrivateKey = <Kaiross private key>
Address = 10.0.0.2/32
MTU = 1280
[Peer]
PublicKey = <server public key>
Endpoint = <vpn.example.ch>:51820
AllowedIPs = 10.0.0.5/32 AllowedIPsauf die Adresse des SQL-Servers beschränken: Der Tunnel dient nur dem Konnektor.MTU = 1280im Abschnitt[Interface]: Mit höheren Werten können lange Abfragen hängen bleiben.- SQL Server auf einem festen TCP-Port: Der Dienst SQL Browser läuft nicht durch den Tunnel, geben Sie den Port daher im Konnektor an.
«Datenbank mappen»
ERP-Systeme haben Tausende von Tabellen. Das Mapping (nur SQL Server) liest sie einmal und schreibt die Struktur in das Knowledge eines Agenten: Tabellen, Spalten, Schlüssel, Beziehungen, Views und Beispielabfragen. Ins Knowledge gelangt nur die Struktur: Es werden keine Tabellenwerte gespeichert.
- Öffnen Sie Integrationen → SQL Server, den Tab der Verbindungen, den Bereich Datenbank-Mapping und klicken Sie auf Datenbank mappen.
- Wählen Sie den Ziel-Agent (am besten ein eigener Agent, z. B. «ERP-Analyst»). Beim ersten Mapping ist Tabellen beproben (TOP 100 Zeilen) aktiv, Maximal zu beprobende Tabellen steht auf 300 (die grössten; die Struktur wird für alle gelesen) und Maximale Zeit (Minuten) auf 20, höchstens 25. Danach übernimmt das Formular die Optionen des letzten Mappings. Klicken Sie auf Mapping starten.
- Verfolgen Sie den Fortschritt: Sie können die Seite schliessen, das Mapping läuft auf dem Server weiter. Warten Sie danach, bis alle Dateien im Knowledge Bereit sind.
- Öffnen Sie
00_panoramica.sqlund prüfen Sie die Zeile Gestionale riconosciuto (erkanntes ERP).
| Datei | Inhalt |
|---|---|
00_panoramica.sql | Übersicht, erkanntes ERP, nicht standardmässige Tabellen und Spalten, Hinweise. |
10_tabelle_<area>.sql | Tabellen nach Bereich mit Spalten, Typen und Schlüsseln. |
20_relazioni.sql | Deklarierte und abgeleitete Beziehungen mit Zuverlässigkeit in Prozent. |
30_viste.sql, 40_procedure_funzioni.sql | Views, Prozeduren und Funktionen. |
50_cross_database.sql | Verweise auf andere Datenbanken. |
60_query_esempio.sql, 65_query_standard.sql | Beispielabfragen; die Standardabfragen nur bei einem erkannten ERP. |
90_personalizzazioni.sql | Die Regeln Ihres Unternehmens: einmal erstellt, nie überschrieben, hat Vorrang vor allem anderen. |
Meldet das Mapping Fehlende Berechtigungen (z. B. für weitere Datenbanken), klicken Sie auf Skript kopieren: Es enthält die genauen GRANT-Befehle nur zum Lesen, die Ihr DBA ausführt. Danach Erneut versuchen.
Mago4-Profil
Bei Mago4 (Microarea, Gruppe Zucchetti) erkennt Kaiross das ERP, kennt die Standardbeziehungen und ergänzt 65_query_standard.sql mit den häufigsten Abfragen. Die erwartete Übereinstimmung in 00_panoramica.sql liegt über 90%.
Die Einträge «da verificare» in 65_query_standard.sql (Belegart der Gutschrift, Kostenbasis für die Marge) bestätigen Sie mit der Person, die das ERP kennt.
90_personalizzazioni.sql: die Regeln Ihres Unternehmens
Diese Datei zeigt dem Agenten, wie Ihr Unternehmen das ERP nutzt. Sie wird in einer Sitzung von etwa 30 Minuten mit einer Person ausgefüllt, die die Daten kennt: Agenten → Agent → Knowledge → 90_personalizzazioni.sql → Bearbeiten. Ersetzen Sie die TODO durch die Antworten und löschen Sie die Beispielzeilen.
- Codes und Bedeutungen: welche Belegarten Rechnung, Gutschrift und Lieferschein sind; wofür zusätzliche Tabellen und Spalten dienen.
- Geschäftsregeln: was zum Umsatz zählt, welche Kosten für die Marge gelten, welche Lager in den Beständen zählen, wann ein Auftrag offen oder verspätet ist.
- Beziehungen der eigenen Tabellen und die 3 Auswertungen, die Sie am häufigsten brauchen.
Wiederholen Sie das Mapping nach jedem ERP-Update oder mindestens alle 6 Monate: Die Datei mit den Anpassungen bleibt unverändert. Pro Verbindung läuft jeweils nur ein Mapping.