# Install dumpling with Homebrew

Creating SQL dump from a MySQL-compatible database. Version 26.3.4 via Homebrew; verified 2026-07-08.

## Install

```sh
sudo av install brew:dumpling
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install dumpling
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:dumpling
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/dumpling>
- **Version:** 26.3.4
- **Source summary:** Creating SQL dump from a MySQL-compatible database
- **Homepage:** <https://github.com/pingcap/tidb>
- **Repository:** <https://github.com/pingcap/tidb>
- **Upstream docs:** <https://docs.pingcap.com/tidb/stable/dumpling-overview>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/pingcap/tidb/archive/refs/tags/v26.3.4.tar.gz>
- **Last updated:** 2026-07-08T06:11:50Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- dumpling (cli)
- dumpling (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 26.3.4
- Package-manager updated: 2026-07-08
- Local data: ok
- Upstream repository: https://github.com/pingcap/tidb
- Upstream latest detected: v26.3.4 (current)
## Project history and usage

Dumpling is PingCAP's logical export tool for dumping TiDB or MySQL-compatible data as SQL or CSV files, commonly as part of TiDB backup, migration, and data-loading workflows.

### Project history

Dumpling lives in the PingCAP TiDB ecosystem rather than as a standalone historical project. Official docs introduce it as the data export tool for TiDB/MySQL, with support for SQL and CSV output, logical full backup or export, and Amazon S3 output.

PingCAP's documentation records an important lineage change: PingCAP previously maintained a TiDB-specific fork of mydumper, but starting with TiDB v7.5.0 that Mydumper path is deprecated and most features are replaced by Dumpling. The docs strongly recommend Dumpling instead.

### Adoption history

Dumpling adoption follows TiDB adoption. It is installed with TiUP, included in TiDB Toolkit, documented in TiDB Cloud and TiDB self-managed workflows, and paired with TiDB Lightning for imports. Homebrew packaging makes the tool available outside TiUP for macOS and general Unix package users.

### How it is used

Users run Dumpling against a live TiDB or MySQL-compatible source to export full data sets, filtered subsets, SQL files, CSV files, metadata, schema files, and cloud-storage outputs. The docs emphasize consistency options, GC safe-point handling for TiDB, table filtering, parallel export, file sizing, compression, and downstream import with TiDB Lightning.

### Why package nerds care

Dumpling matters because it is not just another mysqldump clone: it is the TiDB ecosystem's logical export replacement for a TiDB-enhanced mydumper fork. Its packaging captures database-operational assumptions such as TiUP distribution, cloud storage URIs, GC safe-point coordination, and Lightning-compatible output layout.

### Timeline

- 2015: The pingcap/tidb repository is created.
- 2020: Dumpling docs note Amazon S3 export support starting from TiDB v4.0.8.
- TiDB v7.5.0: PingCAP deprecates its Mydumper path and recommends Dumpling instead.
- 2026: Homebrew packages Dumpling stable 26.3.4 from the TiDB repository.

### Related projects

- Related projects include TiDB, TiUP, TiDB Toolkit, TiDB Lightning, BR, TiCDC, mydumper, MySQL, and external-storage backends such as Amazon S3.

### Sources

- <https://docs.pingcap.com/tidb/stable/dumpling-overview>
- <https://github.com/pingcap/docs/blob/master/dumpling-overview.md>
- <https://github.com/pingcap/docs/blob/master/tidb-lightning/tidb-lightning-overview.md>
- <https://github.com/pingcap/tidb#readme>
- <https://api.github.com/repos/pingcap/tidb>
- <https://formulae.brew.sh/formula/dumpling>


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal

## Source Database Details

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


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [automysqlbackup](https://www.automicvault.com/pkg/brew/automysqlbackup/) - Shares av.db curated category or tags: backup, cli, data, database, mysql.
- [percona-xtrabackup](https://www.automicvault.com/pkg/brew/percona-xtrabackup/) - Shares av.db curated category or tags: backup, cli, data, database, mysql.
- [kitchen-sync](https://www.automicvault.com/pkg/brew/kitchen-sync/) - Shares av.db curated category or tags: cli, data, database, mysql.
- [lazysql](https://www.automicvault.com/pkg/brew/lazysql/) - Shares av.db curated category or tags: cli, data, database, mysql.
- [mysql](https://www.automicvault.com/pkg/brew/mysql/) - Shares av.db curated category or tags: cli, data, database, mysql.
- [percona-server](https://www.automicvault.com/pkg/brew/percona-server/) - Shares av.db curated category or tags: cli, data, database, mysql.
- [whodb-cli](https://www.automicvault.com/pkg/brew/whodb-cli/) - Shares av.db curated category or tags: cli, data, database, mysql.
- [basex](https://www.automicvault.com/pkg/brew/basex/) - Shares av.db curated category or tags: cli, data, database.

## Combined YAML source

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


## Sources

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