## data_source()


Create a data source from an engine, a pins board, or named frames.


Usage

``` python
data_source(
    *args,
    tables=None,
    exclude=None,
    dictionary=None,
    **frames,
)
```


A thin dispatcher over the constructors, which are the documented way in.

`tables`, `exclude`, and `dictionary` are keyword-only options, so all three names are reserved in every form: a frame passed under one of them is rejected with a TypeError naming it, never silently consumed. `tables` selects tables of the engine and board forms, `exclude` drops relations from a warehouse catalog listing by glob, and `dictionary` attaches a data dictionary to any form. To use one as a frame name, call [DataSource.from_frames()](DataSource.from_frames.md#commons.DataSource.from_frames) directly.

A dictionary's governed definitions are compiled for the source's dialect during construction, so construction raises if the dialect has no emitter (DuckDB, Snowflake, and Databricks have one), if a definition sits on a table the source does not expose, or if a metric mixes row and aggregate grain. On a warehouse the authored column spellings are bound to the names the catalog reported before anything is lowered, so it raises there only if a table declaring definitions matched no exposed relation, or if a definition names an authored column the selected relation does not have.

A Snowflake selection also imports the warehouse's semantic views, and a Databricks selection its metric views. Their public metrics become trusted calculations, which their dimensions can group and filter. A view named in `tables` is read and checked for access when the source is created, and raises if it cannot be used. A view a namespace selection reaches is listed when the source is created and read only when the agent first inspects or uses it. Naming relations exactly also imports, where it can, the views in the same schemas that read only those relations; their access is checked only when the agent uses one. Name a view in `tables` to be sure it is imported.
