Zum Inhalt springen
DataTug.ai
GitHub

← Die drei Wege, DataTug mit KI zu nutzen

CLI-Befehle

Befehle, die dein Agent ausführen kann mit oder ohne Skill.

Ein KI-Coding-Agent kann jeden datatug-Befehl in einer Shell ausführen. Diese sind es wert, gekannt zu werden: Jeder wurde mit öffentlichen Beispieldaten ausgeführt, und jeder hat echte Ausgabe auf datatug.io.

Vier Dinge, nach denen Agenten fragen.

Was jeder Befehl tut, wie ein Agent das Ergebnis liest und ob das Plugin heute ein Skill dafür hat.

  • datatug compareVerfügbar

    Vergleiche zwei Datenbanken

    Liest das Schema und jede Zeile zweier Kopien einer Datenbank und meldet, was hinzugefügt, entfernt oder geändert wurde.

    Füge --json hinzu: ein Dokument mit einer Zusammenfassung, den Schemaänderungen und einem Datensatz jeder Abweichung. Der Exit-Status ist 0, selbst wenn die Datenbanken abweichen, daher liest der Agent die Zusammenfassung, um zu entscheiden.

    Noch kein SkillLies die Seite mit echter Ausgabe

  • datatug db copy · datatug db exportVerfügbar

    Sichere, stelle wieder her und verschiebe Tabellen ohne Datumsspalten

    Kopiert Tabellen zwischen Datenbanken oder exportiert eine Datenbank in einfache Dateien, die in Git gehören. Vergleiche das Ergebnis mit der Quelle, um es zu beweisen.

    Diese geben Fortschritt und Fehler auf stderr aus und haben heute kein --json. Schließe mit datatug compare --json ab, um ein Urteil zu erhalten, das der Agent lesen kann. Datumsangaben und Fremdschlüssel haben bekannte Einschränkungen, die auf der Seite aufgeführt sind.

    Noch kein SkillLies die Seite mit echter Ausgabe

  • datatug query runVerfügbar

    Führe eine Abfrage aus, erhalte Zeilen zurück

    Führt eine Abfrage gegen eine Datenbank-URL aus und gibt die Zeilen als JSON, JSONL, CSV oder YAML auf stdout aus. Zugriffsrichtlinien gelten, sofern sie nicht deaktiviert sind.

    Verwende --format json und lies stdout. Die angewandten Richtlinien werden auf stderr gemeldet, sodass der Agent sieht, was zurückgehalten wurde.

    Noch kein SkillLies die Seite mit echter Ausgabe

  • datatug scan · datatug showVerfügbar

    Lies die Struktur einer Datenbank

    Scannt eine Datenbank in ein DataTug-Projekt und gibt dann ihre Schemas, Tabellen, Spalten und Primärschlüssel aus.

    datatug show --format json gibt dieselbe Auflistung als ein JSON-Dokument aus; die Textform ist stabil, sodass zwei Läufe verglichen werden können.

    scan hat ein Skill; show nichtLies die Seite mit echter Ausgabe

Was ein Agent liest aus compare.

Das JSON aus dem compare-Lauf auf datatug.io: zwei Northwind-Kopien, und in der rechten wurden zwei Preise geändert, eine Kategorie hinzugefügt, ein Versandunternehmen gelöscht und eine Spalte hinzugefügt. Ein Versandunternehmen ist unten gezeigt.

Der Befehl

datatug compare northwind-sqlite northwind-sqlite \
  --project ./datatug-demo-project/demo-project-1 \
  --left-environment dev --right-environment dev \
  --left-source env:LEFT_DB --right-source env:RIGHT_DB \
  --json --details --limit 20 > compare.json
jq -c '.summary, .schemaChanges' compare.json
jq '.relations[] | select(.name == "Shippers")' compare.json

Die Ausgabe

{"added":1,"removed":1,"changed":6,"unchanged":3303}
["Regions.Note exists only in right"]
{
  "name": "Shippers",
  "kind": "relation",
  "identity": "primary-key",
  "leftRows": 3,
  "rightRows": 2,
  "counts": {
    "added": 0,
    "removed": 1,
    "changed": 0,
    "unchanged": 2
  },
  "details": [
    {
      "id": "ShipperID=3",
      "status": "removed",
      "fields": [
        {
          "name": "CompanyName",
          "before": "Federal Shipping",
          "after": null,
          "afterAbsent": true
        },
        {
          "name": "Phone",
          "before": "(503) 555-9931",
          "after": null,
          "afterAbsent": true
        },
        {
          "name": "ShipperID",
          "before": "3",
          "after": null,
          "afterAbsent": true
        }
      ]
    }
  ]
}

Ausgeführt mit datatug 0.78.0 am 2026-10-15, nur mit öffentlichen Beispieldaten. Aussagen über andere Datenbanken, Geschwindigkeit und Skalierung werden hier nicht gemacht.

Wo das Plugin aufhört. Vorerst.

Das Plugin hat Skills für install, init, projects, scan, validate und serve. Compare, copy und export, query run und show haben kein Skill, daher führt ein Agent sie in einer Shell aus. Ein Skill für jeden ist eine Folgearbeit, nichts, worauf man sich heute verlassen sollte.

Sieh jedes Skill und seinen Status