問題

如何使用 SQL 腳本手動建立或升級 BarTender 系統資料庫？

解答

有些情況下，您可能希望使用 SQL 腳本手動建立或升級 BarTender 系統資料庫，例如當第三方廠商或管理員負責管理您的 SQL Server 資料庫時，而您不想安裝 BarTender 來建立或升級系統資料庫。

建立系統資料庫

您可以依照以下步驟手動建立 BarTender 系統資料庫（不需使用系統資料庫精靈）。需要從 BarTender 主要安裝目錄（64 位元 BarTender 為 C:\Program Files\Seagull\BarTender Suite\Database，32 位元 BarTender 為 C:\Program Files (x86)\Seagull\BarTender Suite\Database）複製兩個檔案：

1. CreateDatabase.bat
2. CreateDb.sql

這些檔案必須複製到執行 SQL Server 的電腦/主機的某個目錄下。CreateDatabase.bat 是一個批次檔，用來建立系統資料庫，可以在命令提示字元或 Windows Powershell 視窗中執行。

以下是建立系統資料庫的指令與參數：

• CreateDatabase.bat <SqlInstance> [Database Name] [schema only flag] [path]
  
  • 參數說明：
    • <SqlInstance> （必填）為目標 SQL Server 的執行個體名稱。可能也需要包含電腦名稱作為執行個體名稱的一部分。例如，IEPC2\SqlExpress 代表電腦 IEPC2 上名為 'SqlExpress' 的 SQL Server 執行個體。如果只使用預設執行個體，可以只指定電腦/伺服器名稱。
    • [Database Name] （選填）資料庫名稱。如果省略此參數，將預設為 'BarTender'。
    • [schema only flag] （選填）若設為 "true"，則只會在現有資料庫檔案上建立資料庫結構。
    • [path] （選填）指定您希望資料庫實體檔案存放的位置。

• CreateDatabase /? - 顯示此說明

• CreateDatabase /L - 顯示網路上可用的 SQL Server 清單

• CreateDatabase /E - 顯示範例指令列。

範例：

• CreateDatabase.bat <InstanceName> （其中 InstanceName 為 SQL Server 及其執行個體名稱，例如：“IEPC2\SqlServer”。）這將建立一個系統資料庫，預設資料庫名稱為 "BarTender" 或 "SystemDB"，視 BarTender 版本而定。

升級系統資料庫

若要升級系統資料庫，SQL 腳本同樣位於 BarTender 安裝目錄（64 位元 BarTender 為 C:\Program Files\Seagull\BarTender Suite\Database，32 位元 BarTender 為 C:\Program Files (x86)\Seagull\BarTender Suite\Database）。這些檔案名稱通常為 UpgradeDB.sql 到 UpgradeDB_1.x_to_1.y.sql。同樣需要將這些腳本複製到執行 SQL Server 的電腦/主機的某個目錄下。

升級步驟如下：

1. 使用管理主控台或系統資料庫 UI 查詢目前的系統資料庫結構版本，應該會顯示為 "1.x"。
   
2. 在 SQL Server Management Studio 中，依序開啟並執行所有 UpgradeDB_1.x_to_1.y.sql 腳本，從與您目前結構版本相符的檔案開始。例如，如果目前結構版本為 1.30，請先執行 "UpgradeDB_1.30_to_1.40.sql"，然後依序執行所有更高版本。請注意，每個 UpgradeDB 腳本都會用到參數 [$(dbname)]，您需要在每個腳本中將其替換為系統資料庫的實際名稱。