Ecto.Migration fornisce un DSL indipendente dal database per creare ed eseguire migrazioni.
Comandi CLI di migrazione (CLI Migration Commands)
# Generare file di migrazione
mix ecto.gen.migration add_status_to_orders
# Eseguire migrazioni in sospeso
mix ecto.migrate
# Annullare l'ultimo passaggio di migrazione
mix ecto.rollback
# Verificare lo stato delle migrazioni
mix ecto.migrations
DSL di definizione della tabella (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
# Riferimento chiave esterna
add :author_id, references(:users, on_delete: :delete_all), null: false
# Aggiunge inserted_at e updated_at
timestamps()
end
end
end
Modificare tabelle esistenti (alter)
alter table(:documents) do
add :subtitle, :string
modify :title, :string, size: 255
remove :views
end
Indici e vincoli (Indices & Constraints)
# Indice univoco
create unique_index(:users, [:email])
# Indice composito con creazione concorrente (PostgreSQL)
create index(:orders, [:user_id, :status], concurrently: true)
# Rimuovere indice
drop index(:orders, [:status])
Esecuzione SQL grezzo (Raw SQL)
# Eseguire comandi SQL personalizzati nella migrazione
execute "CREATE EXTENSION IF NOT EXISTS citext;"