egutierrez
47fac22230
- .claude/CLAUDE.md - .claude/commands/subagentes.md - .claude/rules/INDEX.md - .mcp.json - bash/functions/cybersecurity/analyze_dns.md - bash/functions/cybersecurity/audit_http_headers.md - bash/functions/cybersecurity/audit_ssh_config.md - bash/functions/cybersecurity/check_firewall.md - bash/functions/cybersecurity/detect_suspicious_users.md - bash/functions/cybersecurity/encrypt_file.md - ... Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
53 lines
2.1 KiB
Markdown
53 lines
2.1 KiB
Markdown
---
|
|
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, pendiente-usar]
|
|
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.
|