# 使用 Homebrew 安装 iceberg-cli

查看 iceberg-cli 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:iceberg-cli
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install iceberg-cli
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:iceberg-cli
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/iceberg-cli>
- **版本:** 0.6.0
- **来源摘要:** Command-line interface for Apache Iceberg
- **主页:** <https://go.iceberg.apache.org/cli.html>
- **仓库:** <https://github.com/apache/iceberg-go>
- **上游文档:** <https://go.iceberg.apache.org/cli.html>
- **许可证:** Apache-2.0
- **源码归档:** <https://github.com/apache/iceberg-go/archive/refs/tags/v0.6.0.tar.gz>
- **最后更新:** 2026-05-28T18:47:12Z
- **已生成:** 2026-07-08T07:18:31+00:00

## 可执行文件

- iceberg (cli)
- iceberg (别名)

## 构建依赖

- go

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-07-08
- 管理器版本: 0.6.0
- 管理器更新时间: 2026-05-28
- 本地数据: OK
- 上游仓库: https://github.com/apache/iceberg-go
- 检测到的最新版本: v0.6.0 (当前)
## 项目历史与用法

Apache Iceberg CLI is the command-line program built from Apache Iceberg Go. It gives developers a local `iceberg` executable for catalog inspection, namespace and table operations, snapshot maintenance, rollback, tagging, branch work, and JSON-friendly automation.

### 项目历史

The CLI inherits its significance from Apache Iceberg, the open table format originally developed at Netflix and contributed to the Apache Software Foundation in 2018. Iceberg's format made table metadata, snapshots, schema evolution, hidden partitioning, and multi-engine access central to data-lake operations.

The Go implementation made Iceberg usable in Go services and small operational tools without requiring a JVM. Its CLI documentation explicitly says the command is built from `./cmd/iceberg` and that its usage is similar to PyIceberg's CLI, placing it in the growing family of non-Java Iceberg implementations.

### 采用历史

The CLI reflects Iceberg adoption moving from engine-integrated libraries into packageable operational tools. The Apache Iceberg site lists Go alongside Python, Rust, and C++ as other implementations, while the Homebrew formula exposes the Go CLI directly as `iceberg`.

Its package-manager role is strongest for data engineers who want quick catalog checks, snapshot inspection, and maintenance commands from scripts, CI jobs, or a laptop shell.

### 使用方式

Typical use starts with a REST, Glue, Hive, or Hadoop catalog URI, optionally read from `~/.iceberg-go.yaml`. Commands cover listing namespaces, creating and describing tables, inspecting snapshots and refs, expiring snapshots, cleaning orphan files, rolling back tables, upgrading table format versions, and emitting JSON for downstream tooling.

The CLI is useful as a small operational companion to larger engines such as Spark, Flink, Trino, and Hive rather than as the primary compute engine for queries.

### 为什么软件包爱好者会关心

For package nerds, `iceberg-cli` is the small executable edge of a very large lakehouse ecosystem. It packages the Iceberg control plane as a Go binary, avoiding a JVM for routine table metadata operations.

It also shows the maturation of Apache Iceberg beyond its reference Java library: the same table format is represented by dedicated Go docs, releases, and a Homebrew formula.

### 时间线

- 2018: Iceberg was contributed to the Apache Software Foundation.
- 2020: Apache Iceberg graduated as an Apache top-level project.
- 2024: Apache Iceberg Go began publishing 0.x releases for the Go implementation.
- 2026: The Go CLI documentation covers catalog flags, config files, maintenance commands, refs, branches, tags, and JSON automation.

### Related projects

- Apache Iceberg is the table format and Java reference implementation behind the ecosystem.
- PyIceberg is the Python implementation whose CLI behavior is referenced by the Go CLI documentation.
- Apache Iceberg Rust and C++ are sibling non-Java implementations listed by the Apache Iceberg documentation.

### 来源

- <https://formulae.brew.sh/formula/iceberg-cli>
- <https://github.com/apache/iceberg-go>
- <https://github.com/apache/iceberg-go/releases>
- <https://go.iceberg.apache.org/cli.html>
- <https://iceberg.apache.org/>
- <https://news.apache.org/foundation/entry/asf-project-spotlight-apache-iceberg>


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.iceberg-go.yaml
## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** iceberg-cli
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## 相关链接

- [Terminal utility packages](https://www.automicvault.com/zh-hans/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/zh-hans/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Language runtime packages](https://www.automicvault.com/zh-hans/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [Networking and protocol packages](https://www.automicvault.com/zh-hans/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [go](https://www.automicvault.com/zh-hans/pkg/brew/go/) - Build dependency declared by Homebrew.
- [cubejs-cli](https://www.automicvault.com/zh-hans/pkg/brew/cubejs-cli/) - Shares av.db curated category or tags: cli, data.
- [lakekeeper](https://www.automicvault.com/zh-hans/pkg/brew/lakekeeper/) - Shares av.db curated category or tags: apache-iceberg, cli, data, data-lake.
- [nessie](https://www.automicvault.com/zh-hans/pkg/brew/nessie/) - Shares av.db curated category or tags: apache-iceberg, cli, data, data-lake.
- [burrow](https://www.automicvault.com/zh-hans/pkg/brew/burrow/) - Shares av.db curated category or tags: cli, data, go.
- [cayley](https://www.automicvault.com/zh-hans/pkg/brew/cayley/) - Shares av.db curated category or tags: cli, data, go.
- [clickhouse-sql-parser](https://www.automicvault.com/zh-hans/pkg/brew/clickhouse-sql-parser/) - Shares av.db curated category or tags: cli, data, go.
- [conduit](https://www.automicvault.com/zh-hans/pkg/brew/conduit/) - Shares av.db curated category or tags: cli, data, go.
- [ioctl](https://www.automicvault.com/zh-hans/pkg/brew/ioctl/) - Shares av.db curated category or tags: cli, data, go.

## Combined YAML source

View the package source record on GitHub. [combined/iceberg-cli.yml](https://github.com/automic-vault/db/blob/main/combined/iceberg-cli.yml)


## 来源

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph