Ecto.Adapter.Migration behaviour (Ecto SQL v3.7.1) View Source

Specifies the adapter migrations API.

Link to this section Summary

Types

adapter_meta()

command()

All migration commands

ddl_object()

A struct that represents a table or index in a database schema.

table_subcommand()

All commands allowed within the block passed to table/2

Callbacks

execute_ddl(adapter_meta, command, options)

Executes migration commands.

lock_for_migrations(adapter_meta, options, fun)

Locks the migrations table and emits the locked versions for callback execution.

supports_ddl_transaction?()

Checks if the adapter supports ddl transaction.

Link to this section Types

adapter_meta()

Specs

adapter_meta() :: Ecto.Adapter.adapter_meta()

command()

Specs

command() ::
  raw ::
  String.t()
  | {:create, Ecto.Migration.Table.t(), [table_subcommand()]}
  | {:create_if_not_exists, Ecto.Migration.Table.t(), [table_subcommand()]}
  | {:alter, Ecto.Migration.Table.t(), [table_subcommand()]}
  | {:drop, Ecto.Migration.Table.t(), :restrict | :cascade}
  | {:drop_if_exists, Ecto.Migration.Table.t(), :restrict | :cascade}
  | {:create, Ecto.Migration.Index.t()}
  | {:create_if_not_exists, Ecto.Migration.Index.t()}
  | {:drop, Ecto.Migration.Index.t(), :restrict | :cascade}
  | {:drop_if_exists, Ecto.Migration.Index.t(), :restrict | :cascade}

All migration commands

ddl_object()

Specs

ddl_object() :: Ecto.Migration.Table.t() | Ecto.Migration.Index.t()

A struct that represents a table or index in a database schema.

These database objects can be modified through the use of a Data Definition Language, hence the name DDL object.

table_subcommand()

Specs

table_subcommand() ::
  {:add, field :: atom(),
   type :: Ecto.Type.t() | Ecto.Migration.Reference.t() | binary(), Keyword.t()}
  | {:add_if_not_exists, field :: atom(),
     type :: Ecto.Type.t() | Ecto.Migration.Reference.t() | binary(),
     Keyword.t()}
  | {:modify, field :: atom(),
     type :: Ecto.Type.t() | Ecto.Migration.Reference.t() | binary(),
     Keyword.t()}
  | {:remove, field :: atom(),
     type :: Ecto.Type.t() | Ecto.Migration.Reference.t() | binary(),
     Keyword.t()}
  | {:remove, field :: atom()}
  | {:remove_if_exists,
     type :: Ecto.Type.t() | Ecto.Migration.Reference.t() | binary()}

All commands allowed within the block passed to table/2

Link to this section Callbacks

execute_ddl(adapter_meta, command, options)

Specs

execute_ddl(adapter_meta(), command(), options :: Keyword.t()) ::
  {:ok, [{Logger.level(), Logger.message(), Logger.metadata()}]}

Executes migration commands.

lock_for_migrations(adapter_meta, options, fun)

Specs

lock_for_migrations(adapter_meta(), options :: Keyword.t(), fun) :: result
when fun: (() -> result), result: var

Locks the migrations table and emits the locked versions for callback execution.

It returns the result of calling the given function with a list of versions.

supports_ddl_transaction?()

Specs

supports_ddl_transaction?() :: boolean()

Checks if the adapter supports ddl transaction.