HOWTO · MongoDB
如何在 Windows 和 Ubuntu 上安裝和使用 Elasticsearch 與 MongoDB
在 Windows 10 或 Ubuntu 20.04 上安裝 Elasticsearch,在本地驗證它,並了解如何將它與 MongoDB 搭配用於搜尋。
本頁內容
Elasticsearch 可以在 MongoDB 旁邊執行,為選定的應用程式資料提供全文搜尋。MongoDB 仍然是事實來源;應用程式或另一個整合程序必須將變更複製到 Elasticsearch 索引中。本指南介紹在 Windows 10 或 Ubuntu 20.04 上啟動 Elasticsearch、檢查其本地端點,以及 Node.js 整合所涉及的決策。
什麼是 Elasticsearch
Elasticsearch 是一個建立在 Apache Lucene 之上的分散式搜尋和分析引擎。它為 JSON 文件建立索引,以便應用程式可以搜尋文字並篩選結構化欄位。MongoDB 儲存應用程式文件並支援通用查詢;Elasticsearch 維護一個單獨的、為檢索優化的搜尋索引。它不是 MongoDB 的替代品,並且這兩個儲存不會自動同步。
索引是衍生資料。請規劃如何最初填充它、如何傳播後續的插入、更新和刪除,以及當它落後或其對映發生變化時如何重建它。
在 Windows 10 上安裝 Elasticsearch
- 選擇一個支援該 Windows 版本以及該發行版所述 Java 執行階段要求的 Elasticsearch 發行版。官方封存可能包含隨附的 JDK;在單獨安裝 Java 之前,請查看該發行版的安裝說明。不要依賴舊的 Java 7 或 Java 8 最低要求作為一般要求。
- 從 Elastic 官方 Elasticsearch 下載頁面下載 Windows 封存,並將其解壓縮到您的帳戶可寫的目錄中。封存版面配置和安全性預設值因發行版而異。
- 在解壓縮後的 Elasticsearch
bin目錄中開啟命令提示字元或 PowerShell,並啟動elasticsearch.bat。在前景程序執行時保持該視窗開啟。對於持久服務,請使用為所選發行版記錄的服務設定,而不是將前景視窗視為服務安裝。 - 保持該發行版的安全性功能啟用。Elasticsearch 8 及更高版本預設啟用安全性功能;請使用產生的憑證或設定適當的使用者和 TLS 設定。不要在可透過網路存取的執行個體上設定
xpack.security.enabled: false。停用安全性功能僅適用於沒有不可信網路存取的隔離本地實驗。 - 在瀏覽器中檢查
http://localhost:9200,或使用curl請求它。一個健康的受保護節點可能會要求提供憑證或傳回身分驗證回應;這仍然表明端點可達。請使用在設定過程中列印或設定的憑證和 HTTPS 詳細資訊。
如果端點沒有回應,請檢查啟動視窗中是否有啟動或設定錯誤,確認程序仍在執行,並驗證另一個程序沒有在使用連接埠 9200。
在 Ubuntu 20.04 上安裝 Elasticsearch
- 選擇一個其支援和軟體套件要求包含 Ubuntu 20.04 的發行版。開啟 Elastic 官方 APT 安裝指南,並按照您所選發行版的儲存庫和簽章金鑰步驟操作。這些步驟將 APT 設定為信任 Elastic 的軟體套件簽章金鑰,並從 Elastic 的儲存庫中擷取軟體套件。基於
apt-key的舊說明已棄用;請使用指南中顯示的金鑰環方法。Elasticsearch 軟體套件通常包含合適的隨附 JDK,因此僅當所選發行版的說明要求時,才安裝單獨的 Java 軟體套件。 - 為所選發行版設定儲存庫後,使用
sudo apt-get update重新整理 APT 的軟體套件索引,然後使用sudo apt-get install elasticsearch安裝 Elasticsearch。如果您需要可重複的部署,請使用apt-cache madison elasticsearch檢查該儲存庫中可用的版本,並使用sudo apt-get install elasticsearch=<package-version>安裝確切的軟體套件版本。請使用 APT 報告的版本字串;儲存庫行和可用版本取決於在 Elastic 指南中選擇的發行版。 - 使用
sudo systemctl enable --now elasticsearch.service啟動並啟用該服務。使用sudo systemctl status elasticsearch.service檢查它;如果啟動失敗,請檢查服務日誌或/var/log/elasticsearch/。 - 主要設定通常是
/etc/elasticsearch/elasticsearch.yml。保持身分驗證和傳輸安全性啟用,並審慎地設定網路暴露。單節點設定並不自動就可以安全地公開暴露。 - 使用您發行版的憑證和憑證設定檢查
https://localhost:9200。憑證警告可能意味著本地 CA 不受用戶端信任;請驗證憑證或將用戶端設定為信任產生的 CA,而不是停用驗證。
成功的本地回應確認 Elasticsearch 正在執行。它並不確認 MongoDB 記錄正在被索引。
為什麼將 Elasticsearch 與 MongoDB 一起使用
MongoDB 通常是應用程式記錄的權威儲存,而 Elasticsearch 則為單獨維護的索引提供搜尋。這種搭配可以提供全文搜尋,而無需使搜尋索引成為資料的唯一副本。搜尋結果可能會落後於 MongoDB,因此需要即時一致性的應用程式應考慮這一延遲。
Node.js 整合需要一個 MongoDB 變更來源、一個與所選伺服器版本相容的 Elasticsearch 用戶端,以及一個明確的索引策略。典型的流程是讀取現有記錄以建立初始索引,使用從其 MongoDB _id 衍生的穩定文件 ID 將每條記錄寫入 Elasticsearch,然後在插入、更新和刪除發生時套用它們。使寫入可重試且冪等,記錄失敗以便重播,並提供一種核對或重建索引的方法。檢查 MongoDB 中的一個範例文件,並查詢相應的 Elasticsearch 文件以驗證雙方。
以下 Node.js 範例展示了從 MongoDB 記錄到 Elasticsearch 文件 ID 和 JSON 正文的確定性對映。它在沒有任一服務的情況下執行;它僅演示負載的形狀,而不是資料庫寫入或同步。
const mongoRecord = {
_id: "product-42",
name: "Trail shoes",
category: "footwear"
};
const elasticsearchDocument = {
id: String(mongoRecord._id),
document: {
name: mongoRecord.name,
category: mongoRecord.category
}
};
console.log(JSON.stringify(elasticsearchDocument, null, 2));
{
"id": "product-42",
"document": {
"name": "Trail shoes",
"category": "footwear"
}
}
要在應用程式中使用這種形狀,請透過維護中的 Elasticsearch 用戶端將 id 作為 Elasticsearch 文件 ID 傳送,並將 document 作為其來源。將該寫入連接到應用程式的 MongoDB 變更處理,並明確處理重試和刪除。該範例並不證明某個特定的用戶端、外掛程式或 Elasticsearch 發行版是相容的。
原始的 mongoosastic 範例依賴於一個遺留的 Mongoose 外掛程式和一個相容的 Elasticsearch 用戶端。它與目前 Elasticsearch 發行版的相容性在此並未得到證實,因此不要將該程式碼片段或其成功訊息視為已驗證的整合。在採用它之前,請確認該外掛程式支援您專案中確切的 Mongoose 和 Elasticsearch 版本。對於新的整合,請使用維護中的用戶端,並遵循其針對特定版本的索引和變更流指南;僅憑一個基本的儲存回呼並不能證明索引已完成。