> For the complete documentation index, see [llms.txt](https://cmo-ci.gitbook.io/beagle-operators/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cmo-ci.gitbook.io/beagle-operators/beagle-internals/db-models.md).

# DB Models

All of the information necessary to store and query files and run information is represented in a postgres database, with a Django ORM API for querying for file information, and creating runs<br>

**File** - Represents a file existing either on either a local or remote file system<br>

**FileMetadata** - Represents arbitrary information associated with a File object. Stored in unstructured JSON format<br>

**Port** - Represents an input to or output from a pipeline. Used to link File objects to the inputs and outputs of Pipeline Runs. <br>

**Pipeline** - Stores the information related to a pipeline, the code for which is hosted in GitHub<br>

**Run** - Represents a run of a pipeline.&#x20;

\
**Operator** - Represents the logic / code that needs to be executed in order to build the inputs to a pipeline. This DB is linked to a python Class of type Operator, and this class implements the method get\_jobs() which will return a list of serialized job information objects.

## Schema Diagram

![](https://lh5.googleusercontent.com/prQxWeWyS4jHcBxspHceQyzz8NnXMazp09Hb15Zb7JyBGrYvV21p3En5txVWVWQYN0EJMi8iDU99uRnzRV_Ic_Vdc89IxcKevs8CJHwKSC3X4h5AXtgrjJ-HjmbO6oqZbaR4lXrh)
