關鍵字：紫金橋
；組態軟件
；SQL；曆史數據查詢
；自由報表

紫金橋監控組態軟件的內置SQLzhaxungongneng，zhuyaoyongyuzijinqiaoshishishujukuzhaxunlishishujuhebaojingjilu
，haikeyizhaxunshishishujuhetongjishuju，peiheziyoubaobiaoheqishishijiankongjian，nenggoukuaisulinghuodezhaxunxuyaoshuju。

下麵通過示例工程介紹內置SQL查詢曆史的使用方法。

首先來看一下運行時的畫麵：

示shi例li中zhong使shi用yong了le兩liang個ge時shi間jian組zu件jian，一yi個ge自zi由you報bao表biao，三san個ge按an鈕niu。查zha詢xun曆li史shi數shu據ju之zhi前qian必bi須xu先xian連lian接jie數shu據ju源yuan，右you上shang方fang有you顯xian示shi連lian接jie數shu據ju源yuan的de結jie果guo
，是shi連lian接jie正zheng常chang或huo是shi故gu障zhang。連lian接jie狀zhuang態tai顯xian示shi正zheng常chang後hou，分fen別bie選xuan擇ze查zha詢xun數shu據ju的de起qi始shi和he結jie束shu時shi間jian
，然ran後hou單dan擊ji‘查詢全部曆史’按鈕，在下麵的列表就會顯示已經查詢到的曆史數據。查詢某一時刻的曆史，選擇起始時間即可，無需選擇結束時間
，然後單擊‘查詢某刻曆史’，在報表中就能夠顯示查詢到的該時刻的曆史值了。

在組態中給各組件命名，開始時間組件的名稱是time1，結束時間組件的名稱是time2，報表名稱是fr。三個按鈕功能我們按照字麵意思理解即可。

下麵我們來看一下腳本部分：

連接數據源：

此部分隻有一行腳本
，其功能是連接‘本地’數據源
，將返回值賦給一個窗口變量，用於查看數據源連接是否成功
，連接狀態就是通過窗口變量‘ZT’做動畫連接顯示的。

ZT = #ObSql.Connect("");

查詢曆史數據：

這部分腳本分成了幾個部分
，具體見下麵的截圖：

這部分腳本內容簡單的說明一下，第一部分就是定義臨時變量，為了下麵的使用方便；第二部分是把整型的時間值（紫金橋軟件裏的時間默認都是整型值）轉換成字符型
，用於下麵拚接字符串；第三部分應該算是關鍵的部分，這裏使用了內置SQL函han數shu查zha詢xun曆li史shi數shu據ju，而er且qie字zi符fu串chuan拚pin接jie需xu要yao特te別bie注zhu意yi
，稍shao有you大da意yi就jiu會hui導dao致zhi數shu據ju查zha詢xun不bu成cheng功gong。因yin為wei是shi示shi例li工gong程cheng，隻zhi做zuo了le兩liang個ge數shu據ju點dian
，如ru果guo數shu據ju點dian較jiao多duo
，這zhe部bu分fen字zi符fu串chuan的de拚pin接jie腳jiao本ben可ke能neng要yao複fu雜za一yi些xie
；第四部分比較簡單，就是控製報表的行數
，如果本次查詢的數據少於16條，那麼報表保留16行，如果本次查詢數據多於16條，那麼按照數據的數量調整報表的行數

；最後一部分是將二維表裏的數據顯示到報表中，該循環語句中每執行一次循環，是將二維表裏的一條數據的時間
、點名、數值放到報表的一行中，這部分主要需要注意的是二維表裏數據的列號，如果取錯了列號，那就不是需要的數據了。

查詢某時刻的曆史值：

下麵來看一下查詢時刻曆史的腳本，截圖如下：

這部分腳本與查詢全部曆史的差別不是非常大。因為查詢的是某一個時刻的曆史，所以這裏隻需要一個時間點即可；關於報表行數，由於本例中隻用了兩個數據點，所以某刻的曆史隻會有兩條數據，無需控製報表行數，直接保留16行
；另外一點就是內置SQL查詢語句的字符串拚接部分略有不同。

內置SQL查詢曆史數據的功能介紹就是這樣，示例中的腳本可以靈活使用，以後會陸續發布關於內置SQL查詢的其他三個功能。