# Table Catalog

> A list that tells tools where each lake table is right now.

**Field:** Data Engineering  
**Category:** Storage & Warehousing  
**Also known as:** Iceberg Catalog, Iceberg REST Catalog, Lakehouse Catalog, Metastore

## Think of it like

It is like the sign by a lift that says which floor each shop is on. Every visitor reads the same sign.

## Definition

A table catalog is the service that lets query engines find the tables in a data lake. It keeps the list of table names. For each one, it points at the file that describes the table right now. When a write changes a table, that pointer is swapped in one step. So every engine, from Spark to Trino, sees the same version. Hive Metastore, Unity Catalog and the Iceberg REST catalog are all examples.

## Example

Spark writes an orders table and Trino reads it. Both ask the same Iceberg REST catalog, so both see the new rows at the same moment.

## Why it matters

Without one shared catalog, each engine keeps its own idea of a table. Then two tools give two answers.

## Common mistake

Confusing it with a data catalog. One is for engines, and the other helps people find data.

## Three principles

- **Names to files.** Points each table at its current state.
- **One swap.** A change lands all at once.
- **Shared by engines.** Spark, Trino and others agree.

## Related terms

- [Open Table Format](https://learn.benibix.com/term/data/open-table-format)
- [Apache Iceberg](https://learn.benibix.com/term/data/apache-iceberg)
- [Hive Metastore (HMS)](https://learn.benibix.com/term/data/hive-metastore)
- [Unity Catalog](https://learn.benibix.com/term/data/unity-catalog)
- [AWS Glue](https://learn.benibix.com/term/data/aws-glue)
- [Data Catalog](https://learn.benibix.com/term/data/data-catalog)
- [Trino](https://learn.benibix.com/term/data/trino)

## Told apart from

- [Table Catalog vs Data Catalog](https://learn.benibix.com/compare/table-catalog-vs-data-catalog): People think a table catalog and a data catalog are the same thing, and they are not. A table catalog is for query engines. It tells Spark or Trino where each lake table lives right now. A data catalog is for people. It is a search page that says what a table means and who owns it. Some products do a bit of both.

![Spark, which writes, and Trino, which reads, both point down to a highlighted table catalog that says orders is now version 3. From the catalog, a solid arrow leads to orders version 3 with the new rows, and a dashed line to the old version 2. A note says a write swaps the pointer in one step, so both engines see version 3.](https://learn.benibix.com/diagrams/dat3-table-catalog.svg)

---

Source: https://learn.benibix.com/term/data/table-catalog
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
