Referencia rápida

Hoja de referencia de Phoenix Ecto Migrations

Guia rapida de referencia para migraciones Ecto en Phoenix: creacion de tablas, tipos de columna, claves foraneas, indices y ejecucion de SQL directo.

· Publicado

Ecto.Migration proporciona un DSL independiente de la base de datos para migraciones en Phoenix y Elixir.

Comandos CLI de migracion (CLI Migration Commands)

# Generar archivo de migracion
mix ecto.gen.migration add_status_to_orders

# Ejecutar migraciones pendientes
mix ecto.migrate

# Revertir la migracion mas reciente
mix ecto.rollback

# Verificar estado de migraciones
mix ecto.migrations

DSL de definicion de tablas (Table Definition DSL)

defmodule MyApp.Repo.Migrations.CreateDocuments do
  use Ecto.Migration

  def change do
    create table(:documents) do
      add :title, :string, size: 100, null: false
      add :body, :text
      add :price, :decimal, precision: 10, scale: 2
      add :views, :integer, default: 0
      add :active, :boolean, default: true, null: false
      add :metadata, :map # JSON / JSONB
      add :published_at, :utc_datetime

      # Referencia de clave foranea
      add :author_id, references(:users, on_delete: :delete_all), null: false

      # Agrega inserted_at y updated_at
      timestamps()
    end
  end
end

Modificar tablas existentes (alter)

alter table(:documents) do
  add :subtitle, :string
  modify :title, :string, size: 255
  remove :views
end

Indices y restricciones (Indices & Constraints)

# Indice unico
create unique_index(:users, [:email])

# Indice compuesto con creacion concurrente (PostgreSQL)
create index(:orders, [:user_id, :status], concurrently: true)

# Eliminar indice
drop index(:orders, [:status])

Ejecucion de SQL directo (Raw SQL)

# Ejecutar comandos SQL personalizados en la migracion
execute "CREATE EXTENSION IF NOT EXISTS citext;"

Referencias relacionadas

Temas relacionados