# 使用指南

本文将介绍 DataMover 的基本使用方法。

# 基本概念

在开始使用 DataMover 之前，我们需要了解几个基本概念：

Source（数据源）：数据的来源位置，可以是本地文件、数据库或远程服务
Destination（目标）：数据的目标位置，可以是本地文件、数据库或远程服务
Transfer（传输）：从数据源到目标的数据传输过程

# 命令行使用

# 基本传输命令

使用 DataMover 进行数据传输的最基本命令如下：

datamover transfer --source ./data/source --destination ./data/destination

# 指定配置文件

您也可以通过配置文件来指定传输参数：

datamover transfer --config ./config.json

配置文件示例：

{
  "source": "./data/source",
  "destination": "./data/destination",
  "options": {
    "concurrency": 4,
    "retry": 3
  }
}

# 编程方式使用

# JavaScript/TypeScript 使用方式

import DataMover from 'datamover';

const config = {
  source: './data/source',
  destination: './data/destination',
  options: {
    concurrency: 4,
    retry: 3
  }
};

const mover = new DataMover(config);
mover.transfer()
  .then(() => {
    console.log('数据传输完成');
  })
  .catch((error) => {
    console.error('数据传输失败:', error);
  });

# 监听传输进度

您可以通过监听事件来获取传输进度：

const mover = new DataMover(config);

mover.on('start', () => {
  console.log('开始传输');
});

mover.on('progress', (stats) => {
  console.log(`传输进度: ${stats.percentage}%`);
});

mover.on('complete', () => {
  console.log('传输完成');
});

mover.transfer();

# 常用选项

# 并发控制

通过设置 concurrency 参数来控制同时进行的传输任务数量：

datamover transfer --source ./source --destination ./dest --concurrency 8

# 重试机制

设置失败重试次数：

datamover transfer --source ./source --destination ./dest --retry 5

# 示例场景

# 本地文件传输

datamover transfer --source ./local/data --destination ./backup/data

# 数据库到文件传输

datamover transfer --source "mysql://user:pass@localhost/db" --destination ./backup

# 文件到云存储传输

datamover transfer --source ./data --destination "s3://bucket/path"

# 下一步

了解更多配置选项
学习性能优化技巧