Ecto.Migration fornece uma DSL independente de banco de dados para escrever e executar migracoes.
Comandos CLI de migração (CLI Migration Commands)
# Gerar novo arquivo de migracao
mix ecto.gen.migration add_status_to_orders
# Executar migracoes pendentes
mix ecto.migrate
# Reverter o passo de migracao mais recente
mix ecto.rollback
# Verificar status das migracoes
mix ecto.migrations
DSL de definição de tabelas (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 chave estrangeira
add :author_id, references(:users, on_delete: :delete_all), null: false
# Adiciona inserted_at e updated_at
timestamps()
end
end
end
Modificar tabelas existentes (alter)
alter table(:documents) do
add :subtitle, :string
modify :title, :string, size: 255
remove :views
end
Índices e restrições (Indices & Constraints)
# Indice unico
create unique_index(:users, [:email])
# Indice composto com criacao concorrente (PostgreSQL)
create index(:orders, [:user_id, :status], concurrently: true)
# Remover indice
drop index(:orders, [:status])
Execução de SQL bruto (Raw SQL)
# Executar comandos SQL customizados na migracao
execute "CREATE EXTENSION IF NOT EXISTS citext;"