Riferimento rapido

Foglio di riferimento Phoenix Ecto Migrations

Guida rapida di riferimento per le migrazioni Ecto in Phoenix: creazione tabelle, tipi di colonna, chiavi esterne, indici ed esecuzione SQL grezzo.

· Pubblicato

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;"

Riferimenti correlati

Argomenti correlati