Passer au contenu
DataTug.ai
GitHub

← Les trois façons d'utiliser DataTug avec l'IA

Commandes CLI

Commandes que votre agent peut exécuter avec ou sans skill.

Un agent de codage IA peut exécuter n'importe quelle commande datatug dans un shell. Voici celles qui valent la peine d'être connues : chacune a été exécutée sur des données d'exemple publiques, et chacune a une sortie réelle sur datatug.io.

Quatre choses que les agents demandent.

Ce que fait chaque commande, comment un agent lit le résultat, et si le plugin a un skill pour elle aujourd'hui.

  • datatug compareDisponible

    Comparer deux bases de données

    Lit le schéma et chaque ligne de deux copies d'une base de données et signale ce qui a été ajouté, supprimé ou modifié.

    Ajoutez --json : un document avec un résumé, les changements de schéma et un enregistrement de chaque différence. Le code de sortie est 0 même lorsque les bases de données diffèrent, l'agent lit donc le résumé pour décider.

    Pas encore de skillLire la page avec la sortie réelle

  • datatug db copy · datatug db exportDisponible

    Sauvegarder, restaurer et déplacer des tables sans colonnes de date

    Copie des tables entre bases de données, ou exporte une base de données vers des fichiers simples qui ont leur place dans Git. Comparez le résultat avec la source pour le prouver.

    Ces commandes affichent la progression et les erreurs sur stderr et n'ont pas de --json aujourd'hui. Terminez avec datatug compare --json pour un verdict que l'agent peut lire. Les dates et les clés étrangères ont des limites connues, listées sur la page.

    Pas encore de skillLire la page avec la sortie réelle

  • datatug query runDisponible

    Exécuter une requête, récupérer les lignes

    Exécute une requête contre une URL de base de données et imprime les lignes en JSON, JSONL, CSV ou YAML sur stdout. Les politiques d'accès s'appliquent sauf si elles sont désactivées.

    Utilisez --format json et lisez stdout. Les politiques appliquées sont signalées sur stderr, l'agent voit donc ce qui a été retenu.

    Pas encore de skillLire la page avec la sortie réelle

  • datatug scan · datatug showDisponible

    Lire la structure d'une base de données

    Scanne une base de données dans un projet DataTug, puis imprime ses schémas, tables, colonnes et clés primaires.

    datatug show --format json imprime la même liste sous forme d'un document JSON ; la forme texte est stable, deux exécutions peuvent donc être comparées.

    Scan a un skill ; show n'en a pasLire la page avec la sortie réelle

Ce qu'un agent lit depuis compare.

Le JSON de l'exécution de compare sur datatug.io : deux copies de Northwind, et dans celle de droite deux prix ont changé, une catégorie ajoutée, un transporteur supprimé et une colonne ajoutée. Un transporteur est montré ci-dessous.

La commande

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

La sortie

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

Exécuté avec datatug 0.78.0 le 2026-10-15, sur des données d'exemple publiques uniquement. Aucune affirmation sur d'autres bases de données, la vitesse et l'échelle n'est faite ici.

Où le plugin s'arrête. Pour l'instant.

Le plugin a des skills pour install, init, projects, scan, validate et serve. Compare, copy et export, query run et show n'ont pas de skill, un agent les exécute donc dans un shell. Un skill pour chacun est une suite, pas quelque chose sur quoi compter aujourd'hui.

Voir tous les skills et leur statut