Pular para o conteúdo
DataTug.ai
GitHub

← As três formas de usar o DataTug com IA

Comandos da CLI

Comandos que seu agente pode executar com ou sem uma skill.

Um agente de código de IA pode executar qualquer comando datatug em um shell. Estes são os que vale a pena conhecer: cada um foi executado em dados de exemplo públicos, e cada um tem saída real em datatug.io.

Quatro coisas que agentes pedem.

O que cada comando faz, como um agente lê o resultado e se o plugin tem uma skill para ele hoje.

  • datatug compareDisponível

    Compare dois bancos de dados

    Lê o esquema e cada linha de duas cópias de um banco de dados e relata o que foi adicionado, removido ou alterado.

    Adicione --json: um único documento com um resumo, as mudanças de esquema e um registro de cada diferença. O status de saída é 0 mesmo quando os bancos diferem, então o agente lê o resumo para decidir.

    Sem skill aindaLeia a página com saída real

  • datatug db copy · datatug db exportDisponível

    Faça backup, restaure e mova tabelas sem colunas de data

    Copia tabelas entre bancos de dados, ou exporta um banco para arquivos simples que pertencem ao Git. Compare o resultado com a origem para provar.

    Eles imprimem progresso e erros em stderr e não têm --json hoje. Termine com datatug compare --json para um veredito que o agente pode ler. Datas e chaves estrangeiras têm limites conhecidos, listados na página.

    Sem skill aindaLeia a página com saída real

  • datatug query runDisponível

    Execute uma consulta, receba linhas de volta

    Executa uma consulta contra uma URL de banco de dados e imprime as linhas como JSON, JSONL, CSV ou YAML em stdout. Políticas de acesso se aplicam, a menos que sejam desativadas.

    Use --format json e leia stdout. As políticas que se aplicaram são relatadas em stderr, então o agente vê o que foi retido.

    Sem skill aindaLeia a página com saída real

  • datatug scan · datatug showDisponível

    Leia a estrutura de um banco de dados

    Escaneia um banco de dados para um projeto DataTug e então imprime seus esquemas, tabelas, colunas e chaves primárias.

    datatug show --format json imprime a mesma listagem como um único documento JSON; a forma texto é estável, então duas execuções podem ser comparadas.

    Scan tem skill; show nãoLeia a página com saída real

O que um agente lê do compare.

O JSON da execução do compare em datatug.io: duas cópias do Northwind, e na cópia à direita dois preços alterados, uma categoria adicionada, uma transportadora excluída e uma coluna adicionada. Uma transportadora é mostrada abaixo.

O 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

A saída

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

Executado com datatug 0.78.0 em 2026-10-15, apenas em dados de exemplo públicos. Declarações sobre outros bancos de dados, velocidade e escala não são feitas aqui.

Onde o plugin para. Por enquanto.

O plugin tem skills para install, init, projects, scan, validate e serve. Compare, copy e export, query run e show não têm skill, então um agente os executa em um shell. Uma skill para cada um é um acompanhamento, não algo para confiar hoje.

Veja todas as skills e seu status