Packages
ecto
2.2.9
3.14.1
3.14.0
3.13.6
3.13.5
3.13.4
3.13.3
3.13.2
3.13.1
3.13.0
3.12.6
3.12.5
3.12.4
3.12.3
3.12.2
3.12.1
3.12.0
3.11.2
3.11.1
3.11.0
3.10.3
3.10.2
3.10.1
3.10.0
3.9.6
3.9.5
3.9.4
3.9.3
3.9.2
3.9.1
3.9.0
3.8.4
3.8.3
3.8.2
3.8.1
3.8.0
3.7.2
3.7.1
3.7.0
3.6.2
3.6.1
3.6.0
3.5.8
3.5.7
3.5.6
3.5.5
3.5.4
3.5.3
3.5.2
3.5.1
3.5.0
3.5.0-rc.1
3.5.0-rc.0
3.4.6
3.4.5
3.4.4
3.4.3
3.4.2
3.4.1
3.4.0
3.3.4
3.3.3
3.3.2
3.3.1
3.3.0
3.2.5
3.2.4
3.2.3
3.2.2
3.2.1
3.2.0
3.1.7
3.1.6
3.1.5
3.1.4
3.1.3
3.1.2
3.1.1
3.1.0
3.0.9
3.0.8
3.0.7
3.0.6
3.0.5
3.0.4
3.0.3
3.0.2
3.0.1
3.0.0
3.0.0-rc.1
3.0.0-rc.0
2.2.12
2.2.11
2.2.10
2.2.9
2.2.8
2.2.7
2.2.6
2.2.5
2.2.4
2.2.3
2.2.2
2.2.1
2.2.0
2.2.0-rc.1
2.2.0-rc.0
2.1.6
2.1.5
2.1.4
2.1.3
2.1.2
2.1.1
2.1.0
2.1.0-rc.5
2.1.0-rc.4
2.1.0-rc.3
2.1.0-rc.2
2.1.0-rc.1
2.1.0-rc.0
2.0.6
2.0.5
2.0.4
2.0.3
2.0.2
2.0.1
2.0.0
2.0.0-rc.6
2.0.0-rc.5
2.0.0-rc.4
2.0.0-rc.3
2.0.0-rc.2
2.0.0-rc.1
2.0.0-rc.0
2.0.0-beta.2
2.0.0-beta.1
2.0.0-beta.0
1.1.9
1.1.8
1.1.7
1.1.6
1.1.5
1.1.4
1.1.3
1.1.2
1.1.1
1.1.0
1.0.7
1.0.6
1.0.5
1.0.4
1.0.3
1.0.2
1.0.1
1.0.0
0.16.0
0.15.0
0.14.3
0.14.2
0.14.1
0.14.0
0.13.1
0.13.0
0.12.1
0.12.0
0.12.0-rc
0.11.3
0.11.2
0.11.1
0.11.0
0.10.3
0.10.2
0.10.1
0.10.0
0.9.0
0.8.1
0.8.0
0.7.2
0.7.1
0.7.0
0.6.0
0.5.1
0.5.0
0.4.0
0.3.0
0.2.8
0.2.7
0.2.6
0.2.5
0.2.4
0.2.3
0.2.2
0.2.1
0.2.0
0.1.0
A toolkit for data mapping and language integrated query for Elixir
Current section
Files
Jump to
Current section
Files
CHANGELOG.md
# Changelog for v2.2
## Highlights
This release adds many improvements to Ecto with a handful of bug fixes. We recommend reading the full list of enhancements below. Here are some of the highlights.
Ecto now supports specifying fields sources. This is useful when you use a database with non-conventional names, such as uppercase letters or names with hyphens:
field :name, :string, source: :NAME
field :user_name, :string, source: :"user-name"
The source option can be specified programatically by given a function to `@field_source_mapper` that receives the field name as an atom and returns the source name as an atom.
On the migrations side, `execute/2` function was added, which allows developers to describe up and down commands inside the `change` callback:
def change do
execute "CREATE EXTENSION citext",
"DROP EXTENSION citext"
end
The `ecto.migrate` and `ecto.rollback` tasks have also been enhanced with the `--log-sql` option which is helpful when debugging errors or during deployments to keep track of your production database changes.
Ecto now will also warn at compile time of invalid relationships, such as a belongs_to that points to a schema that does not exist.
The query syntax also seen some improvements: map updates are supported in subqueries, the new `Ecto.Query.select_merge/3` makes it easier to write composable `select` clauses in queries and the `type/2` macro has been extended to support casting of fragments and fields in schemaless queries.
Finally, the UPSERT support added on Ecto v2.1 is getting more improvements: the `{:constraint, constraint}` is now supported as conflict target and the `:returning` option was added to `Ecto.Repo.insert/2`, mirroring the behaviour of `insert_all`.
## v2.2.9 (2018-03-09)
### Enhancements
* [Ecto.Adapters.MySQL] Raise clearer error when using where in on_conflict with MySQL
* [Ecto.Adapters.SQL] Document after_connect callbacks
* [Ecto.Repo] Improve docs for assoc with on_conflict
* [Ecto.Schema] Promote using :jsonb for Postgres for :embeds_many
### Bug fixes
* [Ecto.Adapters.MySQL] Do not crash ecto.create/drop on log: false with mysql
* [Ecto.Adepters.Postgres] Prepend the schema "public" when referring to the schema_migrations table on ecto.dump
* [Ecto.Type] Do not raise when casting integer to NaiveDateTime
## v2.2.8 (2018-01-13)
### Enhancements
* [Ecto.Repo] Allow `ssl`, `timeout`, `pool_timeout` and `pool_size` to be given as URL parameter
### Bug fixes
* [Ecto.Adapters.MySQL] Fix out of order parameters when issuing an update_all with join in MySQL
* [Ecto.Query] Fix a bug when a parameterized query is given as argument to join
* [Ecto.Query] Ensure a list of fields given to `select_merge: [...]` appends to the list of fields previously given in the select
* [Ecto.Query] Ensure fields loaded via `select_merge` are available during preloading
* [Ecto.Query] Show better error message on ambiguity between query and assoc on `:preload`
* [Ecto.Query] Allow virtual fields to be updated in subqueries
* [Ecto.Repo] Mark schemas returned from subqueries as loaded
## v2.2.7 (2017-12-03)
### Bug fixes
* [Ecto.Repo] Do not surface embeds if repo operation fails
* [Ecto.Schema] Raise if updating with struct on on_replace: :update
## v2.2.6 (2017-09-30)
### Bug fixes
* [Ecto.Adapters.Postgres] Properly interpolate parameters when `in` is used in query
## v2.2.5 (2017-09-29)
### Enhancements
* [Ecto.Changeset] Support `:prefix` on `unsafe_validate_unique`
* [Ecto.Migration] Support for `ON DELETE RESTRICT` and `ON UPDATE RESTRICT` in migrations
* [Ecto.Query] Fix params counter when using `in` in some places in query
* [Ecto.Schema] Properly support `on_replace: :update` on `belongs_to`/`has_one`
* [Ecto.Type] Allow casting Date from NaiveDateTime ISO
### Bug fixes
* [Ecto.Repo] Do not surface embeds if repo operation fails
* [Mix.Tasks.Ecto.Migrate] Only keep logger backends when running migrations
## v2.2.4 (2017-09-15)
### Bug fixes
* [Ecto.Query] Ensure recursive macros in `select` are correctly expanded
## v2.2.3 (2017-09-12)
### Bug fixes
* [Ecto.Repo] Ensure preloads work when the first associated entry is nil
## v2.2.2 (2017-09-09)
### Enhancements
* [Ecto.Changeset] Allow validation of codepoint count in validate_length
* [Ecto.Query] Support `prefix` in subqueries
### Bug fixes
* [Ecto.Adapters] Properly alias table names starting with numbers
* [Ecto.Adapters.Postgres] Make sure type/2 with integer/id types are tagged as bigint in Posgres
* [Ecto.Changeset] Properly validate `has_many`/`many_to_many` associations on `validate_length/3` when entries are being deleted/replaced
* [Ecto.Migration] Set foreign key type to the same type as the primary key in the repository configuration
* [Ecto.Repo] Do not attempt to preload `has_one`/`belongs_to` associations already loaded as nil
* [Ecto.Schema] Do not attempt to validate associations if the associated module is in context
* [Ecto.Schema] Bring back `__schema__(:types)` for backwards compatibility
## v2.2.1 (2017-08-27)
### Bug fixes
* [Ecto.Changeset] Do not raise when an empty association is given to a field that has an association already stored in the struct
* [Ecto.Repo] Do not lookup nil values in `get_by`
## v2.2.0 (2017-08-22)
### Enhancements
* [Ecto.Adapters] Accept IO data from adapters to reduce memory usage when performing large queries
* [Ecto.Adapters.SQL] Also add `Ecto.Repo.to_sql/2` to Ecto.Repo based on SQL adapters
* [Ecto.Adapters.Postgres] Use the "postgres" database for create/drop database commands
* [Ecto.Adapters.MySQL] Use TCP connections instead of MySQL command client to create & drop database
* [Ecto.Changeset] Support `action: :ignore` in changeset which is useful when casting associations and embeds and one or more children need to be rejected/ignored under certain circumstances
* [Ecto.Changeset] Add `:repo_opts` field to `Ecto.Changeset` which are given as options to to the repository whenever an operation is performed
* [Ecto.Changeset] Add `unsafe_validate_unique/3` which validates uniqueness for faster feedback cycles but without data-integrity guarantees
* [Ecto.Changeset] Add `apply_action/2`
* [Ecto.Changeset] Add prefix constraint name checking to constraint validations
* [Ecto.Changeset] Allow assocs and embeds in `change/2` and `put_change/3` - this gives a more generic API for developers to work that does not require explicit knowledge of the field type
* [Ecto.Migration] Add reversible `execute/2` to migrations
* [Ecto.Migration] Add `:migration_timestamps` and `:migration_primary_key` to control the migration defaults from the repository
* [Ecto.Migrator] Allow migration/rollback to log SQL commands via the `--log-sql` flag
* [Ecto.LogEntry] Add `:caller_pid` to the Ecto.LogEntry struct
* [Ecto.Query] Allow map updates in subqueries
* [Ecto.Query] Support fragment, aggregates and field access in `type/2` in select
* [Ecto.Query] Add `select_merge/3` as a composable API for selects
* [Ecto.Repo] Implement `:returning` option on insert
* [Ecto.Repo] Add ON CONSTRAINT support to `:conflict_target` on `insert` and `insert_all`
* [Ecto.Repo] Raise `MultiplePrimaryKeyError` when primary key is not unique on DB side
* [Ecto.Schema] Validate schemas after compilation - this helps developers catch early mistakes such as foreign key mismatches early on
* [Ecto.Schema] Support the `:source` option in the `field/3` macro which configures the column/field name in the data storage
* [Ecto.Schema] Support `@field_source_mapper` in `Ecto.Schema` as a mechanism to programatically set the `:source` option
* [Ecto.Type] Allow adapters to pass Date, Time, NaiveDateTime and DateTime on load if desired
* [Ecto.UUID] Allow casting binary UUIDs
* [mix ecto.drop] Add `--force`
* [mix ecto.load] Add `--force` and prompt user to confirm before continuing in production
### Bug fixes
* [Ecto.Changeset] Remove the field from changes if it does not pass `validate_required`
* [Ecto.Changeset] Raise if changeset struct does not match relation
* [Ecto.Query] Consistently raise if `nil` is interpolated on the right side of `in`
* [Ecto.Query] Properly expand macros in `select`
* [Ecto.Query] Support `or_having` in keyword query
* [Ecto.Query] Properly count the parameters when using interpolation inside a `select` inside a `subquery`
* [Ecto.Query] Properly `select` expressions in subquery (for example, `{p.field}` doesn't make sense as a subquery return but it was silently accepted in the past)
* [Ecto.Repo] Set struct prefix on `insert`, `delete`, and `update` when the prefix is given as an option
* [Ecto.UUID] Validate UUID version on casting
* [mix ecto.*] Make sure `Logger` is rebootted when running ecto tasks
* [mix ecto.*] No longer mark tasks as recursive and instead collect all repositories upfront. This fixes a bug where migration and rollback commands for a given repository could be executed multiple times from an umbrella project
### Deprecations
* [Ecto.DateTime] `Ecto.DateTime` as well as `Ecto.Date` and `Ecto.Time` are deprecated in favor of `:naive_datetime`, `:date` and `:time` respectively
* [Ecto.Repo] Using `{:system, env}` to configure the repository URL is deprecated in favor of a custom init/2 callback
## Previous versions
* See the CHANGELOG.md [in the v2.1 branch](https://github.com/elixir-ecto/ecto/blob/v2.1/CHANGELOG.md)