---
title: "CatalogueEntry"
description: "the only way to read a file of the lakehouse"
section: concepts
address: /concepts/catalogueentry
contract: 0476e35e6e275db5
---

# CatalogueEntry

the only way to read a file of the lakehouse

[figure: CatalogueEntry is a definition at follows scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | definition |
| scope | follows |
| key | the layer, the plane, the source, the day and the version |
| store | postgres |
| family | record |



## Fields


| field | type | required | note |
|---|---|---|---|
| `layer` | `one of as landed \| refined \| ready to use` | yes |  |
| `plane` | [Plane](/concepts/plane) | yes |  |
| `source` | [Source](/concepts/source) | no |  |
| `day` | `date` | no | required only when the table is split by day |
| `files` | [LakeFile](/concepts/lakefile) | yes |  |
| `rows` | `count` | yes |  |
| `made_from` | `[id]` | yes |  |
| `table` | [SilverTable](/concepts/silvertable) | yes |  |
| `bucket` | `count` | no | for a table split by entity bucket |
| `snapshot` | `count` | yes | the lakehouse catalogue's snapshot that is this entry |
| `version` | `count` | yes | the partition's version, from the entry's key |
| `hash` | `hash` | no | the hash of the partition's rows, as the closed partition carries it; the commit carries it |



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