> ## 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.

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

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

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

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

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

支援以下目標資料庫：

* SQL Server
* MySQL
* PostgreSQL

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

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

## 移轉應用程式資料庫

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

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

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

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

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

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

6. 移轉成功後，系統會提供連接字串。

7. 將該連接字串新增到配置中。具體步驟取決於您的平臺：

   * **跨平臺版：** 將該字串新增到配置中（請參閱[配置跨平臺應用程式資料庫](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/getting-started/installation/cross-platform-edition.md#配置應用程式資料庫)）。更新配置以指向新資料庫後，重新啟動 知行之橋。

   * **.NET 版：** 移轉完成後，知行之橋 會保持安全模式，直到套用新的連接字串並重新啟動 知行之橋。在此期間背景服務保持停止狀態，不會處理檔案和交易。點選**複製**複製連接字串，然後更新 `Web.Config` 中的 `AppDb` 項目：

     1. 開啟 `Web.Config` 並找到 `<connectionStrings>` 部分（請務必取消該部分的註解）。

     2. 新增或取代 `AppDb` 項目，內容如下，其中 `<ConnectionString>` 為您複製的連接字串：

        ```xml theme={null}
        <add name="AppDb" connectionString="<ConnectionString>" providerName="System.Data.CData.PostgreSQL" />
        ```

        此範例使用 PostgreSQL。對於 SQL Server，請將 `providerName` 設定為 `System.Data.CData.SQL`；對於 MySQL，請設定為 `System.Data.CData.MySQL`。有關詳細資訊，請參閱[配置 .NET 應用程式資料庫](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/getting-started/installation/windows-edition.md#配置應用程式資料庫)。

     3. 儲存 `Web.Config`。知行之橋 會自動重新啟動，無需手動重新啟動。

## 安全模式行為

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

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

## 恢復與彈性

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.