View Source Needle.Tables (needle v0.8.0)
A Global cache of Tables to be queried by their (Pointer) IDs, table names or Ecto Schema module names.
Use of the Table Service requires:
- You have run the migrations shipped with this library.
- You have started
Needle.Tablesbefore querying. - All OTP applications with pointable Ecto Schemata to be added to the schema path.
- OTP 21.2 or greater, though we recommend using the most recent release available.
While this module is a GenServer, it is only responsible for setup of the cache and then exits with :ignore having done so. It is not recommended to restart the service as this will lead to a stop the world garbage collection of all processes and the copying of the entire cache to each process that has queried it since its last local garbage collection.
Summary
Types
A query is either a table's (database) name or (Pointer) ID as a binary or the name of its Ecto Schema Module as an atom.
Functions
Returns a specification to start this module under a supervisor.
Look up a table id by id, name or schema.
Look up a table id by id, name or schema, raise NotFound if not found.
Look up many ids at once, raise NotFound if any of them are not found
Look up a schema module by id, name or schema
Look up a schema module by id, name or schema, raise NotFound if not found
Populates the global cache with table data via introspection.
Get a Table identified by name, id or module.
Look up a Table by name or id, raise NotFound if not found.
Types
A query is either a table's (database) name or (Pointer) ID as a binary or the name of its Ecto Schema Module as an atom.
Functions
Returns a specification to start this module under a supervisor.
See Supervisor.
@spec id(query()) :: {:ok, integer()} | {:error, Needle.NotFound.t()}
Look up a table id by id, name or schema.
Look up a table id by id, name or schema, raise NotFound if not found.
Look up many ids at once, raise NotFound if any of them are not found
@spec schema(query()) :: {:ok, atom()} | {:error, Needle.NotFound.t()}
Look up a schema module by id, name or schema
Look up a schema module by id, name or schema, raise NotFound if not found
@spec start_link(ignored :: term()) :: GenServer.on_start()
Populates the global cache with table data via introspection.
@spec table(query :: query()) :: {:ok, Needle.Table.t()} | {:error, Needle.NotFound.t()}
Get a Table identified by name, id or module.
@spec table!(query()) :: Needle.Table.t()
Look up a Table by name or id, raise NotFound if not found.