Datenbanken
MySQL / MariaDB
Fragt eine MySQL- oder MariaDB-Datenbank schreibgeschützt ab (Tabellen, Spalten, SELECT-Abfragen).
- Token oder Zugangsdaten
- Nur Lesen
- Auch über VPN-Tunnel
Tools für den Agenten
Der Agent wählt selbst das passende Tool für die Frage. Im Tab MCP und Datenbanken des Agenten können Sie nicht benötigte Tools deaktivieren.
| Tool | Funktion | Typ |
|---|---|---|
list_tables | Listet Tabellen und Views auf (Schema = Datenbank, Name, Typ). Verwenden Sie "search", um nach Namen zu filtern. | Lesen |
describe_table | Spalten einer Tabelle: Name, Typ, NULL-Zulässigkeit, Primärschlüssel. | Lesen |
execute_query | Führt eine schreibgeschützte SELECT-Abfrage (MySQL/MariaDB) aus und gibt höchstens 200 Zeilen zurück. | Lesen |
Einrichtung Schritt für Schritt
Öffnen Sie in Kaiross Integrationen, wählen Sie MySQL / MariaDB und klicken Sie auf Neue Verbindung. Das Formular zeigt denselben Leitfaden unter Leitfaden und empfohlene Berechtigungen.
- Erstellen Sie einen dedizierten Benutzer mit nur Leserechten:
CREATE USER 'kaiross'@'%' IDENTIFIED BY '…'; GRANT SELECT ON nome_database.* TO 'kaiross'@'%';(oder GRANT SELECT nur auf den benötigten Tabellen). - Wenn sich die Datenbank im Kundennetzwerk befindet, verwenden Sie einen VPN-Tunnel (Einstellungen → Netzwerk / VPN).
- Kaiross führt nur SELECT aus: Abfragekontrolle, READ ONLY-Session und -Transaktion, maximale Dauer und Zeilenlimit. Funktioniert mit MySQL 5.7+ und MariaDB 10.3+.
Felder des Formulars: Host, Port, Datenbank, Benutzer, SSL, Maximale Zeilen pro Abfrage, Timeout (ms).
Einzufügen (im Vault verschlüsselt, danach nicht mehr sichtbar): Passwort.
Gut zu wissen
- Liegt der Dienst im Netzwerk Ihres Unternehmens, erstellen Sie zuerst einen Tunnel unter Einstellungen → Netzwerk / VPN und wählen Sie in der Verbindung bei Erreichbar über den Tunnel. Siehe Datenbanken und ERP.
Mit einem Agenten verbinden
- Öffnen Sie Agenten, wählen Sie den Agenten und gehen Sie zum Tab MCP und Datenbanken.
- Wählen Sie unter Hinzufügen die Option Bestehende Integration verbinden und die Verbindung, oder Aus dem Katalog für eine neue (die Schaltfläche heisst dann Speichern und verknüpfen).
- Prüfen Sie unter Aktivierte Tools die aktiven Tools und unter Aktionsbestätigung, welche Aktionen eine Bestätigung verlangen.
- Klicken Sie auf Im Chat testen und stellen Sie eine Frage, die Daten aus dem Dienst braucht.
Häufige Fehler
- Ungültige Zugangsdaten
- Der Server akzeptiert Benutzer oder Passwort des Logins nicht: Prüfen Sie sie mit dem DBA und aktualisieren Sie die Verbindung.
- Unzureichende Berechtigungen
- Das Login kann Tabellen oder Views nicht lesen: Lassen Sie ihm Leserechte wie in den Skripten der Anleitung zu Datenbanken zuweisen.
- Dienst nicht erreichbar
- Prüfen Sie Adresse, Port und Firewall. Ein Server im Firmennetz braucht einen VPN-Tunnel; ohne Tunnel sind nur öffentliche Adressen erlaubt.
- Verschlüsselte Verbindung fehlgeschlagen
- Der Server akzeptiert keine Verschlüsselung, verlangt sie oder hat ein nicht vertrauenswürdiges Zertifikat: Prüfen Sie SSL. Ohne Verschlüsselung nur in einem VPN-Tunnel.
- Datenbank nicht gefunden
- Die angegebene Datenbank existiert auf dem Server nicht: Prüfen Sie den Datenbanknamen.