回到主页Meilisearch 的标志
返回文章
使用 Meilisearch
2022 年 12 月 19 日

如何将您的应用程序更新到最新的 Meilisearch 版本

在云平台上更新 Meilisearch 实例可能令人生畏。让我们引导您完成整个过程。

Carolina Ferreira
Carolina FerreiraMeilisearch 开发者布道师@CarolainFG
How to update your app to the latest Meilisearch version

本指南将引导您完成在使用 Meilisearch 官方镜像时，在 DigitalOcean、AWS 或 GCP 上更新 Meilisearch 实例所需的步骤。

开始之前，请注意以下事项

  • 本指南不适用于 v0.15 以下的版本。由于转储功能是在 v0.15 中引入的，如果您使用的是 v0.14 或更早版本，则需要手动重新索引所有文档和设置。
  • 如果您正在更新到 v0.28 或更高版本，从旧版本导入的密钥将重新生成其 key 和 uid 字段。
  • 您需要通过 SSH 连接到您的云实例，并且根据您连接的用户（root、admin 等），您可能需要在某些命令前加上 sudo。

此外，如果您使用的是 v0.22 或更高版本，您可以使用我们的迁移脚本，让它为您完成所有工作！

步骤 1：检查您的 Meilisearch 版本

您需要知道您的 Meilisearch 版本。如果您不知道或不确定，可以使用获取版本端点。

curl 
  -X GET 'http://<your-domain-name>/version' 
  -H 'Authorization: Bearer API_KEY'

如果您收到 missing_authorization_header 错误代码，您可能使用的是 v0.24 或更低版本。请按如下方式将授权头更改为 X-MEILI-API-KEY。

curl 
  -X GET 'http://<your-domain-name>/version' 
  -H 'X-Meili-API-Key: API_KEY'

检查您的 pkgVersion，如果它是 “0.21.0” 或更高版本，您可以直接跳到步骤 3。否则，请继续执行下一步。

步骤 2：将所有字段设置为显示属性

此步骤仅在您使用 v0.20 或更低版本时强制执行。

‌‌

当使用 v0.21 以下的 Meilisearch 版本创建转储时，所有字段都必须显示，才能保存到转储中。

首先，您需要验证显示属性列表。

# whenever you see {index_uid}, replace it with your index's unique id
curl 
  -X GET 'http://<your-domain-name>/indexes/{index_uid}/settings/displayed-attributes' 
  -H 'X-Meili-API-Key: API_KEY'

如果响应包含 {'displayedAttributes': '["*"]'}，您可以继续执行步骤 3。

‌‌如果不是，请保存当前列表以便在迁移完成后恢复，然后继续将显示属性列表重置为其默认值 ([“*”])。

curl 
  -X DELETE 'http://<your-domain-name>/indexes/{index_uid}/settings/displayed-attributes' 
  -H 'X-Meili-API-Key: API_KEY'

此命令返回一个 updateId。您可以使用它来跟踪操作的状态。

# replace {updateId} with the updateId returned by the previous request
curl 
  -X GET 'http://<your-domain-name>/indexes/{index_uid}/updates/{updateId}' 
  -H 'X-Meili-API-Key: API_KEY'

一旦状态为 processed，您就可以继续了。

现在所有字段都已显示，请继续下一步。

步骤 3：创建转储

在创建转储之前，请确保您的转储目录可访问。默认情况下，转储会在配置文件目录中名为 dumps 的文件夹中创建：/var/opt/meilisearch/dumps。

‌‌然后您可以创建 Meilisearch 数据库的转储。

# replace the header with -H 'X-Meili-API-Key: API_KEY' if you are on v0.24 or below
curl 
  -X POST 'http://<your-domain-name>/dumps' 
  -H 'Authorization: Bearer API_KEY'

‌‌如果您使用的是 v0.27 或更低版本，转储使用与任务队列分离的单独队列。响应应返回一个转储 uid。您可以使用它通过获取转储状态端点来跟踪转储的状态。

# replace the header with -H 'X-Meili-API-Key: API_KEY' if you are on v0.24 or below
curl -X GET 'http://<your-domain-name>/dumps/{uid}/status' 
  -H 'Authorization: Bearer API_KEY'

一旦转储状态为 done，您就可以继续下一步了。

{
    "uid":"20221130-110940190",
    "status":"done",
    "startedAt":"2022-11-30T11:09:40.190772Z",
    "finishedAt":"2022-11-30T11:09:45.94484Z"
}

‌‌‌‌如果您使用的是 v0.28 或更高版本，转储被视为任务并共享任务队列。响应应返回一个 taskUid，您可以使用它通过获取任务端点来跟踪其状态。

curl 
  -X GET 'http://<your-domain-name>/tasks/{taskUid}' 
  -H 'Authorization: Bearer API_KEY’

‌‌一旦 dumpCreation 任务显示 "status": "succeeded"，您就可以继续下一步了。

{
  "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"
}

‌步骤 4：停止 Meilisearch 实例

如果您尚未操作，请通过 SSH 连接到您的云实例并执行以下命令停止 Meilisearch。请记住，如果您不是以 root 用户连接，则可能需要在此命令前加上 sudo。

systemctl stop meilisearch

‌‌步骤 5：保存当前二进制文件和数据库以进行备份

将当前 Meilisearch 版本的二进制文件和数据库移动到 tmp/ 文件夹。

mv /usr/bin/meilisearch /tmp
mv /var/lib/meilisearch/data.ms /tmp/

‌步骤 6：安装所需版本的 Meilisearch

‌‌‌‌您可以使用此命令下载 Meilisearch 二进制文件。将 {meilisearch_version} 替换为您选择的版本，格式如下：vX.X.X。

curl "https://github.com/meilisearch/meilisearch/releases/download/{meilisearch_version}/meilisearch-linux-amd64" --output meilisearch --location --show-error

使 Meilisearch 二进制文件可执行

chmod +x meilisearch

将新的 Meilisearch 二进制文件移动到包含可执行文件的目录。

mv meilisearch /usr/bin/meilisearch

步骤 7：启动 Meilisearch 并导入转储

‌现在您已经获得了所需的 Meilisearch 版本，执行以下命令以在启动时导入转储。

别忘了将 dump_uid.dump 替换为实际的转储文件名。

meilisearch --db-path /var/lib/meilisearch/data.ms --import-dump "/var/opt/meilisearch/dumps/dump_uid.dump"

导入转储需要索引其中包含的所有文档。根据数据集的大小，此过程可能需要很长时间，并导致内存使用量激增。

步骤 8：将 Meilisearch 作为服务重启

转储正确导入后，按 Ctrl+C  停止 Meilisearch。接下来，执行以下命令运行脚本以配置 Meilisearch 并将其作为服务重启。

meilisearch-setup

如有必要，别忘了将 displayedAttributes 设置回其先前的值。您可以使用更新显示属性端点来完成此操作。

🎉 恭喜！您已成功将 Meilisearch 数据库迁移到最新版本！

步骤 9：清理文件或回滚

清理文件

如果您已经完成了所有前面的步骤并且 Meilisearch 正在运行，那么是时候进行一些清理了。还记得我们为备份而保存的那些文件吗？您可以使用以下命令删除它们。

rm /tmp/meilisearch
rm -r /tmp/data.ms

‌由于您不再需要它，您也可以删除转储文件。

rm /var/opt/meilisearch/dumps/{dump_uid.dump}

回滚

如果由于某种原因，出现问题，您总是可以回滚到以前的版本。使用以下命令将文件移回其先前位置。


mv /tmp/meilisearch /usr/bin/meilisearch
mv /tmp/data.ms /var/lib/meilisearch/data.ms

‌并运行配置脚本。

meilisearch-setup

‌‌一切都应该恢复原样。呼！

希望本指南能帮助您享受最新版 Meilisearch 的所有优势。别忘了我们的支持团队随时准备提供帮助！我们全新的 Discord 服务器上有一个专门的支持频道！

‌‌‌‌‌‌‌‌‌‌

Meilisearch indexes embeddings 7x faster with binary quantization
工程使用 Meilisearch

Meilisearch 使用二进制量化将嵌入索引速度提高 7 倍

通过使用向量存储 Arroy 实现二进制量化，大大减少了大型嵌入的磁盘空间使用和索引时间，同时保持了搜索的相关性和效率。

Tamo
Tamo2024 年 11 月 29 日
How to add AI-powered search to a React app
使用 MeilisearchAI

如何在 React 应用中添加 AI 驱动的搜索

使用 Meilisearch 的 AI 驱动搜索构建一个 React 电影搜索和推荐应用。

Carolina Ferreira
Carolina Ferreira2024 年 9 月 24 日
Meilisearch is too slow
工程使用 Meilisearch

Meilisearch 速度太慢

在这篇博客文章中，我们探讨了 Meilisearch 文档索引器所需的改进。我们将讨论当前的索引引擎、其缺点以及优化性能的新技术。

Clément Renault
Clément Renault2024 年 8 月 20 日