导出和导入数据转储

dump（数据转储） 是一个压缩文件，包含您的 Meilisearch 实例的导出数据。使用 dump 可以迁移到新的 Meilisearch 版本。本教程将向您展示如何创建和导入 dump。

创建 dump 的过程也称为导出。使用 dump 启动 Meilisearch 的过程称为导入。

​

创建 dump

​

在 Meilisearch Cloud 中创建 dump

您无法在 Meilisearch Cloud 中手动导出 dump。如需将项目迁移到最新的 Meilisearch 版本，请使用 Cloud 界面：

如果出于升级以外的原因需要创建 dump，请通过 Meilisearch Cloud 界面或官方 Meilisearch Discord 服务器联系支持团队。

​

在自托管实例中创建数据转储

要创建数据转储，请使用创建转储端点：

curl \
  -X POST 'MEILISEARCH_URL/dumps'

这将返回一个摘要任务对象，可用于检查转储状态。

{
  "taskUid": 1,
  "indexUid": null,
  "status": "enqueued",
  "type": "dumpCreation",
  "enqueuedAt": "2022-06-21T16:10:29.217688Z"
}

转储创建是一个异步任务，所需时间与数据库大小成正比。将 1 替换为上一个命令返回的 taskUid：

curl \
  -X GET 'MEILISEARCH_URL/tasks/1'

这将返回包含转储操作详细信息的对象：

{
  "uid": 1,
  "indexUid": null,
  "status": "succeeded",
  "type": "dumpCreation",
  "canceledBy": null,
  "details": {
    "dumpUid": "20220621-161029217"
  },
  "error": null,
  "duration": "PT0.025872S",
  "enqueuedAt": "2022-06-21T16:10:29.217688Z",
  "startedAt": "2022-06-21T16:10:29.218297Z",
  "finishedAt": "2022-06-21T16:10:29.244169Z"
}

当前实例的所有索引及其文档和设置都会被导出，并保存为单个 .dump 文件。转储还包括 Meilisearch 开始处理转储创建任务之前注册的任何任务。

当任务 status 变为 succeeded 后，可以在转储目录中找到转储文件。默认情况下，该文件夹名为 dumps，位于启动 Meilisearch 的目录中。

如果在文件系统中看到转储文件，则表示转储过程已成功完成。即使您在生成转储时中断实例，Meilisearch 也永远不会创建部分转储文件。

​

导入数据转储文件

​

在 Meilisearch Cloud 中导入转储文件

在创建新项目时，您可以在方案选择器下方导入转储文件：

​

在自托管实例中导入转储文件

通过使用 --import-dump 配置选项 启动 Meilisearch 实例来导入转储文件：

./meilisearch --import-dump /dumps/20200813-042312213.dump

根据转储文件的大小，导入过程可能需要较长时间。只有在导入完成后才能访问 Meilisearch 及其 API。

Meilisearch 会导入转储文件中的所有数据。如果您的实例中已有数据，与转储文件中索引具有相同 uid 的现有索引将被覆盖。