---
name: sqlite_apply_migrations
kind: function
lang: go
domain: infra
version: "1.0.0"
purity: impure
signature: "func ApplyMigrations(conn *sql.DB, fsys fs.FS, glob string) error"
description: "Aplica migraciones SQL desde un fs.FS en orden lexicografico. Lee archivos con glob (default 'migrations/*.sql'), divide por sentencias y ejecuta cada una contra conn. Errores idempotentes (duplicate column, already exists) se ignoran."
tags: [database, sqlite, migration, schema, embed, fs]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: ["database/sql", "fmt", "io/fs", "sort", "strings"]
params:
  - name: conn
    desc: "conexion *sql.DB donde se ejecutan las migraciones"
  - name: fsys
    desc: "sistema de archivos con los .sql (tipicamente embed.FS del caller)"
  - name: glob
    desc: "patron glob para seleccionar archivos (vacio = 'migrations/*.sql')"
output: "nil si todas las migraciones se aplicaron correctamente; error del primer fallo no idempotente con nombre de archivo incluido"
tested: true
tests:
  - "una migracion se aplica correctamente"
  - "multiples migraciones en orden"
  - "error real se propaga"
  - "ALTER TABLE ADD COLUMN duplicado se ignora"
test_file_path: "functions/infra/sqlite_apply_migrations_test.go"
file_path: "functions/infra/sqlite_apply_migrations.go"
---

## Ejemplo

```go
//go:embed migrations/*.sql
var migrationsFS embed.FS

func openDB(path string) (*sql.DB, error) {
    db, err := infra.SQLiteOpen(path, "")
    if err != nil {
        return nil, err
    }
    if err := infra.ApplyMigrations(db, migrationsFS, ""); err != nil {
        db.Close()
        return nil, fmt.Errorf("migrate: %w", err)
    }
    return db, nil
}
```

## Notas

Extraido de apps/kanban/backend/db.go. El parser de sentencias SQL es intencionalmente simple: separa por `;` al final de una linea (ignorando comentarios `--` y lineas vacias). Esta logica falla si el SQL contiene un `;` dentro de un string literal al final de linea — evitar ese patron en los archivos de migracion.

Los errores idempotentes (`duplicate column`, `already exists`) se ignoran para que las migraciones sean re-ejecutables contra DBs que ya tenian parte del schema. Esto permite un flujo sin tabla `_migrations` para proyectos pequenos; para proyectos con muchas migraciones y rollback, usar `migration_up_go_infra` / `migration_down_go_infra`.