# Install dumpling with Homebrew

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

## 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
- **Version:** 26.3.9
- **Source summary:** Creating SQL dump from a MySQL-compatible database
- **Homepage:** <https://github.com/pingcap/tidb>
- **Repository:** <https://github.com/pingcap/tidb>
- **Last updated:** 2026-07-29T17:00:36+09:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- dumpling (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 26.3.9
## 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


## Combined YAML source

View the package source record on GitHub. [combined/dumpling.yml](https://github.com/mxcl/pkgdb/blob/main/combined/dumpling.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph