繁體中文

简体中文
English

繁體中文

简体中文
English

主題

Elasticsearch 資料管理 ​

Elasticsearch 資料管理頁面可讓你線上管理 Elasticsearch（或 OpenSearch）資料：列出索引、建立與刪除索引、逐頁瀏覽文件、執行搜尋查詢，以及檢視、建立、更新與刪除文件。

TIP

此功能在 v3.2.0 新增。

先決條件 ​

Elasticsearch 資料管理是針對類型為 Elasticsearch 的資料庫伺服器進行操作。 使用前，請先確認 資料庫 > 伺服器 分頁中已有這樣一台伺服器：

  • 若為遠端執行個體，請在 伺服器 分頁中新增它。 只需填寫位址、連接埠，以及（可選的）使用者名稱與密碼即可。 若同時設定了使用者名稱與密碼，面板將使用 HTTP 基本驗證進行連線；否則將以無憑證的方式連線。
  • 面板透過 Elasticsearch 的 REST API 與其通訊，因此任何相容 OpenSearch 的伺服器同樣適用。

開啟頁面 ​

前往 資料庫 頁面並切換至 Elasticsearch 分頁。 與關聯式資料庫分頁不同，Elasticsearch 完全透過此資料檢視來管理，而非透過資料庫清單。

選擇伺服器 ​

頁面頂端有一個 伺服器 選擇器。 選擇要操作的 Elasticsearch 伺服器；每個選項會以 name (host:port) 的形式顯示。 系統會自動選取第一台可用的伺服器。 切換伺服器會重新載入索引清單並清除目前的選取項目。

索引清單 ​

當未選取任何索引時，頁面會在表格中顯示所選伺服器上的索引清單，包含以下欄位：

  • 索引名稱：索引的名稱。
  • 健康狀態：索引的健康狀態，會以彩色標籤顯示——green（成功）、yellow（警告）或 red（錯誤）。
  • 文件數：索引中的文件數量。
  • 大小：索引的儲存大小，會以易讀的單位顯示。
  • 操作：每個索引對應的 瀏覽 與 刪除 按鈕。

TIP

系統索引（名稱以點開頭，例如 .kibana）會從此清單中隱藏。

建立索引 ​

在檢視索引清單時，點選 建立索引 以開啟建立對話方塊。 輸入 索引名稱 並點選 提交。 索引會以預設設定建立；如有需要，你之後可以透過自己的 Elasticsearch 工具新增對應與設定。

刪除索引 ​

點選某個索引列上的 刪除 並確認即可將其移除。

警告

刪除索引會永久移除該索引及其包含的所有文件。 此操作無法復原！ 請確認你已選取正確的索引，並事先備份好任何重要資料。

瀏覽文件 ​

點選某個索引列上的 瀏覽 即可開啟該索引的文件。 頂端的標籤會顯示目前的索引（Index: <name>），而 返回索引清單 按鈕可讓你回到索引清單。

文件會以分頁表格的形式顯示，包含以下欄位：

  • ID：文件的 _id。
  • 來源：文件的 _source（即其 JSON 主體）。
  • 操作：每個文件對應的 檢視 與 刪除 按鈕。

分頁支援每頁 20、50、100 與 200 筆文件（預設為 20）。

搜尋文件 ​

在瀏覽索引時，使用搜尋框（預留位置為 field:value）來篩選文件，然後點選 搜尋 或按 Enter 鍵。 該查詢使用 Elasticsearch 查詢字串語法，例如：

  • status:active —— status 欄位等於 active 的文件
  • title:elasticsearch AND views:>100 —— 使用 AND / OR 組合多個子句
  • 留空則會列出索引中的所有文件。

檢視或更新文件 ​

點選某個文件列上的 檢視 即可開啟文件對話方塊。 它會顯示：

  • ID：文件的 _id（對於既有文件為唯讀）。
  • 文件（JSON）：文件主體，會以格式化的 JSON 美觀地呈現。

你可以在此對話方塊中編輯 JSON，並點選 提交 將變更儲存回同一份文件。 由於 ID 是固定的，從 檢視 對話方塊儲存會就地更新既有文件。

建立文件 ​

在瀏覽索引時，點選 建立文件 以建立模式開啟文件對話方塊。 填寫表單並點選 提交：

  • ID：選填。 留空可讓 Elasticsearch 自動產生 ID，或輸入指定的 ID 以使用該 ID 建立文件。
  • 文件（JSON）：以 JSON 物件形式表示的文件主體。 此欄位為必填。

TIP

不帶 ID 建立文件會以自動產生的 ID 新增一份文件。 使用指定 ID 建立或儲存文件時，會寫入該確切的文件，若它已存在則會將其取代。

刪除文件 ​

點選某個文件列上的 刪除 並確認，即可從目前的索引中移除該單一文件。

警告

刪除文件會將其從索引中永久移除。 此操作無法復原！

常見問題 ​

無法連線到 Elasticsearch 伺服器 ​

  • 確認所選伺服器的類型為 Elasticsearch，且其主機與連接埠正確無誤。
  • 若伺服器需要驗證，請確認伺服器上同時設定了使用者名稱與密碼。
  • 確認 Elasticsearch（或 OpenSearch）服務正在執行，且可從面板主機存取。
  • 在 資料庫 > 伺服器 分頁中檢查伺服器狀態。

建立或更新文件失敗 ​

  • 確認 文件（JSON） 主體是有效的 JSON。
  • 確認目標索引存在，且文件結構與索引對應相符。

索引未出現在清單中 ​

名稱以點開頭的系統索引會被刻意隱藏。 若某個使用者索引遺失，請重新整理頁面並確認它在所選伺服器上確實存在。