---
name: migration_down
kind: function
lang: go
domain: infra
version: "1.0.0"
purity: impure
signature: "func MigrationDown(db *sql.DB, n int) ([]Migration, error)"
description: "Revierte las ultimas n migraciones aplicadas ejecutando su down_sql guardado en la tabla _migrations. Las reversiones ocurren en orden inverso de version (la mas alta primero). Cada reversion corre en su propia transaccion. Retorna las migraciones revertidas."
tags: [migration, database, sql, schema, sqlite, rollback, down]
uses_functions: []
uses_types: [Migration_go_infra]
returns: [Migration_go_infra]
returns_optional: false
error_type: "error_go_core"
imports: ["database/sql", "fmt", "time"]
params:
  - name: db
    desc: "conexion *sql.DB abierta a la base de datos SQLite con la tabla _migrations"
  - name: "n"
    desc: "numero de migraciones a revertir (las ultimas n en orden descendente de version). Si n <= 0 no hace nada."
output: "slice de Migration con las migraciones que fueron revertidas (en orden descendente de version)"
tested: true
tests:
  - "revertir ultima migracion elimina registro y ejecuta down_sql"
  - "revertir n migraciones revierte en orden descendente"
  - "n cero no revierte nada"
  - "base de datos sin migraciones retorna slice vacio"
test_file_path: "functions/infra/migration_down_test.go"
file_path: "functions/infra/migration_down.go"
---

## Ejemplo

```go
db, _ := SQLiteOpen("", "apps/my_app/operations.db")
defer db.Close()

// Revertir la ultima migracion aplicada
reverted, err := MigrationDown(db, 1)
if err != nil {
    log.Fatalf("rollback failed: %v", err)
}
for _, m := range reverted {
    fmt.Printf("Reverted: %03d_%s\n", m.Version, m.Name)
}
// Reverted: 003_add_audit_log
```

## Notas

Usa el `down_sql` almacenado en `_migrations`, no el archivo en disco. Esto garantiza que el rollback funciona aunque el archivo haya sido modificado o eliminado. Si `down_sql` esta vacio, solo se elimina el registro de `_migrations` sin ejecutar SQL. ATENCION: `MigrationDown` es destructiva — un `DROP TABLE` en el down elimina datos. Diseñada para desarrollo y no para revertir en produccion con datos vivos.
