This repository has been archived by the owner on Aug 21, 2023. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 85
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
1 addition
and
52 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,52 +1 @@ | ||
🥟 Dumpling | ||
============ | ||
|
||
[![Build Status](https://travis-ci.org/pingcap/dumpling.svg?branch=master)](https://travis-ci.org/pingcap/dumpling) | ||
[![codecov](https://codecov.io/gh/pingcap/dumpling/branch/master/graph/badge.svg)](https://codecov.io/gh/pingcap/dumpling) | ||
[![API Docs](https://img.shields.io/badge/go.dev-reference-007d9c?logo=go&logoColor=white)](https://pkg.go.dev/github.com/pingcap/dumpling) | ||
[![Go Report Card](https://goreportcard.com/badge/github.com/pingcap/dumpling)](https://goreportcard.com/report/github.com/pingcap/dumpling) | ||
[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fpingcap%2Fdumpling.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2Fpingcap%2Fdumpling?ref=badge_shield) | ||
[![Discuss in Slack](https://img.shields.io/badge/slack-sig--migrate-4A154B?logo=slack)](https://slack.tidb.io/invite?team=tidb-community&channel=sig-migrate&ref=github_sig) | ||
|
||
**Dumpling** is a tool and a Go library for creating SQL dump from a MySQL-compatible database. | ||
It is intended to replace `mysqldump` and `mydumper` when targeting TiDB. | ||
|
||
You may read the [design document](https://github.com/pingcap/community/blob/master/rfc/2019-12-06-dumpling.md), [English user guide](docs/en/user-guide.md) and [中文使用手册](docs/cn/user-guide.md) for details. | ||
|
||
Features | ||
-------- | ||
|
||
> Dumpling is currently in early development stage, and most features are incomplete. Contributions are welcomed! | ||
- [x] SQL dump is split into multiple files (like `mydumper`) for easy management. | ||
- [x] Export multiple tables in parallel to speed up execution. | ||
- [x] Multiple output formats: SQL, CSV, ... | ||
- [ ] Write to cloud storage (S3, GCS) natively | ||
- [x] Advanced table filtering | ||
|
||
Any questions? Let's discuss in [#sig-migrate in Slack](https://slack.tidb.io/invite?team=tidb-community&channel=sig-migrate&ref=github_sig)! | ||
|
||
Building | ||
-------- | ||
|
||
1. Install Go 1.16 or above | ||
2. Run `make build` to compile. The output is in `bin/dumpling`. | ||
3. Run `make test` to run the unit tests. | ||
4. Run `make integration_test` to run integration tests. For integration test: | ||
- The following executables must be copied or generated or linked into these locations: | ||
* `bin/sync_diff_inspector` (download from [tidb-enterprise-tools-latest-linux-amd64](http://download.pingcap.org/tidb-enterprise-tools-latest-linux-amd64.tar.gz)) | ||
* `bin/tidb-server` (download from [tidb-master-linux-amd64](https://download.pingcap.org/tidb-master-linux-amd64.tar.gz)) | ||
* `bin/tidb-lightning` (download from [tidb-toolkit-latest-linux-amd64](https://download.pingcap.org/tidb-toolkit-latest-linux-amd64.tar.gz)) | ||
* `bin/minio` (download from <https://min.io/download>) | ||
- The following programs must be installed: | ||
* `mysql` (the CLI client) | ||
- There must be a local mysql server listening on `127.0.0.1:3306`, and an active user with no password that can be connected through this TCP address. | ||
|
||
|
||
License | ||
------- | ||
|
||
Dumpling is under the Apache 2.0 license. See the [LICENSE](./LICENSE) file for details. | ||
|
||
|
||
[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fpingcap%2Fdumpling.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Fpingcap%2Fdumpling?ref=badge_large) | ||
This repository has been moved to <https://github.com/pingcap/tidb/tree/master/dumpling>. |