Перейти к содержимому
DataTug.ai
GitHub

← Три способа использовать DataTug с ИИ

Команды CLI

Команды, которые может запускать ваш агент с навыком и без него.

ИИ-агент для разработки может запустить в оболочке любую команду datatug. Вот те, которые стоит знать: каждую мы запускали на открытых учебных данных, и у каждой на datatug.io есть настоящий вывод.

Четыре задачи, с которыми приходят к агентам.

Что делает каждая команда, как агент читает результат и есть ли у неё сегодня навык в плагине.

  • datatug compareДоступно

    Сравнить две базы данных

    Читает схему и каждую строку двух копий базы данных и сообщает, что добавлено, удалено или изменено.

    Добавьте --json: один документ с итогом, изменениями схемы и записью о каждом отличии. Код завершения равен 0, даже когда базы отличаются, поэтому решение агент принимает по итогу.

    Навыка пока нетОткрыть страницу с настоящим выводом

  • datatug db copy · datatug db exportДоступно

    Резервная копия, восстановление и перенос таблиц без столбцов с датами

    Копирует таблицы между базами или выгружает базу в обычные файлы, которым место в Git. Сравните результат с источником, чтобы это доказать.

    Эти команды печатают ход выполнения и ошибки в stderr, а флага --json у них сегодня нет. Завершите работу командой datatug compare --json, чтобы получить вердикт, который агент прочитает. У дат и внешних ключей есть известные ограничения, они перечислены на странице.

    Навыка пока нетОткрыть страницу с настоящим выводом

  • datatug query runДоступно

    Выполнить запрос и получить строки

    Выполняет запрос к базе по URL и печатает строки в stdout как JSON, JSONL, CSV или YAML. Политики доступа действуют, пока их не отключили.

    Используйте --format json и читайте stdout. Применённые политики сообщаются в stderr, поэтому агент видит, что было скрыто.

    Навыка пока нетОткрыть страницу с настоящим выводом

  • datatug scan · datatug showДоступно

    Прочитать структуру базы

    Сканирует базу в проект DataTug, затем печатает её схемы, таблицы, столбцы и первичные ключи.

    datatug show --format json печатает тот же список одним JSON-документом; текстовая форма стабильна, поэтому два запуска можно сравнить.

    У scan есть навык, у show нетОткрыть страницу с настоящим выводом

Что агент читает из compare.

JSON из запуска compare на datatug.io: две копии Northwind, в правой изменены две цены, добавлена категория, удалён перевозчик и добавлен столбец. Ниже показан один перевозчик.

Команда

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

Вывод

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

Запущено с datatug 0.78.0, 2026-10-15, только на открытых учебных данных. О других базах, скорости и масштабе здесь ничего не утверждается.

Где плагин заканчивается. Пока.

В плагине есть навыки для install, init, projects, scan, validate и serve. Для compare, copy и export, query run и show навыков нет, поэтому агент запускает их в оболочке. Навык для каждой команды — дальнейшая задача, на неё сегодня рассчитывать нельзя.

Все навыки и их статусы