> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kasoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 應用程式資料庫移轉實用程式

> 如何將知行之橋應用程式資料從嵌入式資料庫移轉到外部資料庫。

export const siteNameShort = "知行之橋";

export const siteName = "知行之橋";

應用程式資料庫移轉實用程式允許管理員將 {siteName} 後端應用程式資料從嵌入式資料庫移轉到外部資料庫。移轉引擎會自動檢測嵌入式資料庫並執行移轉。不同平臺使用的嵌入式資料庫如下：

* 跨平臺版本：H2
* .NET 版本：SQLite

嵌入式資料庫在大規模場景下的效能和並行存取限制，是使用此實用程式的常見原因。

支援以下目標資料庫：

* SQL Server
* MySQL
* PostgreSQL

移轉會將後端資料庫中的所有表移到目標資料庫，包括交易日誌、訊息日誌、審計日誌、端口狀態、SLA 狀態資料以及常規應用程式資料。

開始之前，請選擇合適的移轉時間，因為強制啟用的安全模式會阻止所有檔案處理。建議在計劃維護視窗中執行。

## 移轉應用程式資料庫

要啟動該實用程式，請轉到**系統設定 > 高階**，滾動到**移轉**部分，然後選擇**應用程式資料庫移轉**。

1. 高可用性 (HA) 部署不支援應用程式資料庫移轉。必須停止所有其他 {siteNameShort} 節點，並確認它們均已停止。勾選**我瞭解必須停止所有其他 HA 節點**，然後點選**下一步**。

2. 必須進入[安全模式](#安全模式行為)才能繼續。安全模式會停用所有後臺服務、停止所有端口並阻止入站端點，以確保移轉期間的資料完整性。點選**進入安全模式**。

3. 點選**選擇資料庫**，選擇目標資料庫型別，然後提供目標資料庫的連線詳情。

4. 點選**測試連線**驗證連線。

5. 點選**開始移轉**。系統會逐表移轉資料。移轉時間取決於資料量，可能需要幾分鐘到數小時。

6. 移轉成功後，系統會提供連接字串。將該字串新增到配置中。平臺相關說明請參閱[配置跨平臺應用程式資料庫](../../installation/cross-platform-edition#configure-the-application-database)或[配置 .NET 應用程式資料庫](../../installation/windows-edition#配置應用程式資料庫)。

7. 更新配置以指向新資料庫後，重新啟動 {siteNameShort}。

## 安全模式行為

移轉開始時，{siteNameShort} 會進入\_安全模式\_，使整個應用程式無法向當前資料庫寫入資料：

* 所有端口停止，因此不會傳送或接收檔案。
* 自動化、SLA 監控、端口監控、計劃報表和磁碟空間監控等後臺服務暫停。
* API 請求、Webhook、Flow API 呼叫、SFTP Server 連線和電子郵件收件箱等入站端點均被阻止並傳回錯誤。
* UI 受限：所有已登入使用者都會看到**安全模式已啟用**訊息，移轉完成前無法執行正常操作。
* 管理員可以使用移轉的**開始**、**中止**和**監控進度**控制項。
* 非管理員只能檢視安全模式狀態，不能管理移轉；連接字串詳情會被隱藏。

## 恢復與彈性

* 崩潰恢復：如果 {siteNameShort} 處理程序在移轉期間意外終止，移轉狀態會儲存在後端資料庫中。重新啟動後，{siteNameShort} 會檢測到未完成的移轉，並允許從中斷處繼續。
* 恢復期間後臺服務保持暫停，直到明確完成或取消移轉。