Przejdź do treści
DataTug.ai
GitHub

← Trzy sposoby używania DataTug z AI

Polecenia CLI

Polecenia, które Twój agent może uruchomić z umiejętnością lub bez.

Agent programistyczny AI może uruchomić dowolne polecenie datatug w powłoce. Oto te warte poznania: każde zostało uruchomione na publicznych danych przykładowych i każde ma rzeczywiste wyjście na datatug.io.

Cztery rzeczy o które proszą agenci.

Co robi każde polecenie, jak agent odczytuje wynik i czy wtyczka ma dla niego dziś umiejętność.

  • datatug compareDostępne

    Porównaj dwie bazy danych

    Odczytuje schemat i każdy wiersz dwóch kopii bazy danych i raportuje, co zostało dodane, usunięte lub zmienione.

    Dodaj --json: jeden dokument z podsumowaniem, zmianami schematu i zapisem każdej różnicy. Kod wyjścia to 0 nawet gdy bazy danych się różnią, więc agent czyta podsumowanie, aby zdecydować.

    Brak umiejętnościPrzeczytaj stronę z rzeczywistym wyjściem

  • datatug db copy · datatug db exportDostępne

    Kopia zapasowa, przywracanie i przenoszenie tabel bez kolumn dat

    Kopiuje tabele między bazami danych lub eksportuje bazę danych do zwykłych plików, które należą do Git. Porównaj wynik ze źródłem, aby to udowodnić.

    Te polecenia wypisują postęp i błędy na stderr i nie mają dziś --json. Zakończ datatug compare --json, aby uzyskać werdykt, który agent może odczytać. Daty i klucze obce mają znane ograniczenia, wymienione na stronie.

    Brak umiejętnościPrzeczytaj stronę z rzeczywistym wyjściem

  • datatug query runDostępne

    Uruchom zapytanie, otrzymaj wiersze

    Uruchamia zapytanie względem adresu URL bazy danych i wypisuje wiersze jako JSON, JSONL, CSV lub YAML na stdout. Zasady dostępu mają zastosowanie, chyba że zostaną wyłączone.

    Użyj --format json i czytaj stdout. Zastosowane zasady są raportowane na stderr, więc agent widzi, co zostało wstrzymane.

    Brak umiejętnościPrzeczytaj stronę z rzeczywistym wyjściem

  • datatug scan · datatug showDostępne

    Odczytaj strukturę bazy danych

    Skanuje bazę danych do projektu DataTug, a następnie wypisuje jej schematy, tabele, kolumny i klucze główne.

    datatug show --format json wypisuje tę samą listę jako jeden dokument JSON; forma tekstowa jest stabilna, więc dwa uruchomienia można porównać.

    Scan ma umiejętność; show nie maPrzeczytaj stronę z rzeczywistym wyjściem

Co agent odczytuje z compare.

JSON z uruchomienia compare na datatug.io: dwie kopie Northwind, a w prawej zmieniono dwie ceny, dodano kategorię, usunięto spedytora i dodano kolumnę. Poniżej pokazano jednego spedytora.

Polecenie

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

Wyjście

{"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
        }
      ]
    }
  ]
}

Uruchomiono z datatug 0.78.0 w dniu 2026-10-15, wyłącznie na publicznych danych przykładowych. Twierdzenia o innych bazach danych, szybkości i skali nie są tutaj formułowane.

Gdzie kończy się wtyczka. Na razie.

Wtyczka ma umiejętności dla install, init, projects, scan, validate i serve. Compare, copy i export, query run oraz show nie mają umiejętności, więc agent uruchamia je w powłoce. Umiejętność dla każdego z nich to kontynuacja, a nie coś, na czym można dziś polegać.

Zobacz każdą umiejętność i jej status