<commit_before>---
title: mydumper 使用文档 
summary: 使用 mydumper 从 TiDB 导出数据。
category: tools
---

# mydumper 使用文档

## mydumper 简介

`mydumper` 是 [mydumper](https://github.com/maxbube/mydumper) 的 fork 项目，并添加了一些针对 TiDB 的功能。推荐使用此工具对 TiDB 进行逻辑备份。

[下载 Binary](http://download.pingcap.org/tidb-enterprise-tools-latest-linux-amd64.tar.gz)。

## 相比于普通的 mydumper，此工具有哪些改进之处?

+ 使用 `tidb_snapshot` 而非 `FLUSH TABLES WITH READ LOCK` 提供备份一致性 
+ `INSERT` 语句中包含隐藏的 `_tidb_rowid` 列
+ [允许设置](../op-guide/history-read.md#操作流程) `tidb_snapshot` 的值（即可备份不同时间点的数据）  

### 新添参数

```bash
  -z, --tidb-snapshot: 设置 tidb_snapshot 用于备份
                       默认值：NOW()-INTERVAL 1 SECOND
                       此参数可设为 TSO 时间或有效的 datetime 时间。例如：-z "2016-10-08 16:45:26"
```

### 使用举例

命令行参数：

```bash
./bin/mydumper -h 127.0.0.1 -u root -P 4000
```

## FAQ

### PingCAP 的 mydumper 的源码是否可获取？

PingCAP 的 mydumper 源码 [位于 GitHub](https://github.com/pingcap/mydumper)。

### 未来是否计划让 PingCAP 对 mydumper 的改动合并到上游？

是的，PingCAP 团队计划将对 mydumper 的改动合并到上游。参见 [PR #155](https://github.com/maxbube/mydumper/pull/155).<commit_msg>tools: update period<commit_after>---
title: mydumper 使用文档 
summary: 使用 mydumper 从 TiDB 导出数据。
category: tools
---

# mydumper 使用文档

## mydumper 简介

`mydumper` 是 [mydumper](https://github.com/maxbube/mydumper) 的 fork 项目，并添加了一些针对 TiDB 的功能。推荐使用此工具对 TiDB 进行逻辑备份。

[下载 Binary](http://download.pingcap.org/tidb-enterprise-tools-latest-linux-amd64.tar.gz)。

## 相比于普通的 mydumper，此工具有哪些改进之处?

+ 使用 `tidb_snapshot` 而非 `FLUSH TABLES WITH READ LOCK` 提供备份一致性 
+ `INSERT` 语句中包含隐藏的 `_tidb_rowid` 列
+ [允许设置](../op-guide/history-read.md#操作流程) `tidb_snapshot` 的值（即可备份不同时间点的数据）  

### 新添参数

```bash
  -z, --tidb-snapshot: 设置 tidb_snapshot 用于备份
                       默认值：NOW()-INTERVAL 1 SECOND
                       此参数可设为 TSO 时间或有效的 datetime 时间。例如：-z "2016-10-08 16:45:26"
```

### 使用举例

命令行参数：

```bash
./bin/mydumper -h 127.0.0.1 -u root -P 4000
```

## FAQ

### PingCAP 的 mydumper 的源码是否可获取？

PingCAP 的 mydumper 源码 [位于 GitHub](https://github.com/pingcap/mydumper)。

### 未来是否计划让 PingCAP 对 mydumper 的改动合并到上游？

是的，PingCAP 团队计划将对 mydumper 的改动合并到上游。参见 [PR #155](https://github.com/maxbube/mydumper/pull/155)。
{'fraction_non_alphanumeric': 0.15168280313508528, 'fraction_numerical': 0.030428769017980636, 'mean_word_length': 3.5780590717299576, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 6, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 2, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1730477', 'n_tokens_mistral': 1217, 'n_tokens_neox': 1274, 'n_words': 191}