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에서.

datatug.io에서 compare 실행 시 나온 JSON: 두 개의 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에는 스킬이 없으므로 에이전트는 셸에서 실행합니다. 각각에 대한 스킬은 후속 작업이며 오늘 의존할 수 있는 것이 아닙니다.

모든 스킬과 상태 보기

에이전트가 실행할 수 있는 명령어 스킬 유무와 관계없이.

두 데이터베이스 비교

날짜 열이 없는 테이블 백업, 복원 및 이동

쿼리 실행, 행 반환

데이터베이스 구조 읽기