Saltar al contenido
DataTug.ai
GitHub

← Las tres formas de usar DataTug con IA

Comandos de CLI

Comandos que tu agente puede ejecutar con o sin un skill.

Un agente de código de IA puede ejecutar cualquier comando de datatug en un shell. Estos son los que vale la pena conocer: cada uno se ejecutó con datos de muestra públicos y cada uno tiene salida real en datatug.io.

Cuatro cosas que los agentes piden.

Qué hace cada comando, cómo lee el resultado un agente y si el plugin tiene un skill para él hoy.

  • datatug compareDisponible

    Compara dos bases de datos

    Lee el esquema y cada fila de dos copias de una base de datos e informa qué se añadió, eliminó o cambió.

    Añade --json: un documento con un resumen, los cambios de esquema y un registro de cada diferencia. El código de salida es 0 incluso cuando las bases de datos difieren, así que el agente lee el resumen para decidir.

    Aún no hay skillLee la página con salida real

  • datatug db copy · datatug db exportDisponible

    Copia de seguridad, restauración y movimiento de tablas sin columnas de fecha

    Copia tablas entre bases de datos o exporta una base de datos a archivos planos que deben ir en Git. Compara el resultado con el origen para demostrarlo.

    Estos imprimen progreso y errores en stderr y no tienen --json hoy. Termina con datatug compare --json para obtener un veredicto que el agente pueda leer. Las fechas y claves foráneas tienen límites conocidos, listados en la página.

    Aún no hay skillLee la página con salida real

  • datatug query runDisponible

    Ejecuta una consulta y obtén filas

    Ejecuta una consulta contra una URL de base de datos e imprime las filas como JSON, JSONL, CSV o YAML en stdout. Se aplican las políticas de acceso a menos que se desactiven.

    Usa --format json y lee stdout. Las políticas que se aplicaron se informan en stderr, así el agente ve qué se retuvo.

    Aún no hay skillLee la página con salida real

  • datatug scan · datatug showDisponible

    Lee la estructura de una base de datos

    Escanea una base de datos en un proyecto de DataTug y luego imprime sus esquemas, tablas, columnas y claves primarias.

    datatug show --format json imprime el mismo listado como un único documento JSON; la forma de texto es estable, así que se pueden comparar dos ejecuciones.

    Scan tiene skill; show noLee la página con salida real

Qué lee un agente de compare.

El JSON de la ejecución de compare en datatug.io: dos copias de Northwind, y en la derecha cambiaron dos precios, se añadió una categoría, se eliminó un transportista y se añadió una columna. Abajo se muestra un transportista.

El 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

La salida

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

Ejecutado con datatug 0.78.0 el 2026-10-15, solo con datos de muestra públicos. No se hacen afirmaciones sobre otras bases de datos, velocidad o escala.

Dónde se detiene el plugin. Por ahora.

El plugin tiene skills para install, init, projects, scan, validate y serve. Compare, copy y export, query run y show no tienen skill, así que un agente los ejecuta en un shell. Un skill para cada uno es un trabajo futuro, no algo con lo que contar hoy.

Ver todos los skills y su estado