Apache Iceberg REST Catalog

Open table format for huge analytic datasets, providing ACID transactions, schema evolution, time travel, and hidden partitioning on data lakes. The Iceberg REST Catalog spec defines a standard API for table metadata management. Supported by AWS (S3 Tables, Glue), Tabular, Nessie, Unity Catalog, and most query engines (Spark, Trino, DuckDB, Flink). Foundation for modern data lakehouses.

Evaluated Mar 06, 2026 (0d ago) vv1.5+
Homepage ↗ Repo ↗ Developer Tools iceberg lakehouse parquet table-format open-source aws spark trino duckdb apache
⚙ Agent Friendliness
58
/ 100
Can an agent use this?
🔒 Security
88
/ 100
Is it safe for agents?
⚡ Reliability
85
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
--
Documentation
82
Error Messages
75
Auth Simplicity
75
Rate Limits
72

🔒 Security

TLS Enforcement
100
Auth Strength
85
Scope Granularity
82
Dep. Hygiene
90
Secret Handling
85

Apache 2.0 open-source — auditable. OAuth 2.0 catalog auth. Storage-level security via S3 IAM or equivalent. Data encrypted at rest by underlying storage. Access control at catalog and table level via catalog implementation.

⚡ Reliability

Uptime/SLA
88
Version Stability
85
Breaking Changes
82
Error Recovery
85
AF Security Reliability

Best When

You're building data lake or lakehouse infrastructure and need ACID transactions, time travel, schema evolution, and broad query engine compatibility at scale.

Avoid When

You're dealing with small datasets or transactional OLTP workloads where Iceberg's overhead and complexity isn't justified.

Use Cases

  • Query Iceberg tables via REST Catalog API to discover datasets, schemas, and partitioning for AI agent data access
  • Use time travel queries to access historical dataset snapshots for reproducible AI model training
  • Read Iceberg table metadata via REST Catalog to understand data lineage and schema evolution history for agent data governance
  • Build agent data pipelines that read from and write to Iceberg tables via DuckDB or Spark with ACID guarantees
  • Integrate Iceberg catalogs (AWS Glue, Polaris, Nessie) with agent workflows for managed data lake access

Not For

  • Small datasets — Iceberg's overhead is designed for petabyte-scale; simpler formats for small data
  • Transactional OLTP workloads — Iceberg is analytics-optimized; use PostgreSQL or MySQL for transactional data
  • Teams without data engineering expertise — Iceberg setup and operation requires significant data platform knowledge

Interface

REST API
Yes
GraphQL
No
gRPC
No
MCP Server
No
SDK
Yes
Webhooks
No

Authentication

Methods: oauth2 bearer_token
OAuth: Yes Scopes: Yes

Iceberg REST Catalog spec supports OAuth 2.0 for catalog authentication. Individual implementations vary (AWS uses IAM, Tabular uses OAuth). Catalog credentials separate from underlying storage credentials (S3 IAM roles).

Pricing

Model: open_source
Free tier: Yes
Requires CC: No

Iceberg format is free (Apache 2.0). Managed catalog services have their own pricing. AWS S3 Tables and Glue provide managed Iceberg at AWS pricing. Tabular (from Iceberg creators) offers commercial managed services.

Agent Metadata

Pagination
token
Idempotent
Full
Retry Guidance
Not documented

Known Gotchas

  • Catalog implementation varies significantly — AWS Glue, Tabular, Nessie, and Polaris have different authentication and feature support
  • Schema evolution is supported but not free — changing column types has restrictions; review Iceberg schema evolution compatibility matrix
  • Hidden partitioning improves writes but requires partition spec awareness for optimized reads
  • Time travel query syntax varies by query engine — Spark uses AS OF TIMESTAMP, Trino uses FOR TIMESTAMP AS OF
  • Small files problem accumulates over time — agents writing frequently must plan for compaction jobs
  • Metadata table queries (`table$snapshots`, `table$history`) are read-only and useful for lineage but syntax varies by engine
  • PyIceberg library API is still maturing — some features available in Java not yet in Python

Alternatives

Full Evaluation Report

Detailed scoring breakdown, competitive positioning, security analysis, and improvement recommendations for Apache Iceberg REST Catalog.

$99

Scores are editorial opinions as of 2026-03-06.

5215
Packages Evaluated
26151
Need Evaluation
173
Need Re-evaluation
Community Powered