如何安全地優化 ownCloud 10 資料庫索引

ownCloud 資料夾清單載入緩慢、同步延遲或定時任務運行時間過長都可能指向資料庫瓶頸，但盲目添加索引會降低伺服器的可靠性。在 ownCloud Server 10 中，穩健的做法是先確認特定的版本和資料庫，備份實例，然後僅使用針對該 ownCloud 版本已記錄的架構變更。索引有助於選擇性搜尋和連接；但它們也會消耗儲存空間，並增加插入和更新作業的開銷。

這裡存在一個重要的版本差異：目前官方的 ownCloud Server 10.16 命令參考文件記錄了資料庫操作（例如資料庫轉換），但沒有記錄通用的db:add-missing-indices修復命令。該命令出現在 Nextcloud 的指南中，而 Nextcloud 是另一個產品。在執行從其他項目複製的命令之前，請務必先在自己的伺服器上驗證這些命令。

ownCloud 安裝目錄中的 Linux 終端機會顯示 occ status 指令以及已安裝和維護狀態欄位。 — 此`occ status`命令確認 CLI 在資料庫工作開始之前已連接到 ownCloud 安裝。

資料庫索引能解決什麼問題，不能解決什麼問題

資料庫索引是一種輔助結構，它可以幫助資料庫在不掃描整個表的情況下找到匹配的行。當查詢和資料分佈使得索引發揮作用時，它可以提高基於索引列進行篩選、連接或排序的查詢的效能。但它並非通用的速度開關：對於小型表或傳回大量行的查詢，資料庫優化器可以正確地選擇全表掃描。

索引也會帶來成本。它們會佔用磁碟空間，需要在行更改時進行維護，並且會降低寫入密集型任務的速度。在 ownCloud 核心表上新增額外的索引可能會與模式遷移或應用程式預期相衝突。不要因為某個列名看起來很重要就添加索引；首先要確定是哪個請求速度慢，並確認實際的查詢計劃效率低下。

1. 確認 ownCloud 建置和資料庫

以 Web 伺服器帳戶身分從 ownCloud 安裝目錄執行命令。在典型的 Debian 或 Ubuntu 系統中，該帳號為www-data：

cd /var/www/owncloud
sudo -u www-data php occ status
sudo -u www-data php occ list

使用主機上設定的路徑和服務帳戶。在 Docker 中，請使用容器文件中記錄的命令格式—例如，ownCloud 手冊中使用的是 `docker run` 命令docker compose exec owncloud occ …。狀態輸出會顯示 ownCloud 版本和資料庫類型。命令清單會顯示此安裝實際支援的功能；如果資料庫修復命令未列出，請勿假定 Nextcloud 的說明也適用。

查看 ownCloud 管理員概覽中的設定警告，如果報告缺少索引，請記下確切的表名和索引名。同時記錄哪些操作速度緩慢：例如特定的文件搜尋、共用頁面、背景作業或同步操作。僅僅籠統地抱怨「ownCloud 速度慢」不足以證明需要更改架構。

ownCloud 安裝路徑下的終端機會顯示 occ list 指令，並提醒使用者查看該安裝中可用的指令。 — 使用已安裝的`occ`命令清單進行版本檢查；ownCloud 和 Nextcloud 之間的命令可用性可能有所不同。

2. 更改資料庫結構前請先備份

在進行任何索引建立、資料庫遷移或修復作業之前，請務必對資料庫和 ownCloud 配置進行一致性備份，並確保您了解如何還原備份。 ownCloud 備份指南建議在進行資料庫備份之前啟用維護模式。具體的資料庫轉儲指令取決於伺服器使用的是 MySQL、MariaDB、PostgreSQL 還是 SQLite；請使用對應的資料庫供應商工具，並妥善保管憑證和備份檔案。

sudo -u www-data php occ maintenance:mode --on
# Back up the database and ownCloud configuration with your vendor's procedure
# Confirm that the backup can be restored before proceeding

維護模式會在維護期間阻止正常使用；請為生產環境安排服務窗口。切勿複製運作中的資料庫檔案來取代資料庫感知備份。維護工作和基本檢查完成後，請將實例恢復到正常模式：

sudo -u www-data php occ maintenance:mode --off

終端檢查清單列出了維護模式、資料庫和組態備份，以及在資料庫變更之前確認復原程序。 — 在嘗試變更索引或架構之前，請確保已備份可還原的資料庫和配置。

3. 使用 ownCloud 管理的遷移來變更 ownCloud 架構

首先，請按照官方升級說明和發行說明，將 ownCloud 及其相容應用程式升級到支援的版本。 ownCloud 升級會執行資料庫遷移，從而更新資料庫架構，包括核心和應用所需的變更。官方指南建議，occ對於可能因 Web 要求逾時而導致升級逾時的大型系統，應逐步執行資料庫升級。

如果管理員概覽仍報告缺少索引，請檢查sudo -u www-data php occ list並查閱適用於您具體 ownCloud 版本的官方文件。一些第三方指南中提到了該db:add-missing-indices命令，但本文所參考的 ownCloud 10.16 資料庫命令部分並未記錄該命令。如果您的版本列出了該命令，請閱讀其本地幫助，並在運行之前與該版本的文件或應用程式供應商確認操作步驟。如果該命令不存在，請勿安裝 Nextcloud 命令、手動編輯 ownCloud 的核心表或從其他版本複製 SQL。請將警告訊息、ownCloud 版本、資料庫類型和相關日誌分享給 ownCloud 或應用程式維護者。

ownCloud 手冊中所列的資料庫指令（例如 ` db:convert-typereport` 或 ` db:convert-mysql-charsetreport`）用於執行特定的轉換任務；它們並非通用的索引調優指令。請勿使用轉換指令來嘗試提高查詢速度。

4. 使用資料庫原生工具調查慢查詢

當您發現緩慢的 SQL 查詢時，請使用資料庫提供的分析工具。 MySQL 和 MariaDB 提供 `src` 函數EXPLAIN；PostgreSQL 也提供 `src` 函數EXPLAIN，並附有自己的輸出和選項。首先，取得一個解釋查詢的計劃，而不是執行它。使用 `src` 選項時要謹慎：某些資料庫版本會執行 `src` 語句，這可能對寫入作業不安全，或在繁忙的生產資料庫上開銷很大。

EXPLAIN SELECT ... FROM oc_filecache WHERE ...;

檢查執行計劃讀取的行數是否遠超查詢傳回的行數，是否考慮了預期的索引，以及排序或連接操作是否佔據了主導地位。未被優化器選擇的索引並非一定缺失：如果查詢傳回大量行，掃描可能更經濟。在進行資料庫特定變更之前，請在具有代表性的暫存副本上比較相同的工作負載。 OwnCloud 核心 SQL 和表格佈局可能會在不同版本之間發生變化，因此今天看似有用的索引在升級後可能變得冗餘或不安全。

資料庫終端機顯示了針對 ownCloud 檔案快取表的查詢的 EXPLAIN 語句，並提醒使用資料庫供應商工具檢查查詢計畫。 — 在考慮任何自訂索引之前，請先查看真正慢的查詢的資料庫特定查詢計劃。

5. 重新檢查最初的症狀

在完成受支援的遷移或已核准的索引修復後，請再次檢查 ownCloud 管理員概覽，並查看伺服器和資料庫日誌是否有錯誤。使用類似的資料量和條件，重複執行先前速度緩慢的使用者操作或背景作業。比較回應時間、資料庫 CPU 或 I/O 以及資料庫提供的檢查行數等指標。請勿報告來自單一小型測試或無關頁面載入的效能提升。

如果警告消失但相同的操作仍然很慢，則瓶頸可能出在其他地方：儲存延遲、PHP 工作進程、網路往返、cron 任務積壓、檔案鎖定或記憶體快取。 ownCloud 建議使用記憶體快取和外部事務檔案鎖定來降低資料庫負載。這些設定與資料庫索引的工作方式不同，因此請根據官方手冊和您的部署拓撲進行配置。