从 Algolia 迁移到 Meilisearch

本页面旨在帮助 Algolia 的现有用户过渡到 Meilisearch。

要了解这两家搜索公司及其产品的高级比较，请参阅我们对搜索市场的分析。

​

概述

本指南将逐步引导您创建一个 Node.js 脚本，用于将 Algolia 索引数据上传到 Meilisearch。您也可以直接跳到已完成的脚本。

迁移过程包含三个步骤

1. 导出存储在 Algolia 中的数据
2. 将数据导入 Meilisearch
3. 配置 Meilisearch 索引设置（可选）

为帮助过渡，我们还包含了 Meilisearch 和 Algolia 的 API 方法以及 前端组件的比较。

在继续之前，请确保您已安装 Meilisearch 和 Node.js，并能访问命令行终端。如果您不确定如何安装 Meilisearch，请参阅我们的快速入门。

​

导出您的 Algolia 数据

​

初始化项目

首先创建一个名为 algolia-meilisearch-migration 的目录，并使用 npm 生成一个 package.json 文件

mkdir algolia-meilisearch-migration
cd algolia-meilisearch-migration
npm init -y

这将设置我们安装依赖所需的环境。

接下来，创建一个 script.js 文件

touch script.js

此文件将包含我们的迁移脚本。

​

安装依赖

要开始，您需要两个不同的包。第一个是 algoliasearch，它是 Algolia API 的 JavaScript 客户端；第二个是 meilisearch，它是 Meilisearch API 的 JavaScript 客户端。

npm install -s [email protected] [email protected]

​

创建 Algolia 客户端

您需要您的 Application ID（应用程序 ID）和 Admin API Key（管理员 API 密钥）来启动 Algolia 客户端。两者都可以在您的 Algolia 账户中找到。

将以下代码粘贴到 script.js 中

const algoliaSearch = require("algoliasearch");

const algoliaClient = algoliaSearch(
  "APPLICATION_ID",
  "ADMIN_API_KEY"
);
const algoliaIndex = algoliaClient.initIndex("INDEX_NAME");

请将 APPLICATION_ID 和 ADMIN_API_KEY 分别替换为您的 Algolia 应用程序 ID 和管理员 API 密钥。

请将 INDEX_NAME 替换为您希望迁移到 Meilisearch 的 Algolia 索引名称。

​

从 Algolia 获取数据

要一次性获取所有 Algolia 索引数据，请使用 Algolia 的 browseObjects 方法。

let records = [];
await algoliaIndex.browseObjects({
    batch: (hits) => {
      records = records.concat(hits);
    }
  });

batch 回调方法会在每批次命中时被调用，内容会连接到 records 数组中。我们稍后会在上传过程中再次使用 records。

​

将数据导入 Meilisearch

​

创建 Meilisearch 客户端

通过传入 Meilisearch 实例的主机 URL 和 API 密钥来创建 Meilisearch 客户端。最简单的选项是使用自动生成的管理员 API 密钥。

const { MeiliSearch } = require("meilisearch");

const meiliClient = new MeiliSearch({
  host: "MEILI_HOST",
  apiKey: "MEILI_API_KEY",
});
const meiliIndex = meiliClient.index("MEILI_INDEX_NAME");

请将 MEILI_HOST、MEILI_API_KEY 和 MEILI_INDEX_NAME 替换为您的 Meilisearch 主机 URL、Meilisearch API 密钥以及您希望添加文档的索引名称。如果该索引不存在，Meilisearch 将会创建它。

​

上传数据到 Meilisearch

接下来，使用 Meilisearch JavaScript 方法 addDocumentsInBatches 以 100,000 为一批上传所有记录。

const BATCH_SIZE = 100000;
await meiliIndex.addDocumentsInBatches(records, BATCH_SIZE);

就这些！当您准备运行脚本时，输入以下命令

node script.js

​

完成脚本

const algoliaSearch = require("algoliasearch");
const { MeiliSearch } = require("meilisearch");

const BATCH_SIZE = 1000;

(async () => {
  const algoliaClient = algoliaSearch("APPLICATION_ID", "ADMIN_API_KEY");
  const algoliaIndex = algoliaClient.initIndex("INDEX_NAME");

  let records = [];
  await algoliaIndex.browseObjects({
    batch: (hits) => {
      records = records.concat(hits);
    }
  });

  const meiliClient = new MeiliSearch({
    host: "MEILI_HOST",
    apiKey: "MEILI_API_KEY",
  });
  const meiliIndex = meiliClient.index("MEILI_INDEX_NAME");

  await meiliIndex.addDocumentsInBatches(records, BATCH_SIZE);
})();

​

配置您的索引设置

Meilisearch 的默认设置旨在提供快速且相关的搜索体验，适用于大多数用例。

要自定义您的索引设置，我们建议遵循本指南。要了解 Algolia 和 Meilisearch 中设置之间的更多差异，请继续阅读。

​

索引设置 vs. 搜索参数

Algolia 和 Meilisearch 之间一个关键的使用差异在于它们如何处理索引设置和搜索参数。

在 Algolia 中，API 参数是一个灵活的类别，它包含索引设置和搜索参数。许多 API 参数都可以在索引时（设置默认行为）或搜索时（覆盖该行为）使用。

在 Meilisearch 中，索引设置和搜索参数是两个不同的类别。设置会影响索引上的所有搜索，而参数则影响单次搜索的结果。

某些 Meilisearch 参数需要事先配置索引设置。例如，您必须先配置索引设置 sortableAttributes 才能使用搜索参数 sort。然而，与 Algolia 不同，索引设置永远不能用作参数，反之亦然。

​

设置与参数比较

下表比较了 Algolia 的 API 参数与 Meilisearch 对应的设置或搜索参数。

​

API 方法

本节使用 JavaScript 作为参考，比较了 Algolia 和 Meilisearch 各自的 API 方法。

​

前端组件

InstantSearch 是 Algolia 维护的一系列开源工具，用于生成前端搜索 UI 组件。要将 InstantSearch 与 Meilisearch 结合使用，您必须使用 Instant Meilisearch。

Instant Meilisearch 是一个连接您的 Meilisearch 实例与 InstantSearch 的插件，让您能够像 Algolia 用户一样访问许多相同的前端组件。您可以在 GitHub 项目的 README 中找到Instant Meilisearch 支持的组件的最新列表。