SQL Abfrage (Werkzeuge) - Sprachbasierte Abfrage (KI)

Warnung

Diese Funktion ist in der Alpha Phase und steht zur Zeit bis zur Klärung rechtlicher Fragen nur intern zur Verfügung

Zusammenfassung

Im SQL-Werkzeug gibt es ein Eingabe-Register „Sprachbasierte Abfrage (KI)" und ein zugehöriges Ausgabe-Register „KI-Ausgabe".

• Sie können Ihre Frage in normaler Sprache (Deutsch, Englisch, …) stellen, zum Beispiel „Wie viele Kunden gibt es pro Stadt?".
• Die KI erzeugt daraus eine SQL-Abfrage, zeigt sie an und führt sie automatisch aus, sofern es sich um eine reine Lese-Abfrage (SELECT) handelt.
• Schreibende Anweisungen (INSERT, UPDATE, DELETE, DROP, …) werden zwar erzeugt, aber niemals automatisch ausgeführt — Sie kopieren sie bei Bedarf in eines der normalen Eingabe-Register und führen sie dort selbst aus.
• Datenschutz: Es wird nur die Datenbank-Struktur (Tabellen-, Spalten- und Beschriftungsnamen) an den KI-Anbieter gesendet — niemals echte Inhalte aus den Tabellen.
• Konfiguration: einmalig in Einstellungen → KI die drei Felder „SQL KI-Chat" ausfüllen. Standardmäßig ist Google Gemini eingetragen, ein API-Schlüssel kann kostenlos und ohne Kreditkarte unter https://aistudio.google.com erzeugt werden.

Konzept

Das SQL-Werkzeug hat im Eingabebereich ein neues Register „Sprachbasierte Abfrage (KI)" hinter Input 1 bis 4. In diesem Register tippen Sie Ihre Frage in normaler Sprache und drücken auf Ausführen (oder F5). Im Hintergrund wird die Frage zusammen mit der Datenbank-Struktur an einen KI-Anbieter geschickt; die KI formuliert daraus eine SQL-Abfrage, die im neuen Ausgabe-Register „KI-Ausgabe" erscheint.

Bei reinen Lese-Abfragen wird die SQL automatisch ausgeführt und das Ergebnis direkt darunter angezeigt. Bei schreibenden Anweisungen wird die SQL nur angezeigt, ohne ausgeführt zu werden.

Einmalige Einrichtung

Vor dem ersten Einsatz öffnen Sie Einstellungen → KI und füllen die drei Felder aus:

Feld	Bedeutung
SQL KI-Chat – Basis-URL	Endpunkt des KI-Dienstes. Standard: https://generativelanguage.googleapis.com/v1beta/openai (Gemini).
SQL KI-Chat – Modell	Name des KI-Modells. Standard: gemini-3.1-flash-lite.
SQL KI-Chat – API-Schlüssel	Persönlicher Zugangsschlüssel zum KI-Dienst.

Einen kostenlosen Gemini-API-Schlüssel erhalten Sie ohne Kreditkarte unter https://aistudio.google.com anmelden mit einem Google-Konto, im linken Menü auf „Get API key" klicken, Schlüssel kopieren und in das Feld „API-Schlüssel" einfügen.

Warnung

Speichern und schließen Sie nach der Änderung den App Builder und starten Sie diesen neu. Erst danach griefen die Änderungen.

Warnung

Das Programm wurde nur mit Google Gemini und dem Model "gemini-3.1-flash-lite" getestet.
Wir können nicht für ein Funktionieren mit anderen Anbieter oder anderen Modellen als diesen garantieren.
Es können jedoch nur Modelle genutzt werden die "Function Calling / Tool Use" unterstützen.

Bitte beachten

Mit Google Gemini und dem Model "gemini-3.1-flash-lite" sind Stand Mai 2026 maximal 15 Anfragen pro Minute und 500 Anfragen pro Tag mit dem kostenlosen Modell möglich.
Diese Zahlen können sich ändern. Sie sehen die aktuellen Zahlen unter:
https://aistudio.google.com/rate-limit
Die Zahlen werden jedoch erst sichbar nachdem Sie das Model eine weil benutzt haben.

Wenn Sie mehr Anfragen benötigen können Sie natürlich auch mehr Anfragen gegen Bezahlung an Google bekommen. Die Kosten sind im Normalfall wenige Euro pro Monat. Für die genauen Kosten informieren Sie sich bitte bei Google.

Warnung

Beachten Sie das bei Nutzung der Google AI Free API die gesendeten Daten zum Training der LLMs (also des KIs) von Google genutzt werden.
https://ai.google.dev/gemini-api/terms?hl=de

Eine Frage stellen

1. Im SQL-Werkzeug das Register „Sprachbasierte Abfrage (KI)" wählen.
2. Frage in eigenen Worten eintippen, z. B. „Liste alle aktiven Kunden aus Berlin, sortiert nach Name."
3. Ausführen-Schaltfläche drücken oder F5 bzw F6.

Während die KI arbeitet, erscheint links oben im Eingabefeld ein blinkender grüner Punkt mit der Beschriftung „Denkt nach…". Rechts unten sehen Sie laufend, welcher Anbieter und welches Modell verwendet werden, sowie wie viele Anfragen und Tokens in der aktuellen Sitzung verbraucht wurden.

Im Register „KI-Ausgabe" erscheinen nacheinander:

─── Sie ───
<Ihre Frage>            (gelblich hinterlegt)

─── KI ───
<Erläuterung in Klartext>
SELECT ...

─── SQL wird ausgeführt (nur lesen) ───

<Ergebnis-Tabelle>

Die Ausgabe scrollt nach Ablauf automatisch zum Anfang des SQL-Ergebnisses, damit Sie das Resultat von oben nach unten lesen können.

Sicherheit: nur Lese-Abfragen werden ausgeführt

Die KI darf alle Arten von SQL erzeugen (auch DELETE, UPDATE, DROP, …), aber das Werkzeug führt nur Lese-Abfragen (SELECT, WITH, EXPLAIN) automatisch aus. Schreibende Anweisungen werden mit folgendem Hinweis angezeigt:

─── SQL nicht automatisch ausgeführt ─── Diese Anweisung würde Daten ändern oder löschen und wurde NICHT automatisch ausgeführt. Um sie auszuführen, kopieren Sie sie in eines der Eingabe-Register und führen Sie sie dort aus — auf eigene Verantwortung.

Damit können Sie z. B. Migrations-, Update- oder Lösch-Skripte von der KI schreiben lassen, behalten aber die volle Kontrolle über das Ausführen.

Selbstkorrektur bei SQL-Fehlern

Schlägt die automatisch ausgeführte SQL-Abfrage an der Datenbank fehl (z. B. wegen falsch geschriebenem Tabellen- oder Spaltennamen), schickt das Werkzeug die Fehlermeldung automatisch einmal zurück an die KI mit der Bitte, die SQL zu korrigieren. Im Ausgabebereich erscheint dann:

─── Automatische Wiederholung: Fehler an die KI senden ───

Schlägt auch der zweite Versuch fehl, wird hinten angefügt:

(Limit für automatische Wiederholungen erreicht — bitte formulieren Sie die Frage anders oder korrigieren Sie das SQL manuell)

Mehr als eine automatische Wiederholung erfolgt pro Frage nie. So kann es nicht zu Endlosschleifen kommen.

Was das Ki da erzeugt stimmt nicht

Sie selbst können die Ergebnisse des KI stark verbessern in dem Sie genaue und präzise Anfragen Stellen. Ansonsten muss das KI raten was genau Sie wollen.

Wir, der Hersteller von MapEdit haben keinen Einfluss auf die Qualität des KI Systems und können hier nichts ändern. GGf müssen Sie auf ein stärkeres Model wechseln.

Datenschutzhinweis

Vor jeder neuen Sitzung steht im (leeren) Eingabefeld ein heller Hinweistext:

KI-Chat — bitte einmal lesen, bevor Sie beginnen.

Datenschutz: Dieses Werkzeug sendet die STRUKTUR Ihrer Datenbank (Tabellennamen, Spaltennamen, Beschriftungen) an den in den Einstellungen festgelegten KI-Anbieter. Die tatsächlichen Daten in Ihren Tabellen werden NIEMALS gesendet.

Sicherheit: KI-Chat führt AUTOMATISCH nur Nur-Lese-Abfragen (SELECT) aus. Anweisungen, die Daten ändern oder löschen, werden angezeigt, aber nie automatisch ausgeführt — kopieren Sie sie in ein Eingabe-Register und führen Sie sie dort selbst aus, auf eigene Verantwortung.

Die KI kann Fehler machen — lesen Sie das SQL, bevor Sie sich auf das Ergebnis verlassen.

Sobald Sie zu tippen beginnen, verschwindet der Hinweis automatisch.

Welche Tabellen genau übermittelt werden sind System-Tabellen mit den Präfixen ME_ und TB_ ausgeschlossen, ebenso die interne Hilfstabelle XSQLSHEET_RESULT.

Verbrauchsanzeige (Tokens und Anfragen)

Rechts oben im Eingabefeld steht eine Zeile wie:

Gemini · gemini-3.1-flash-lite · 7 Anfragen · 12.318 Tokens

Diese Zähler beziehen sich nur auf die aktuelle Sitzung in diesem Fenster. Der tatsächliche Tages-Verbrauch ist im Konsolen-Dashboard des Anbieters einsehbar (z. B. https://aistudio.google.com).

Häufige Fehlermeldungen

Hinweis	Bedeutung / Lösung
„Der KI-Dienst ist nicht erreichbar"	Internetverbindung oder Basis-URL prüfen.
„Ihr KI-API-Schlüssel wurde abgelehnt"	Schlüssel in Einstellungen → Sonstiges erneuern.
„Die URL des KI-Dienstes oder der Modellname wurde nicht gefunden"	Basis-URL und Modellname in den Einstellungen kontrollieren.
„Der KI-Dienst drosselt Ihre Anfragen"	Tages- oder Minuten-Limit des Anbieters erreicht. Im Dashboard prüfen, kurz warten oder ein anderes Modell wählen.
„Ihr KI-Konto hat keine Credits mehr"	Beim Anbieter aufladen oder auf ein kostenloses Modell wechseln.

Wenn nichts mehr hilft

• Datenbank-Struktur ist groß und/oder das Modell hat zu strenge Limits: in den Einstellungen ein Modell mit höherer Tagesgrenze einstellen, z. B. gemma-3-27b-it (auf Gemini-Konten oft mehrere tausend Anfragen pro Tag).
• Die KI gibt unbrauchbare oder widersprüchliche Antworten: Frage neu und präziser formulieren — die KI weiß nichts über den Inhalt der Tabellen, nur über deren Struktur.
• Die SQL ist korrekt, aber das Ergebnis wirkt falsch: prüfen Sie die SQL bevor Sie ihr vertrauen — die KI kann Fehler machen, insbesondere bei Joins über mehrere Tabellen oder bei datentypabhängigen Funktionen (Datum, Geometrie, …).

Datenübermittlung, Haftungsausschluss und rechtliche Hinweise zur KI-Funktion

Dieses Kapitel beschreibt die Bedingungen, unter denen die Funktionen „SQL KI-Chat" und „Sprachbasierte Abfrage (KI)" in MapEdit genutzt werden dürfen. Der Anwender erhält diesen Text vor der ersten Verwendung der Funktion einmal pro Sitzung und Datenbankverbindung als Dialog angezeigt und muss ihm aktiv zustimmen.

---

1. Hinweis vor der ersten KI-Anfrage

Bevor Sie diese KI-Funktion nutzen können, beachten Sie bitte:

Ihre Frage und die Datenbank-STRUKTUR der Verbindung <Verbindungsname> (Tabellen- und Spaltennamen, Typen, Beschriftungen und Beziehungen) werden an den externen KI-Anbieter gesendet:

<KI-Anbieter>

NUR die Struktur wird gesendet. Die tatsächlich in Ihren Tabellen gespeicherten Daten (Datensatzwerte, Geometrien, Dateien) werden NIEMALS gesendet. Vom KI erzeugtes SQL wird lokal auf Ihrem Rechner ausgeführt und die Ergebniszeilen bleiben auf Ihrem Rechner.

Wichtig: Einige KI-Anbieter verwenden Ihre Fragen und das übertragene Schema möglicherweise zum Trainieren oder Verbessern ihrer Modelle. Prüfen Sie die Datenschutzrichtlinie des gewählten Anbieters, falls dies für Sie relevant ist.

---

2. Haftungsausschluss und rechtliche Hinweise

Mit der Nutzung der Funktion „SQL KI-Chat" / „Sprachbasierte Abfrage (KI)" akzeptiert die nutzende Person (im Folgenden „Anwender") die nachfolgenden Bedingungen. Diese Funktion ist als Werkzeug zur Unterstützung gedacht und ersetzt keinesfalls die fachliche Prüfung durch eine qualifizierte Person.

A. Keine Gewähr für KI-Ergebnisse

1. Die von der Künstlichen Intelligenz (KI) erzeugten SQL-Anweisungen, Erklärungen und sonstigen Antworten werden „wie besehen" („as is") zur Verfügung gestellt. Es wird keinerlei Gewähr dafür übernommen, dass diese Ergebnisse richtig, vollständig, geeignet, fehlerfrei, syntaktisch korrekt, semantisch sinnvoll, performant, sicher oder für einen bestimmten Zweck brauchbar sind.

2. Die KI ist ein statistisches Sprachmodell. Sie kann plausible, aber sachlich falsche Ergebnisse erzeugen („Halluzinationen"), Tabellen oder Spalten verwechseln, Bedingungen falsch formulieren, falsche Filter setzen, ungewollt zu viele oder zu wenige Datensätze treffen oder die SQL-Dialekt-Eigenheiten der eingesetzten Datenbank missachten.

3. Es besteht keine Garantie, dass identische oder sehr ähnliche Fragen zu identischen oder reproduzierbaren Antworten führen.

B. Pflichten und Eigenverantwortung des Anwenders

1. Schreibgeschützte SQL-Anweisungen (SELECT, WITH, EXPLAIN), die von der KI erzeugt werden, werden automatisch durch die Funktion ausgeführt. Schreibende Anweisungen (INSERT, UPDATE, DELETE, DROP, TRUNCATE, ALTER, MERGE, CREATE, GRANT, REVOKE, RENAME, REPLACE, …) werden NIEMALS automatisch ausgeführt - der Anwender muss sie bewusst in ein Eingabe-Register kopieren und dort ausführen. Der Anwender ist verpflichtet, jede von der KI erzeugte SQL-Anweisung sorgfältig zu prüfen, bevor er sich auf deren Ergebnisse stützt oder eine schreibende Anweisung ausführt. Insbesondere sind zu kontrollieren:

   • die referenzierten Tabellen und Spalten,
   • die Filter- und Verknüpfungsbedingungen (WHERE, JOIN),
   • bei schreibenden Anweisungen die Auswirkungen auf den Datenbestand und das Datenbank-Schema.

2. Schreibende Anweisungen darf der Anwender nur dann ausführen, wenn er deren Wirkung vollständig verstanden hat und einen tragfähigen Datenbank-Backup-Stand besitzt, mit dem er den Zustand vor der Ausführung wiederherstellen kann.

3. Der Einsatz der Funktion auf produktiven Datenbanken geschieht ausschließlich auf eigenes Risiko des Anwenders. Es wird ausdrücklich empfohlen, KI-erzeugte SQL-Anweisungen zuerst auf einer Test- oder Entwicklungs-Datenbank zu erproben.

4. Der Anwender ist allein verantwortlich für die Einhaltung sämtlicher einschlägiger gesetzlicher und vertraglicher Vorschriften, insbesondere in den Bereichen Datenschutz (z. B. DSGVO/GDPR), Geheimhaltung, IT-Sicherheit, Berufsgeheimnis und Aufbewahrungspflichten, beim Einsatz dieser Funktion innerhalb der eigenen Organisation und gegenüber Dritten.

C. Übermittlung an externe KI-Anbieter

1. Beim Einsatz dieser Funktion werden die in den Einstellungen konfigurierte Basis-URL und der API-Schlüssel verwendet, um Anfragen an einen externen, vom Anwender selbst gewählten KI-Anbieter zu senden (z. B. Google Gemini, OpenAI, OpenRouter, Mistral oder andere OpenAI-kompatible Dienste).

2. Übermittelt werden insbesondere die Datenbank-Struktur (Tabellennamen, Spaltennamen, Datentypen, Beschriftungen, Beziehungen) sowie die vom Anwender eingegebenen Fragen und der bisherige Konversationsverlauf der aktuellen Sitzung. Inhalte aus den Tabellen („Nutzdaten") werden nicht übermittelt.

3. Der Anwender erkennt an, dass diese Übermittlung gegebenenfalls in Rechenzentren außerhalb des EWR stattfinden kann und dass der gewählte KI-Anbieter eigenen, von MuM unabhängigen Geschäfts- und Datenschutzbedingungen unterliegt. Vor dem produktiven Einsatz ist sicherzustellen, dass die Übermittlung der Datenbank-Struktur und der eigenen Eingaben an diesen Anbieter im konkreten Anwendungsfall datenschutz-, geheimhaltungs- und vertragsrechtlich zulässig ist.

4. Für Verfügbarkeit, Antwortzeiten, Datennutzungspraxis, Speicherung, Trainingsverwertung, Kosten, Tageskontingente, Kontensperrungen und sonstige Maßnahmen des KI-Anbieters wird seitens MuM keinerlei Gewähr und keinerlei Haftung übernommen.

5. Sämtliche Kosten, die durch die Nutzung des KI-Anbieters entstehen (auch durch versehentliches Überschreiten kostenloser Kontingente, automatische Aufladungen oder Preisänderungen des Anbieters), trägt der Anwender selbst.

D. Haftungsausschluss

Soweit gesetzlich zulässig, schließt MuM die Haftung für sämtliche Schäden aus, die mittelbar oder unmittelbar aus der Nutzung der Funktion „SQL KI-Chat" entstehen. Dies gilt insbesondere — aber nicht ausschließlich — für:

• Verlust, Veränderung, Beschädigung oder Unvollständigkeit von Daten in der Datenbank des Anwenders oder Dritter;
• Betriebsunterbrechungen, entgangenen Gewinn, entgangene Einsparungen, Mehraufwand, vergebliche Aufwendungen oder sonstige Folgeschäden;
• Schäden durch fehlerhaft generierte SQL-Anweisungen, einschließlich schreibender Anweisungen, die der Anwender selbst aus dem Werkzeug in ein Eingabe-Register kopiert und dort ausgeführt hat;
• Schäden, die durch das Verhalten, den Ausfall, die Verzögerung, Datenschutzverstöße oder Vertragsverletzungen des externen KI-Anbieters entstehen;
• Kosten, die durch die Nutzung des KI-Anbieters entstehen;
• Verstöße des Anwenders gegen rechtliche, vertragliche oder organisatorische Vorgaben.

Dieser Haftungsausschluss gilt nicht für Schäden aus der Verletzung des Lebens, des Körpers oder der Gesundheit, die auf einer fahrlässigen Pflichtverletzung von MuM oder einer vorsätzlichen oder grob fahrlässigen Pflichtverletzung eines gesetzlichen Vertreters oder Erfüllungsgehilfen von MuM beruhen, sowie für sonstige Schäden, soweit sie auf vorsätzlicher oder grob fahrlässiger Pflichtverletzung von MuM, ihren gesetzlichen Vertretern oder Erfüllungsgehilfen beruhen, oder soweit eine Haftung nach zwingenden gesetzlichen Vorschriften (z. B. Produkthaftungsgesetz) nicht ausgeschlossen werden kann.

E. Beta-Charakter, Änderungen, Abkündigung

1. Die Funktion „SQL KI-Chat" kann jederzeit ohne Vorankündigung verändert, eingeschränkt, ersetzt oder vollständig entfernt werden.

2. Die unterstützten KI-Anbieter, Modellnamen, Kontingente und Schnittstellen liegen außerhalb des Einflussbereichs von MuM und können sich jederzeit ändern. Voreinstellungen in der Software stellen keine Zusicherung der dauerhaften Verfügbarkeit dar.

F. Zustimmung

Mit dem aktiven Einsatz der Funktion erklärt der Anwender, dass er diesen Haftungsausschluss gelesen, verstanden und akzeptiert hat und dass die Nutzung der Funktion in seinem konkreten Einsatzkontext zulässig ist.