Come usi l'AI per scrivere script di migrazione dati e conversione di formato?

Question

Accepted Answer

L'AI è particolarmente adatta alle **conversioni di formato** (CSV ↔ JSON ↔ SQL) e agli script di migrazione perché le regole di trasformazione sono meccaniche. Il trucco è fornirle abbastanza contesto per essere corretti e sicuri: schemi, una riga di esempio e requisiti di sicurezza espliciti.

## Come formulare il prompt

- **Fornisci lo schema di origine e destinazione** — nomi delle colonne, tipi, nullabilità.
- **Includi una riga di esempio reale** in modo che veda la forma effettiva e i casi limite (virgolette, null, date).
- **Richiedi che sia idempotente e validato** — rieseguirlo non dovrebbe duplicare o corrompere i dati; le righe errate dovrebbero essere rilevate, non inserite silenziosamente.
- **Esegui sempre un dry-run su una copia** dei dati prima di toccare la produzione. Ispeziona l'output per primo.

## Esempio: 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
```

I commenti segnano le parti importanti: **validazione** (salta email vuote), **escaping** (virgolette) e **idempotenza** (`ON CONFLICT DO NOTHING`). Chiedi all'AI di includere tutti e tre — sono le cose che uno script ingenuo dimentica.

## Perché è importante

Le migrazioni di dati sono ad alto rischio e spesso monouso: uno script che inserisce duplicati o elimina righe può essere costoso da annullare. L'AI accelera la scrittura della conversione, ma le proprietà di sicurezza — idempotenza, validazione e un dry-run su una copia — sono non negoziabili. Tratta lo script generato come una bozza che devi leggere e testare, mai come qualcosa da eseguire alla cieca su dati reali.