Como você usa IA para escrever scripts de migração de dados e conversão de formato?

Question

Accepted Answer

IA é adequada para **conversões de formato** (CSV ↔ JSON ↔ SQL) e scripts de migração porque as regras de transformação são mecânicas. O truque é fornecer contexto suficiente para ser correto e seguro: esquemas, uma linha de amostra e requisitos de segurança explícitos.

## Como solicitar isso

- **Forneça o esquema de origem e de destino** — nomes de coluna, tipos, nullabilidade.
- **Inclua uma linha de amostra real** para que veja a forma real e os casos extremos (aspas, nulls, datas).
- **Exija que seja idempotente e validado** — executar novamente não deve duplicar ou corromper dados; linhas ruins devem ser capturadas, não inseridas silenciosamente.
- **Sempre execute uma simulação** em uma cópia dos dados antes de tocar na produção. Inspecione a saída primeiro.

## Exemplo: CSV → SQL inserts

```python
import csv

# Source CSV: id,email,signup_date  (signup_date may be blank)
# Target table: users(id INT, email TEXT NOT NULL, signup_date DATE NULL)
def csv_to_sql(path: str) -> list[str]:
    statements = []
    with open(path, newline="", encoding="utf-8") as f:
        for row in csv.DictReader(f):
            email = row["email"].strip()
            if not email:                      # validate: skip invalid rows, don't insert garbage
                continue
            date = row["signup_date"].strip() or None
            email_sql = email.replace("'", "''")   # escape quotes to avoid broken SQL / injection
            date_sql = f"'{date}'" if date else "NULL"
            # ON CONFLICT makes it idempotent: re-running won't create duplicates
            statements.append(
                f"INSERT INTO users (id, email, signup_date) "
                f"VALUES ({int(row['id'])}, '{email_sql}', {date_sql}) "
                f"ON CONFLICT (id) DO NOTHING;"
            )
    return statements
```

Os comentários marcam as partes que importam: **validação** (pule e-mails vazios), **escape** (aspas) e **idempotência** (`ON CONFLICT DO NOTHING`). Peça à IA para incluir todos os três — são as coisas que um script ingênuo esquece.

## Por que isso importa

Migrações de dados são de alto risco e geralmente uma operação única: um script que duplica ou descarta linhas pode ser caro desfazer. A IA acelera a escrita da conversão, mas as propriedades de segurança — idempotência, validação e uma execução simulada em uma cópia — são inegociáveis. Trate o script gerado como um rascunho que você deve ler e testar, nunca como algo a executar às cegas em dados reais.