Ecto.Adapter.Queryable.execute
execute
, go back to Ecto.Adapter.Queryable module for more information.
Specs
execute( adapter_meta(), query_meta(), query_cache(), params :: list(), options() ) :: {integer(), [[selected()]] | nil}
Executes a previously prepared query.
The query_meta
field is a map containing some of the fields
found in the Ecto.Query
struct, after they have been normalized.
For example, the values selected
by the query, which then have
to be returned, can be found in query_meta
.
The query_cache
and its state is documented in query_cache/0
.
The params
is the list of query parameters. For example, for
a query such as from Post, where: [id: ^123]
, params
will be
[123]
.
Finally, options
is a keyword list of options given to the
Repo
operation that triggered the adapter call. Any option is
allowed, as this is a mechanism to allow users of Ecto to customize
how the adapter behaves per operation.
It must return a tuple containing the number of entries and
the result set as a list of lists. The entries in the actual
list will depend on what has been selected by the query. The
result set may also be nil
, if no value is being selected.