ForHosting KIT · Entwickler-Tools

SQL-Abfragen aus einem Satz erzeugen

Diese Funktion wandelt eine in normaler Sprache gestellte Frage – zusammen mit der Struktur der beteiligten Tabellen – in eine ausführbare SQL-Abfrage um. Gedacht für alle, die Daten auswerten möchten, ohne selbst SELECT-Anweisungen mit JOINs und Bedingungen zu schreiben, etwa im Marketing oder Produktmanagement.

● Betapro Anfrage + pro Abfrage$0.003

Ausführen — $0.003 + $0.0135/Abfrage API ansehen

Nutzen Sie es über WebAPIE-MailApp baldTelegram bald

Online ausführen

Führen Sie dies mit Ihrem Konto auf unseren Servern aus. Kostenlose Tools laufen in Ihrem Browser; dieses wird zum oben genannten Preis von Ihrem KIT-Guthaben abgebucht.

Tabellenstruktur plus Frage, fertiges SQL zurück

Sie geben die Namen und Spalten der betroffenen Tabellen an – etwa als kurze Liste oder als CREATE-TABLE-Anweisung – und formulieren die Frage in normaler Sprache, zum Beispiel „alle Kunden aus Bayern mit mehr als drei Bestellungen im letzten Monat“. Die Funktion erzeugt daraus eine SQL-Abfrage mit den passenden JOINs, WHERE-Bedingungen und Aggregationen, inklusive kurzer Erklärung, was die Abfrage tut.

Für welche Datenbank die Abfrage gilt

Da sich die SQL-Syntax zwischen PostgreSQL, MySQL und SQL Server in Details unterscheidet – etwa bei Datumsfunktionen oder der Paginierung –, geben Sie das Zielsystem mit an. Die Funktion passt Syntax und Funktionsnamen entsprechend an, statt eine generische Abfrage zu liefern, die im gewählten System nicht ausgeführt werden kann. Ohne Angabe des Zielsystems verwendet die Funktion einen Standard-SQL-Dialekt, der sich in den meisten Fällen mit kleinen Anpassungen übernehmen lässt, aber nicht jede systemspezifische Funktion abdeckt.

Aktueller Stand: Beta

Diese Funktion befindet sich in der Beta-Phase: Bei klar benannten Tabellen und eindeutigen Fragen ist die erzeugte Abfrage in aller Regel korrekt, bei mehrdeutigen Formulierungen oder sehr komplexen Datenmodellen mit vielen Beziehungen kann sie vom gewünschten Ergebnis abweichen. Vor dem Einsatz auf echten Daten sollte die Abfrage geprüft und idealerweise zunächst gegen eine Kopie der Datenbank getestet werden. KIT weist den Beta-Status offen aus, statt eine Zuverlässigkeit zu versprechen, die sich bei jedem Datenmodell gleichermaßen einstellt.

Preis pro Abfrage

Eine erzeugte Abfrage kostet $0.003 Grundgebühr plus $0.0135, insgesamt rund $0.017 pro Anfrage. Es gibt kein Abonnement: Die Funktion lässt sich über die API einbinden, etwa in ein internes Analyse-Tool, das Fachabteilungen eigene Fragen an die Datenbank stellen lässt, ohne dass jede Anfrage über die IT-Abteilung läuft. Bei mehreren Abfragen pro Tag summiert sich das auf wenige Cent im Monat, deutlich weniger als die Zeit, die eine manuell formulierte Abfrage in Anspruch nimmt.

Anwendungsfälle

Fachabteilung stellt eigene Datenfragen

Sabine Schneider arbeitet im Vertrieb der Weber Metallbau GmbH und formuliert ihre Frage zu Umsätzen nach Region in normaler Sprache, statt jedes Mal die IT-Abteilung um eine SQL-Abfrage zu bitten.

Erste Abfrage für ein internes Dashboard

Ein Entwickler nutzt die Funktion über die API, um für ein neues internes Dashboard einen ersten Entwurf der benötigten Abfragen zu erzeugen, bevor er sie im Detail überarbeitet.

Onboarding für ein unbekanntes Datenmodell

Jonas Weber übernimmt die Betreuung einer fremden Datenbank mit über sechzig Tabellen und lässt sich für erste Auswertungen die passenden Abfragen vorschlagen, um die Struktur schneller zu verstehen.

Häufige Fragen

Wird meine Datenbankstruktur gespeichert?

Nein. Die angegebene Tabellenstruktur wird nur zur Erstellung der jeweiligen Abfrage verwendet und danach nicht gespeichert.

Führt die Funktion die Abfrage auch selbst aus?

Nein. Sie erzeugt nur die SQL-Abfrage als Text; die Ausführung gegen die eigene Datenbank bleibt Sache des Nutzers oder der Anwendung.

Was bedeutet der Beta-Status genau?

Bei klaren Tabellen und eindeutigen Fragen ist das Ergebnis in aller Regel korrekt; bei komplexen Datenmodellen oder mehrdeutigen Fragen sollte die Abfrage vor dem Einsatz geprüft werden.

Welche Datenbanksysteme werden unterstützt?

PostgreSQL, MySQL und SQL Server. Das Zielsystem wird bei der Anfrage angegeben, damit Syntax und Funktionen passen.

Was kostet eine Abfrage?

$0.003 Grundgebühr plus $0.0135, insgesamt rund $0.017 pro erzeugter Abfrage.

Brauche ich ein Konto?

Nein. Es gibt derzeit keine Konten – Sie zahlen pro Abfrage, direkt über PayPal.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/dev/text-to-sql

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/dev/text-to-sql \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/dev/text-to-sql", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/text-to-sql",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/text-to-sql", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/text-to-sql", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "input": "…"
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.text_to_sql",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.003

pro Abfrage$0.0135

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.
`422`	`task_failed`	Die Aufgabe ist fehlgeschlagen und wird nicht berechnet.

Vollständige KIT-Dokumentation lesen →