Перейти до вмісту
DataTug.ai
GitHub

← Три способи використовувати DataTug з AI

Команди CLI

Команди, які ваш агент може виконувати з навичкою або без неї.

Агент програмування AI може виконувати будь-яку команду datatug у оболонці. Ось ті, які варто знати: кожна була виконана на публічних тестових даних, і кожна має реальний вивід на datatug.io.

Чотири речі, які просять агенти.

Що робить кожна команда, як агент читає результат і чи має плагін навичку для неї сьогодні.

  • datatug compareДоступно

    Порівняйте дві бази даних

    Зчитує схему та кожен рядок двох копій бази даних і повідомляє, що було додано, видалено або змінено.

    Додайте --json: один документ із підсумком, змінами схеми та записом кожної відмінності. Код виходу — 0, навіть якщо бази даних відрізняються, тому агент читає підсумок, щоб вирішити.

    Ще немає навичкиПереглянути сторінку з реальним виводом

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

    Створюйте резервні копії, відновлюйте та переміщуйте таблиці без стовпців дати

    Копіює таблиці між базами даних або експортує базу даних у прості файли, які належать Git. Порівняйте результат із джерелом, щоб довести це.

    Вони виводять прогрес і помилки в stderr і не мають --json сьогодні. Завершіть datatug compare --json, щоб отримати вердикт, який агент може прочитати. Дати та зовнішні ключі мають відомі обмеження, перелічені на сторінці.

    Ще немає навичкиПереглянути сторінку з реальним виводом

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

    Виконайте запит, отримайте рядки

    Виконує запит до URL бази даних і виводить рядки як JSON, JSONL, CSV або YAML у stdout. Застосовуються політики доступу, якщо їх не вимкнено.

    Використовуйте --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 не мають навички, тому агент виконує їх в оболонці. Навичка для кожного — це наступний крок, а не те, на що можна покластися сьогодні.

Переглянути всі навички та їхній статус