匯出和匯入傾印檔

傾印檔是一個壓縮檔，其中包含您 Meilisearch 實例的匯出內容。使用傾印檔來遷移到新的 Meilisearch 版本。本教學將說明如何建立和匯入傾印檔。

建立傾印檔也稱為匯出它。使用傾印檔啟動 Meilisearch 也稱為匯入它。

您無法在 Meilisearch Cloud 中手動匯出傾印檔。若要將您的專案遷移到最新的 Meilisearch 版本，請使用 Cloud 介面

如果除了升級之外，您需要建立傾印檔，請透過 Meilisearch Cloud 介面或官方 Meilisearch Discord 伺服器聯絡支援團隊。

若要建立傾印檔，請使用建立傾印檔端點

curl \
  -X POST 'https://127.0.0.1:7700/dumps'

這會傳回一個摘要任務物件，您可以使用它來檢查傾印檔的狀態。

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

傾印檔建立過程是一個非同步任務，所需時間與資料庫的大小成正比。將 1 替換為前一個命令傳回的 taskUid

curl \
  -X GET 'https://127.0.0.1:7700/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 中

使用--import-dump 組態選項啟動 Meilisearch 實例來匯入傾印檔

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

根據您的傾印檔大小，匯入可能需要相當長的時間。只有在此過程完成後，您才能存取 Meilisearch 及其 API。

Meilisearch 會匯入傾印檔中的所有資料。如果您已將資料新增至實例，則與傾印檔中索引具有相同 uid 的現有索引將會被覆寫。