Was macht oracledb?
Agenten-Fähigkeit 'oracledb' aus cline/skills.
Übersicht
Ermöglicht KI-Agenten die Interaktion mit Oracle-Datenbanken, indem sie SQL-Abfragen ausführen, Daten abrufen und das Datenbankschema erkunden können.
Voraussetzungen
- Oracle-Datenbank (11g oder höher)
- Node.js 14+
- Oracle Instant Client-Bibliotheken (installiert und konfiguriert)
Konfiguration
Erstelle eine Datei oracledb.yaml im Stammverzeichnis deines Projekts:
# oracledb.yaml
connection:
user: ${ORACLE_USER}
password: ${ORACLE_PASSWORD}
connectString: ${ORACLE_CONNECTION_STRING}
Oder verwende profiles.yaml:
# profiles.yaml
profiles:
demo:
connection:
user: scott
password: tiger
connectString: localhost:1521/FREEPDB1
Verwendung
Daten abfragen
SELECT * FROM employees WHERE department_id = 10
Schema erkunden
SELECT table_name, owner FROM all_tables WHERE owner = 'HR'
Index-Informationen abrufen
SELECT index_name, table_name FROM all_indexes WHERE table_owner = 'HR'
Umgebungsvariablen
| Variable | Beschreibung |
|---|---|
ORACLE_USER | Datenbank-Benutzername |
ORACLE_PASSWORD | Datenbank-Passwort |
ORACLE_CONNECTION_STRING | Verbindungszeichenfolge (z. B. host:port/service) |
Unterstützte Plattformen
- Oracle Database 11g, 12c, 18c, 19c, 21c
- Oracle Autonomous Database (über Wallet-Verbindung)
- Oracle Database in Docker-Containern
Beispielablauf
- Der Agent verbindet sich mit der konfigurierten Oracle-Datenbank.
- Der Benutzer fragt nach 'Zeige mir alle Tabellen im HR-Schema'.
- Der Agent führt
SELECT table_name FROM all_tables WHERE owner = 'HR'aus. - Der Agent gibt die Liste der Tabellen als JSON-Objekt zurück.
Fehlerbehandlung
- Verbindungsfehler werden mit klaren Meldungen gemeldet, die auf fehlende Umgebungsvariablen oder falsche Verbindungszeichenfolgen hinweisen.
- SQL-Fehler werden mit der ursprünglichen Oracle-Fehlermeldung zurückgegeben.
- Timeouts führen zu einer entsprechenden Meldung; die Verbindung bleibt dabei erhalten.
Lizenz
MIT