# databricks-iceberg

databricks-iceberg — a skill for creating and managing Apache Iceberg tables on Databricks, syncing Delta with Iceberg via UniForm, and exposing tables to external engines through REST Catalog.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 327 installs · ★ 408 repo stars
- Author: databricks
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/databricks/databricks-agent-skills/tree/HEAD/skills/databricks-iceberg/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/databricks-iceberg

## What it does

The skill teaches the agent three core patterns: managed Iceberg tables that read and write as Iceberg everywhere; Delta tables with UniForm, which write as Delta in Databricks but read as Iceberg externally; and the Iceberg REST Catalog, which exposes UC tables to external engines (PyIceberg, Spark, Snowflake, Flink) over REST.

It embeds critical rules that prevent data corruption: do not install Iceberg libraries into DBR (version conflicts), do not manually manage metadata paths, choose between `PARTITIONED BY` and `CLUSTER BY` correctly, disable deletion vectors on v2 with clustering. The skill teaches which pattern fits each use case and how to set up external engine access with credential vending.

Requires Unity Catalog and Databricks CLI (≥ v1.0.0). Compatible across all listed platforms, but primary commands are SQL DDL/DML.

## Requirements
- Works with: Databricks, Snowflake

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add databricks/databricks-agent-skills --skill databricks-iceberg -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/databricks-iceberg/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/databricks-iceberg/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add databricks/databricks-agent-skills --skill databricks-iceberg -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/databricks-iceberg/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add databricks/databricks-agent-skills --skill databricks-iceberg -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/databricks-iceberg/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install databricks/databricks-agent-skills skills/databricks-iceberg
```

2. **Manually: put the files in place**
- File: `.github/skills/databricks-iceberg/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add databricks/databricks-agent-skills --skill databricks-iceberg -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/databricks/databricks-agent-skills --path skills/databricks-iceberg
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/databricks-iceberg/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add databricks/databricks-agent-skills --skill databricks-iceberg -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/databricks/databricks-agent-skills/tree/HEAD/skills/databricks-iceberg/SKILL.md

## When to use it
- create an Iceberg table with correct partitioning for external engine access
- enable reading Delta tables as Iceberg without rewriting data
- configure REST Catalog so PyIceberg or Spark can read UC tables
- integrate Snowflake with Databricks through Iceberg catalog
- prevent version conflicts and metadata corruption when working with Iceberg

## Example prompts
- Create a managed Iceberg table from raw_events, partitioned by event_date
- Enable External Iceberg Reads on my existing customers Delta table via UniForm
- Set up external access to my tables through the Iceberg REST Catalog for a PyIceberg client

## Similar
- [databricks-2025](https://affpapa.org/en/nevibecode/skills/databricks-2025.md) — skill · 168 installs
- [sql-queries](https://affpapa.org/en/nevibecode/skills/sql-queries.md) — skill · 4700 installs
- [migrating-dbt-project-across-platforms](https://affpapa.org/en/nevibecode/skills/migrating-dbt-project-across-platforms.md) — skill · 531 installs
- [databricks](https://affpapa.org/en/nevibecode/rules/databricks.md) — rule · ★ 3589 repo stars
- [data-engineering-patterns-fabric-databricks](https://affpapa.org/en/nevibecode/skills/data-engineering-patterns-fabric-databricks.md) — skill · 1600 installs
- [databricks-expert](https://affpapa.org/en/nevibecode/skills/databricks-expert.md) — skill · 215 installs

From the same set: [databricks/databricks-agent-skills](https://affpapa.org/en/nevibecode/by/databricks/databricks-agent-skills.md) — 30 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
