Salta al contenuto
DataTug.ai
GitHub

← I tre modi per usare DataTug con l'AI

Comandi CLI

Comandi che il tuo agente può eseguire con o senza una skill.

Un agente di programmazione AI può eseguire qualsiasi comando datatug in una shell. Questi sono quelli che vale la pena conoscere: ognuno è stato eseguito su dati di esempio pubblici, e ognuno ha output reale su datatug.io.

Quattro cose che gli agenti chiedono.

Cosa fa ogni comando, come un agente legge il risultato e se il plugin ha una skill per esso oggi.

  • datatug compareDisponibile

    Confronta due database

    Legge lo schema e ogni riga di due copie di un database e riporta cosa è stato aggiunto, rimosso o modificato.

    Aggiungi --json: un documento con un riepilogo, le modifiche allo schema e un record di ogni differenza. Il codice di uscita è 0 anche quando i database differiscono, quindi l'agente legge il riepilogo per decidere.

    Ancora nessuna skillLeggi la pagina con output reale

  • datatug db copy · datatug db exportDisponibile

    Backup, ripristino e spostamento di tabelle senza colonne data

    Copia tabelle tra database, o esporta un database in file di testo che appartengono a Git. Confronta il risultato con la sorgente per dimostrarlo.

    Questi stampano progressi ed errori su stderr e non hanno --json oggi. Termina con datatug compare --json per un verdetto che l'agente può leggere. Date e chiavi esterne hanno limiti noti, elencati nella pagina.

    Ancora nessuna skillLeggi la pagina con output reale

  • datatug query runDisponibile

    Esegui una query, ottieni righe

    Esegue una query su un URL di database e stampa le righe come JSON, JSONL, CSV o YAML su stdout. Le politiche di accesso si applicano a meno che non siano disattivate.

    Usa --format json e leggi stdout. Le politiche applicate sono riportate su stderr, così l'agente vede cosa è stato trattenuto.

    Ancora nessuna skillLeggi la pagina con output reale

  • datatug scan · datatug showDisponibile

    Leggi la struttura di un database

    Scansiona un database in un progetto DataTug, poi stampa i suoi schemi, tabelle, colonne e chiavi primarie.

    datatug show --format json stampa lo stesso elenco come un documento JSON; la forma testuale è stabile, quindi due esecuzioni possono essere confrontate.

    Scan ha una skill; show noLeggi la pagina con output reale

Cosa legge un agente da compare.

Il JSON dall'esecuzione di compare su datatug.io: due copie di Northwind, e nella copia di destra due prezzi sono cambiati, una categoria è stata aggiunta, uno spedizioniere è stato eliminato e una colonna è stata aggiunta. Uno spedizioniere è mostrato sotto.

Il comando

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

L'output

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

Eseguito con datatug 0.78.0 il 2026-10-15, solo su dati di esempio pubblici. Affermazioni su altri database, velocità e scala non sono fatte qui.

Dove il plugin si ferma. Per ora.

Il plugin ha skill per install, init, projects, scan, validate e serve. Compare, copy ed export, query run e show non hanno una skill, quindi un agente li esegue in una shell. Una skill per ciascuno è un follow-up, non qualcosa su cui fare affidamento oggi.

Vedi ogni skill e il suo stato