MS SQL Server 資料庫擷取
1. 設定資料庫
Section titled “1. 設定資料庫”(1) 下載並安裝 SQL Server 2012 的安裝程式，設定資料庫的 IP 位址、埠、使用者名稱和密碼。
a. IP 位址：192.168.220.29
b. 埠：1433
c. 使用者名稱：test
d. 密碼：1234
(2) 下載並安裝資料庫工具 Dbeaver。
(3) 使用 DBeaver 建立 SQL Server 連線，填寫連線伺服器的相關資訊。
(4) 建立並開啟資料庫【test】
(5) 在資料表中新增資料。
注意
- MS SQL Server 資料庫擷取外掛只能擷取到指定 時間欄位 變化時的即時資料。
- 預設擷取
dbo模式下的資料表。
2. 建立節點
Section titled “2. 建立節點”(1) 進入 CommBridge 頁面的【智慧孿生】，在左側點選切換至【裝置智聯】。
(2) 依次拖曳 MS SQL Server 資料庫擷取、資料處理和 MQTT 上傳外掛到外掛工作區，分別產生三個節點。
(3) 依次連線三個節點，連線順序：MS SQL Server 資料庫擷取 → 資料處理 → MQTT 上傳。
3. 建立方案
Section titled “3. 建立方案”(1) 按兩下【MS SQL Server 資料庫擷取】，點選【新增方案】按鈕。
(2) 填寫連線設定，點選【下一步】。
(3) 點選【新增分組】，填寫分組資訊，點選【確認】。
(4) 點選【新增資料】，填寫點位資料，點選【確認】。
(5) 點選【完成】，成功新增擷取方案。
(6) 開啟方案的開關，點選【儲存】。
4. 檢視結果
Section titled “4. 檢視結果”(1) 點選【裝置智聯】的【部署】按鈕，部署成功。
(2) 點選切換至【智慧孿生】，滑鼠移動至【MS SQL Server 資料庫擷取】節點，彈出節點資訊清單。
(3) 點選方案，檢視該方案下各分組的點位即時資料和歷史資料。
5. 設定描述說明
Section titled “5. 設定描述說明”| 參數 | 描述 | 格式 | 舉例 |
|---|---|---|---|
| 方案名稱 | 使用者自訂該方案的名稱 | 非空 | 擷取 test |
| host | 被擷取的 MS SQL Server 資料庫的 IP 位址 | 輸入點分十進位制格式的位址 | 192.168.220.154 |
| 埠 | 被擷取的 MS SQL Server 資料庫的埠號 | 輸入 1~65535 範圍的整數 | 1433 |
| 連線超時時間 | 請求呼叫 MS SQL Server 資料庫的超時時間 | 數字，範圍：(0, 擷取週期] | 2000 |
| 使用者名稱 | MS SQL Server 資料庫的連線使用者 | 非空 | |
| 密碼 | MS SQL Server 資料庫的連線密碼 | 非空 | |
| 資料庫名 | MS SQL Server 資料庫名稱 | 非空 | test |
| 同步擷取 | 支援是否同步擷取，Yes 和 No | Yes、No | YES |
| 擷取週期 | 資料讀取輪詢週期，指整個方案內的每個分組每次讀取暫存器的間隔時間 | 數字，範圍：(100,2147483647] | 2100 |
| 擷取時效性 | 分組內所有點位需在設定時間內完成擷取，否則丟棄該分組資料；該時間包含訊框延遲。 | 數字，範圍：(0, 擷取週期] | 2000 |
注意： 方案設定下的擷取週期和擷取時效性作用範圍是整個方案內點位資料
| 參數 | 前提 | 描述 | 格式 | 舉例 |
|---|---|---|---|---|
| 分組名稱 | 使用者自訂該分組的名稱 | 非空 | 分組一 | |
| 表名 | MS SQL Server 資料庫連線的資料表名稱 | 非空 | test | |
| 時間欄位 | 資料表下的清單，必須為時間欄位 | 非空 | d | |
| 時間欄位型別 | 時間欄位對應的時間型別 | 下拉式選單選擇，詳見下說明 | datetime | |
| 擷取週期 | 連線設定的同步擷取為 No | 資料讀取輪詢週期，單位 ms | 數字，範圍：(100,2147483647] | |
| 擷取時效性 | 連線設定的同步擷取為 No | 單位 ms | 數字，範圍：(0, 擷取週期] |
注意： 分組設定下的擷取週期和擷取時效性作用範圍是整個分組內點位資料 時間欄位型別：datetime、datetime2、bigint(unix timestamp in second)、bigint(unix timestamp in millisecond)、varchar(date format)
| 參數 | 描述 | 格式 | 舉例 |
|---|---|---|---|
| 資料別名 | 使用者自訂名稱，與 MS SQL Server 資料表中的欄位名稱一致 | 非空 | a |
| 計算 | 使用者根據資料別名自訂公式 |
目前該外掛支援的資料型別如下：
- 精確數字：bigint、numeric、bit、smallint、decimal、smallmoney、int、tinyint、money
- 近似數字：float、real
- 日期和時間：date、datetimeoffset、datetime2、smalldatetime、datetime、time
- 字串：char、varchar、text
- Unicode 字串：nchar、nvarchar、ntext
- 其他資料型別：uniqueidentifier