---
title: "HeldArtefact"
description: "the value of the parameter the artefacts on this machine: one lake, catalogue or folder of files still outside the one lakehouse, read in place until its tables are mapped in, with the name the engine opens it under, the registered source its tables derive from, its path, the program that made it and the repository…"
section: concepts
address: /concepts/heldartefact
contract: 0476e35e6e275db5
---

# HeldArtefact

the value of the parameter the artefacts on this machine: one lake, catalogue or folder of files still outside the one lakehouse, read in place until its tables are mapped in, with the name the engine opens it under, the registered source its tables derive from, its path, the program that made it and the repository…

[figure: HeldArtefact is a value at none scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | value |
| scope | none |
| key | none |
| store | none |
| family | sources |



## Fields


| field | type | required | note |
|---|---|---|---|
| `name` | `text` | yes | one word the engine opens it under, which an SQL statement names it by |
| `source` | `id` | yes | the registered source its tables derive from |
| `path` | `text` | yes | the file or folder on this machine |
| `generator` | `text` | yes | the program that made it, as its own row names it |
| `repository` | `text` | no | the repository whose commit at the reading is appended to the generator; absent when the generator names its commit itself |



## Routes that use it
No route takes or returns HeldArtefact directly. The record holds it, and the objects that point at it reach it.