TARS云服務工具
# FastWeb TARS云服務工具
- 適用平臺：WEB(桌面)，APP(移動端)
注意
??TARS云服務工具的功能模塊僅支持在獨立服務器下使用，集群模式不適用。
# 1. TARS說明
??FastWeb中集成了TARS的部分界面的管理功能，可在頁面上直接控制TARS的設置以及運行，停止運行，重啟服務等相關的操作。在使用此功能前，請先在 FastWeb配置中心 中設置好TARS的安裝目錄。
開啟服務
??如需要開啟服務的，點擊[開啟服務]按鈕，啟動運行。
停止服務
??如需要停止服務運行的，點擊[停止服務]按鈕，停止服務的運行。
重啟服務
??在更改過相關的設置后，點擊[重啟服務]，TARS服務將會重新啟動。請在每次修改過TARS的設置并保存設置后，點擊[重啟服務]以使設置生效。
# 2. 日志
??日志欄用于顯示客戶端訪問服務端的各種日志信息。
# 3. 數(shù)據(jù)庫設置
??管理數(shù)據(jù)庫連接配置，支持多種數(shù)據(jù)庫以及多聯(lián)方式。
??圖中按鈕部分內(nèi)容說明如下：
[添加]打開編輯窗口新增數(shù)據(jù)庫連接設置。[修改]選擇列表中的連接設置，編輯數(shù)據(jù)庫連接設置。[刪除]刪除選中的數(shù)據(jù)庫設置。[刷新]刷新數(shù)據(jù)庫的顯示。
??列表中各表名稱釋義如下：
- 連接名稱： TARS的連接設置的名稱，此名稱作為連接參數(shù)使用，用于指定要連接的數(shù)據(jù)庫等信息。
- 數(shù)據(jù)庫類型： 連接設置指定的此連接的數(shù)據(jù)庫的類型，例如
MySQL、SQLite等。 - 數(shù)據(jù)庫： 設置連接的數(shù)據(jù)庫的名稱。
- 連接池： 是否為此連接設置設立連接池，設置連接池可提高連接的利用率。
- 最大值： 連接池中允許的連接線程的最大數(shù)目。
- 刪除權限： 該連接設置是否對數(shù)據(jù)庫有刪除權限，當刪除權限被禁用后，使用此連接設置連接的客戶端不能對表執(zhí)行
DELETE語句操作。存儲過程除外。 - 插入權限： 該連接設置是否對數(shù)據(jù)庫有插入權限，當插入權限被禁用后，使用此連接設置連接的客戶端不能對表執(zhí)行
INSERT語句操作。存儲過程除外。 - 更新權限： 該連接設置是否對數(shù)據(jù)庫有更新權限，當插入權限被禁用后，使用此連接設置連接的客戶端不能對表執(zhí)行
INSERT語句操作。存儲過程除外。 - DDL權限： 該連接設置是否對數(shù)據(jù)庫是否有DDL(數(shù)據(jù)庫定義)權限，比如創(chuàng)建表，刪除表，更改表結(jié)構等權限，當此權限被禁用后，使用此連接設置連接的客戶端不能對執(zhí)行表結(jié)構更新的相關操作。存儲過程除外。
- 啟用： 連接設置是否啟用，只有在啟用狀態(tài)下可以通過此連接涉資連接至數(shù)據(jù)庫。如果設置為禁用，則該連接設置不可用。
- 更新時間： 連接設置的更新時間，在經(jīng)過編輯修改后時間會更新。
- 備注： 連接設置的備注信息，在紡織印染業(yè)ERP中備注信息會作為產(chǎn)品版本區(qū)分的依據(jù)。
# 3.1. 添加、修改數(shù)據(jù)庫
??如需要添加數(shù)據(jù)庫，點擊[添加]按鈕，打開添加數(shù)據(jù)庫的界面。
??窗口中的設置項說明如下：
- 連接名稱： TARS的連接設置的名稱，此名稱作為連接參數(shù)使用，用于指定要連接的數(shù)據(jù)庫等信息。
- 連接設置： TARS連接的相關設置，通過雙擊打開設置對話框進行設置。
- 開啟數(shù)據(jù)池： 是否為此連接設置設立連接池，設置連接池可提高連接的利用率。
- 開啟刪除權限： 該連接設置是否對數(shù)據(jù)庫有刪除權限，當刪除權限被禁用后，使用此連接設置連接的客戶端不能對表執(zhí)行
DELETE語句操作。存儲過程除外。 - 開啟插入權限： 該連接設置是否對數(shù)據(jù)庫有插入權限，當插入權限被禁用后，使用此連接設置連接的客戶端不能對表執(zhí)行
INSERT語句操作。存儲過程除外。 - 開啟更新權限： 該連接設置是否對數(shù)據(jù)庫有更新權限，當插入權限被禁用后，使用此連接設置連接的客戶端不能對表執(zhí)行
INSERT語句操作。存儲過程除外。 - 開啟DDL權限： 該連接設置是否對數(shù)據(jù)庫是否有DDL(數(shù)據(jù)庫定義)權限，比如創(chuàng)建表，刪除表，更改表結(jié)構等權限，當此權限被禁用后，使用此連接設置連接的客戶端不能對執(zhí)行表結(jié)構更新的相關操作。存儲過程除外。
- 池 清理時間(ms)： 設置連接池的默認清理時間間隔。
- 池 過期時間(ms)： 設置連接池的默認過期時間間隔。
- 池 最大連接數(shù)： 連接池中允許的連接線程的最大數(shù)目。
- 是否啟用： 連接設置是否啟用，只有在啟用狀態(tài)下可以通過此連接涉資連接至數(shù)據(jù)庫。如果設置為禁用，則該連接設置不可用。
??按照要求填寫完成后，點擊[保存]按鈕。
??修改數(shù)據(jù)庫的界面顯示同上。
# 3.2. 使用TARS連接至MSSQL Server
??TARS支持 Microsoft SQL Server Standard 和 Express 版本 2000 及更高版本，以及 Microsoft SQL Azure。支持連接的MSSQL類型為Microsoft SQL Server。
??點擊[添加]按鈕，打開添加數(shù)據(jù)庫對話框，在連接設置處的編輯框雙擊，打開數(shù)據(jù)庫連接設置的對話框，在Driver ID處選擇MSSQL，在下方的界面中設置連接。其中的參數(shù)說明如下：
- DriverID： 連接的數(shù)據(jù)庫類型，此處默認設置為
MSSQL。 - Pooled： 是否使用連接池。
- Database： 設置數(shù)據(jù)庫的名稱。
- User_Name： 設置數(shù)據(jù)庫連接的用戶名稱。
- Password： 設置數(shù)據(jù)庫連接的密碼。
- MonirotBy： 設定監(jiān)控類型。可輸入以下類型的內(nèi)容。
FlatFile：將跟蹤輸出到純文本文件。 當應用程序完成時，它會顯示生成的跟蹤文件列表。Remote：將跟蹤輸出到FDMonitor 實用程序并允許監(jiān)視應用程序。 在激活跟蹤輸出之前，F(xiàn)DMonitor必須正在運行。Custom：將跟蹤輸出到自定義事件處理程序。
- ODBC_Advanced： 允許您指定ODBC連接參數(shù)，設置方式為 參數(shù)名稱=值，各取值對以";"分隔，MSSQL不需要設置此參數(shù)值。
- Login Timeout： 控制嘗試建立連接時應用程序超時之前的時間量（以秒為單位）， 0 指定無限等待（默認值）。
- Server： 設置連接的服務器的名稱。
- Network： 網(wǎng)絡庫動態(tài)鏈接庫的名稱，該名稱不需要包含路徑，并且不得包含 .dll 文件擴展名。
- Address： 運行 SQL Server 實例的服務器的網(wǎng)絡地址。 地址通常是服務器的網(wǎng)絡名稱，但也可以是其他名稱，例如管道或 TCP/IP 端口和套接字地址。
- OSAuthent： 設置OS驗證。如果此項設置為
Yes則在連接本地的使用用戶賬戶連接的數(shù)據(jù)庫時不需要提供用戶名和密碼。 - MARS： 設置數(shù)據(jù)庫是否使用連接復用。
- Workstation： 工作站 ID。通常為應用程序所在計算機的網(wǎng)絡名稱（可不填）。 如果指定，此值存儲在
master.dbo.sysprocesses列主機名中，并由sp_who和Transact-SQL HOST_NAME函數(shù)返回。 - Language： SQL Server 語言名稱（可選）。 連接到具有多種語言的 SQL Server 時，Language指定用于連接的消息集。
- Encrypt： 設置網(wǎng)絡連接是否進行加密。
Yes：網(wǎng)絡連接加密。No：網(wǎng)絡連接不加密。
- VariantFormat： 控制 SQL_VARIANT 數(shù)據(jù)類型表示。
String：數(shù)據(jù)類型表示為 dtWideString。 字符串值作為十六進制字符串返回，數(shù)字作為字符串返回，依此類推。 這是默認值。Binary：數(shù)據(jù)類型表示為帶有原始數(shù)據(jù)表示的 dtByteString。 字符串值作為具有原始編碼、二進制格式的數(shù)字等的字符串返回。
- ExtendedMetaData： 設置查詢結(jié)果集的擴展描述。
True：獲取除其他列屬性之外的字段原始表和列。 將此選項設置為 True 可能會減慢數(shù)據(jù)集的打開速度。False：使用有關查詢列的受限信息。 這是默認值。
- ApplicationName： 應用程序的名稱。 如果指定，此值存儲在
master.dbo.sysprocesses的列program_name中，并由sp_who和Transact-SQL APP_NAME函數(shù)返回。 - MetaDefCatalog： 默認數(shù)據(jù)庫名稱。 如果目錄名稱等于 MetaDefCatalog，則設計時代碼會從對象名稱中排除目錄名稱。
- MetaDefSchema： 默認架構名稱。 如果架構名稱等于 MetaDefSchema，則設計時代碼會從對象名稱中排除架構名稱。默認的數(shù)據(jù)庫中架構名稱為
dbo。 - MetaCurCatalog： 指定應用程序的當前目錄。 如果未指定，則從數(shù)據(jù)庫管理系統(tǒng)中接收其值。 如果應用程序要求提供元數(shù)據(jù)而您沒有指定目錄名稱，則會隱式使用當前目錄。
- MetaCurSchema： 指定應用程序的當前架構。 如果未指定，則從數(shù)據(jù)庫管理系統(tǒng)中接收其值。 如果應用程序要求提供元數(shù)據(jù)而您沒有指定架構名稱，則 FireDAC 會隱式使用當前架構。
- MetaCaseIns： 設置元數(shù)據(jù)是否區(qū)分大小寫。
True：使用不區(qū)分大小寫的元數(shù)據(jù)搜索。False：取決于數(shù)據(jù)庫的設置，此項為默認設置。
- MetaCaseInsCat： 設置 SQL Server 目錄名稱區(qū)分大小寫。
Choose：自動監(jiān)測目錄名稱區(qū)分大小寫，此項為默認值。False：目錄名稱區(qū)分大小寫。True：目錄名稱不區(qū)分大小寫。
??設置完成后，可點擊[Test]來連接測試設置的內(nèi)容是否填寫正確。測試完成后，點擊[OK]按鈕返回至添加數(shù)據(jù)庫界面，設置其他項目，點擊[保存]按鈕保存設置。點擊[重啟服務]使設置生效。
# 3.3. 使用TARS連接至MySQL Server
??TARS支持連接的MySQL Server包括:
- MySQL Server Community, Enterprise, and Embedded editions version 3.21 以及更高版本。
- MariaDB 5.5以及更高版本。
??點擊[添加]按鈕，打開添加數(shù)據(jù)庫對話框，在連接設置處的編輯框雙擊，打開數(shù)據(jù)庫連接設置的對話框，在Driver ID處選擇MySQL，在下方的界面中設置連接。其中的參數(shù)說明如下：
- DriverID： 數(shù)據(jù)連接的類型，在創(chuàng)建選擇時會自動生成。
- Pooled： 是否設置連接池，連接池的設置可以提高連接線程的利用率，提高運行效率。
- DataBase： 數(shù)據(jù)庫的名稱，需設置數(shù)據(jù)庫的連接。
- User_Name： 連接的數(shù)據(jù)庫用戶名稱。
- Password： 連接的數(shù)據(jù)庫用戶密碼。
- MonirotBy： 設定監(jiān)控類型。
FlatFile：將跟蹤輸出到純文本文件。 當應用程序完成時，它會顯示生成的跟蹤文件列表。Remote：將跟蹤輸出到FDMonitor 實用程序并允許監(jiān)視應用程序。 在激活跟蹤輸出之前，F(xiàn)DMonitor 必須正在運行。Custom：將跟蹤輸出到自定義事件處理程序。
- Server： 設置連接的服務器的名稱。
- Port： 設置連接的服務器的端口信息。
- Compress： 指定為
True以啟用網(wǎng)絡流量壓縮，False表示為不啟用網(wǎng)絡流量壓縮。 - UseSSL： 指定
True以啟用SSL連接。 默認情況下，它設置為False。 設置UseSSL=True需要您額外指定連接定義參數(shù)，此部分內(nèi)容需附在UseSSL之后。- SSL_key -- 密鑰文件的路徑名。
- SSL_cert -- 證書文件的路徑名。
- SSL_ca -- 證書頒發(fā)機構文件的路徑名。
- SSL_capath -- 包含 pem 格式的可信 SSL CA 證書的目錄的路徑名。
- SSL_cipher -- 用于 SSL 加密的允許密碼列表。
- LoginTimeout： 設置嘗試建立連接時應用程序超時之前的時間量（以秒為單位）。
- ReadTimeout： 嘗試從服務器讀取的超時時間（以秒為單位）。 每次嘗試都使用此超時值，并且在必要時進行重試，因此總有效超時值是選項值的三倍。 您可以設置該值，以便在
TCP/IP Close_Wait_Timeout設定值的10 分鐘之前檢測到丟失的連接。 此選項僅適用于 TCP/IP 連接，并且在Windows 版本的MySQL 5.1.12 之前。 默認情況下該選項未設置。 - WriteTimeout： 嘗試寫入服務器的超時（以秒為單位）。 每次嘗試都使用此超時值，如有必要，還會進行
net_retry_count重試，因此總有效超時值是net_retry_count乘以選項值。 此選項僅適用于 TCP/IP 連接，并且在Windows 版本的MySQL 5.1.12 之前。 默認情況下未設置。 - ResultMode： 對客戶端的結(jié)果集的獲取。 默認值為
Store。Store：在查詢執(zhí)行后立即獲取所有行并將它們存儲在客戶端上，使服務器進程為新請求做好準備。Use：根據(jù)需要從客戶端獲取行。 在獲取結(jié)果集中的所有行之前，服務器無法處理新請求。 它允許您減少非常大的結(jié)果集的內(nèi)存使用量。Choose：自動選擇一種模式。
- CharacterSet： 連接的默認字符集。 連接排序規(guī)則成為字符集的默認排序規(guī)則。 有關詳細信息，請參閱MySQL
SET NAMES語句。通常情況下此選項設置為utf8mb4。 - TinyIntFormat： 設置 TinyInt(1)數(shù)據(jù)類型表示。 默認值為
Boolean。Boolean： TinyInt(1)列表示為dtBoolean。Integer：TinyInt(1) 列表示為dtSByte或dtByte。
- MetaDefCatalog： 默認數(shù)據(jù)庫名稱。 如果目錄名稱等于 MetaDefCatalog，則設計時代碼會從對象名稱中排除目錄名稱。
- MetaCurCatalog： 指定應用程序的當前目錄。 如果未指定，則從 DBMS 接收其值。 如果應用程序要求提供元數(shù)據(jù)而您沒有指定目錄名稱，則會隱式使用當前目錄。
??設置完成后，可點擊[Test]來連接測試設置的內(nèi)容是否填寫正確。測試完成后，點擊[OK]按鈕返回至添加數(shù)據(jù)庫界面，設置其他項目，點擊[保存]按鈕保存設置。點擊[重啟服務]使設置生效。
# 3.4. 使用TARS連接至SQLite
??TARS本機驅(qū)動程序支持 SQLite 數(shù)據(jù)庫版本 3.0 及更高版本。
??點擊[添加]按鈕，打開添加數(shù)據(jù)庫對話框，在連接設置處的編輯框雙擊，打開數(shù)據(jù)庫連接設置的對話框，在Driver ID處選擇SQLite，在下方的界面中設置連接。其中的參數(shù)說明如下：
- DriverID： 數(shù)據(jù)連接的類型，在選擇新建數(shù)據(jù)庫類型時創(chuàng)建。
- Pooled： 是否設置連接池，連接池的設置可以提高連接線程的利用率，提高運行效率。
- DataBase： 數(shù)據(jù)庫的路徑。 使用 ':memory:' 或空字符串創(chuàng)建并連接到空的內(nèi)存數(shù)據(jù)庫。 路徑可以包含路徑變量。
- User_Name： 連接的數(shù)據(jù)庫用戶名稱，SQLite中此項不需設置。
- Password： 指定加密數(shù)據(jù)庫的密碼。 該值可能具有以下形式：[ aes-128 | aes-192 | aes-256 | aes-ctr-128 | aes-ctr-192 | aes-ctr-256 | aes-ecb-128 | aes-ecb-192 | aes-ecb-256 :] <password> 可選前綴控制要使用的密碼算法。 默認值為空字符串，表示未加密模式。
- MonirotBy： 設定監(jiān)控類型。
FlatFile：將跟蹤輸出到純文本文件。 當應用程序完成時，它會顯示生成的跟蹤文件列表。Remote：將跟蹤輸出到FDMonitor 實用程序并允許監(jiān)視應用程序。 在激活跟蹤輸出之前，F(xiàn)DMonitor 必須正在運行。Custom：將跟蹤輸出到自定義事件處理程序。
- OpenMode： 設定打開數(shù)據(jù)庫的模式：
CreateUTF8：打開一個數(shù)據(jù)庫來讀或?qū)憽?如果數(shù)據(jù)庫不存在，將使用 UTF8 默認編碼創(chuàng)建。CreateUTF16：打開一個數(shù)據(jù)庫來讀或?qū)憽?如果數(shù)據(jù)庫不存在，將使用 UTF16 默認編碼創(chuàng)建。ReadWrite：打開一個數(shù)據(jù)庫來讀或?qū)憽?如果數(shù)據(jù)庫不存在，則會引發(fā)異常。ReadOnly：打開一個數(shù)據(jù)庫為只讀。 如果數(shù)據(jù)庫不存在，則會引發(fā)異常。
- Encrypt： 指定數(shù)據(jù)庫的默認加密模式。 可以使用可選的密碼前綴覆蓋該模式。 如果未指定，則使用此參數(shù)指定的模式。 否則，使用
aes-256。 - BusyTimeout： 當表被鎖定時設置一個毫秒時間使進入休眠狀態(tài)。 零意味著不等待。 默認值為 10000。
- CacheSize： 更改 SQLite 一次保存在內(nèi)存中的最大數(shù)據(jù)庫磁盤頁面數(shù)。 每個頁面使用大約 1.5K 的內(nèi)存。 默認值為 10000。
- SharedCache： 啟用或禁用 SQLite 共享緩存功能。默認值是
True。 - LockingMode： 設置數(shù)據(jù)庫連接鎖定模式。 該值是以下之一：
Normal：此模式允許多用戶訪問數(shù)據(jù)庫文件。Exclusive：此模式可提供最高性能。 ??默認值為Exclusive，因為它允許您獲得單用戶應用程序的最大讀/寫速度。
- Synchronous： 設置內(nèi)存緩存與數(shù)據(jù)庫文件的數(shù)據(jù)庫連接同步模式。 該值是以下之一：
Full：在每一個關鍵時刻同步。Normal：如上所述，但頻率較低。Off：提供最佳性能。 這是默認值。
- JournalMode： 設置日志模式。
Delete： 默認模式。在該模式下，在事務結(jié)束時，日志文件將被刪除。Truncate：日志文件被截斷為零字節(jié)長度。Persist：日志文件被留在原地，但頭部被重寫，表明日志不再有效。Memory： 日志記錄保留在內(nèi)存中，而不是磁盤上。WAL：日志記錄被單獨寫入至更改文件中。Off：關閉日志文件的功能。
- ForeignKeys： 當應用程序使用 SQLite v 3.6.19 或更高版本時，為數(shù)據(jù)庫連接啟用外鍵使用。 該值是以下之一：
On：啟用會話中的外鍵。 這是默認值。Off：會話中的外鍵被禁用。
- **StringFormat：**定義如何表示字符串值：
Choose：表示為ftString / ftWideString / ftMemo / ftWideMemo，取決于聲明的數(shù)據(jù)類型名稱（默認）；Unicode：表示為ftWideString / ftWideMemo；ANSI：始終表示為ftString / ftMemo。
- GUIDFormat： 定義如何存儲 GUID 值：
String：將 GUID 存儲為字符串值（默認）。Binary：將 GUID 存儲為二進制字符串值。
- DateTimeFormat： 定義如何存儲日期和時間值：
String：使用 YYYY-MM-DD 和 HH:MM:SS.XXX 格式（默認）將日期和時間存儲為字符串值。Binary：將日期和時間存儲為實數(shù)，即儒略日期。DateTime：將日期和時間存儲為一個實數(shù)，它是一個TDateTime值。
- Extensions： 啟用、禁用或指定要加載的 SQLite 引擎擴展：
True：啟用擴展。False：禁用擴展（默認）。 ??否則，使用擴展列表以 <library>[=<entry point>][;...] 的形式加載。
- SQLiteAdvanced： 其他 SQLite 數(shù)據(jù)庫連接選項。參考SQLite參數(shù)說明 (opens new window)文檔進行填寫。
- MetaDefCatalog： 默認數(shù)據(jù)庫名稱。 如果目錄名稱等于 MetaDefCatalog，則設計時代碼會從對象名稱中排除目錄名稱。
- MetaCurCatalog： 指定應用程序的當前目錄。 如果未指定，則從數(shù)據(jù)庫管理系統(tǒng)中接收其值。 如果應用程序要求提供元數(shù)據(jù)而您沒有指定目錄名稱，則會隱式使用當前目錄。
??設置完成后，可點擊[Test]來連接測試設置的內(nèi)容是否填寫正確。測試完成后，點擊[OK]按鈕返回至添加數(shù)據(jù)庫界面，設置其他項目，點擊[保存]按鈕保存設置。點擊[重啟服務]使設置生效。
# 3.5. 使用TARS連接至Access
??TARS本機驅(qū)動程序支持 Microsoft Access 95、97、2000、2003、2007 和 2010 以及之后版本的數(shù)據(jù)庫。
??點擊[添加]按鈕，打開添加數(shù)據(jù)庫對話框，在連接設置處的編輯框雙擊，打開數(shù)據(jù)庫連接設置的對話框，在Driver ID處選擇MSAcc，在下方的界面中設置連接。其中的參數(shù)說明如下：
- DriverID： 數(shù)據(jù)連接的類型，在選擇新建數(shù)據(jù)庫類型時創(chuàng)建，此處顯示的類型為
MsAcc。 - Pooled： 是否設置連接池，連接池的設置可以提高連接線程的利用率，提高運行效率。
- DataBase： MDB 文件的路徑。 路徑可以包括路徑變量。
- User_Name： 連接的數(shù)據(jù)庫用戶名稱。
- Password： 指定加密數(shù)據(jù)庫的密碼。
- MonirotBy： 設定監(jiān)控類型。
FlatFile：將跟蹤輸出到純文本文件。 當應用程序完成時，它會顯示生成的跟蹤文件列表。Remote：將跟蹤輸出到FDMonitor 實用程序并允許監(jiān)視應用程序。 在激活跟蹤輸出之前，F(xiàn)DMonitor 必須正在運行。Custom：將跟蹤輸出到自定義事件處理程序。
- ODBCAdvanced： 允許您指定任何其他附加 ODBC 連接參數(shù)值。 默認值為“ExtendedAnsiSQL=1”。
- LoginTimeout： 設置嘗試建立連接時應用程序超時之前的時間量（以秒為單位）。
- SystemDB： 系統(tǒng)數(shù)據(jù)庫文件的路徑。 路徑可以包括路徑變量。
- ReadOnly： 指定
True以只讀模式打開數(shù)據(jù)庫。False是默認值。 - StringFormat： 定義如何表示字符串值：
Choose：表示為ftString / ftWideString / ftMemo / ftWideMemo，取決于聲明的數(shù)據(jù)類型名稱（默認）；Unicode：表示為ftWideString / ftWideMemo；ANSI：始終表示為ftString / ftMemo。
??設置完成后，可點擊[Test]來連接測試設置的內(nèi)容是否填寫正確。測試完成后，點擊[OK]按鈕返回至添加數(shù)據(jù)庫界面，設置其他項目，點擊[保存]按鈕保存設置。點擊[重啟服務]使設置生效。
# 4. 參數(shù)設置
??參數(shù)設置部分包括常規(guī)設置、Web服務、消息服務、MQTT服務、短信驗證、REST/SSL、驅(qū)動類型、黑白名單、日志、雪花算法、微信公眾平臺、數(shù)據(jù)備份、日志、其它等內(nèi)容。
# 4.1. 常規(guī)設置
??圖中內(nèi)容說明如下：
[常規(guī)設置]-常規(guī)- HTTP端口： HTTP協(xié)議代理服務器端口，默認的端口號為9981。
- HTTTPS端口： HTTPS協(xié)議代理服務器端口，只有在配置了SSL的情況下才可啟用該選項，默認的端口號為443。
- 數(shù)據(jù)壓縮級別： 數(shù)據(jù)壓縮后，客戶端調(diào)用數(shù)據(jù)相對會提高效率。可選擇項包括：不壓縮(
cNone)、快速壓縮(cFast)、缺省壓縮(cDefault)、最大壓縮(cMax)4種。 - 線程池最大數(shù)： 設定數(shù)據(jù)連接的線程數(shù)目，通常設定為CPU個數(shù) * 25，超過這個值系統(tǒng)的運行可能會不穩(wěn)定（僅限于服務器，普通PC的上限數(shù)值更低）。
- 下行最大速度： 設定下行數(shù)據(jù)傳輸?shù)淖畲笏俾剩J設置為0，表示為不限制下行速率。
- IP版本： IP地址類型，包括：rct_IPv4、rct_IPvOS4、rct_IPv6、rct_IPvOS6。
- 最大連接數(shù)： 程序允許的客戶端同時在線連接數(shù)。
- 上行最大速度： 設定上行數(shù)據(jù)傳輸?shù)淖畲笏俾剩J設置為0，表示為不限制上行速率。
- 客戶端空閑時間： 客戶端連接狀態(tài)保持時間。對于網(wǎng)絡不穩(wěn)定的環(huán)境可將數(shù)值設置小一些。
[常規(guī)設置]-遠程函數(shù)- 模塊文件名： 自定義的遠程模塊函數(shù)名稱，默認為
/RemoteFunction。 - 加密數(shù)據(jù)： 中間件進行數(shù)據(jù)交互時采用加密傳輸，默認未勾選。
- 通訊安全碼： 客戶端與中間件交互時，需要提供通訊安全碼。此項需要勾選
[加密數(shù)據(jù)]才有效。 - 驗證用戶身份： 勾選表示客戶端與中間件交互時，需要進行身份驗證。
- 用戶數(shù)據(jù)庫： 指用驗證用戶所在數(shù)據(jù)庫的連接名稱。此項在
驗證用戶身份勾選時可用。 - 全局MD5鹽值： MD5加鹽值，使數(shù)據(jù)庫更加安全。
- Token有效期： Token是服務端生成的一串字符串，以作客戶端進行請求的一個令牌，當?shù)谝淮蔚卿浐螅掌魃梢粋€Token便將此Token返回給客戶端，以后客戶端只需帶上這個Token前來請求數(shù)據(jù)即可，無需再次帶上用戶名和密碼。
- Token鎖類型： 設定Token鎖的類型，有無鎖(
SesNoLock)、IP鎖(SesIPLock)、請求鎖(SesFwdLock)、倍乘鎖(SesIPFwdLock)等類型。
- 模塊文件名： 自定義的遠程模塊函數(shù)名稱，默認為
[常規(guī)設置]-文件傳輸- 存儲目錄： 文件根目錄。
- 文件不超過MB： 可指定文件大小限制，防止大文件傳輸，造成服務器壓力。
- 使用單一根目錄： 勾選此項，以文件根目錄為文件目錄。
# 4.2. Web服務
??TARS的Web服務支持小型WEB網(wǎng)站架構，支持JS、HTML網(wǎng)頁。
??圖中內(nèi)容說明如下：
[Web服務]-常用- 開啟Web服務： 勾選以啟用Web服務。
- Web根目錄： Web網(wǎng)站內(nèi)容目錄。
- Response Headers： 填寫請求頭的類型。
[Web服務]-內(nèi)容類型- 默認首頁：設定自動打開的默認首頁的文件名稱類型。
- Content Types：設定顯示內(nèi)容的類型。
示例： 按照以上方式開啟Web服務后，可將靜態(tài)的網(wǎng)頁項目文件放置至TARS設置的目錄下。然后打開本機瀏覽器，輸入http://localhost:8809/ (opens new window)打開對應的網(wǎng)頁頁面。頁面顯示如下圖。
# 4.3. 消息服務
??WebSocket消息服務。
??圖中內(nèi)容說明如下：
WebSocket消息服務： 勾選啟用WebSocket消息服務。
模塊文件名稱： WebSocket消息服務模塊文件名，設置后，可使用
ws://<host>:<port>/WebSocket來發(fā)起WebSocket連接。遠程函數(shù)消息服務： 勾選啟用遠程函數(shù)消息服務。
模塊文件名稱： 遠程函數(shù)消息服務模塊文件名。
示例：
??該功能需配合網(wǎng)頁端的WebSocket功能來使用，此處可打開WebSocket測試網(wǎng)站 (opens new window)來進行相關測試。
??在測試頁面的地址框中輸入TARS的地址，比如TARS本機的IP地址為192.168.0.201，開放的端口號為8809，消息提示函數(shù)名稱為WebSocket，則對應的WebSocket地址設置為ws://192.168.0.201:8809/WebSocket。點擊[連接]。待服務端回應Hello,Web Socket Client!時表示連接成功。此時可在網(wǎng)頁頁面底部的待發(fā)信息欄中輸入要發(fā)送的信息，點擊[發(fā)送]按鈕。
# 4.4. MQTT服務
??勾選開啟MQTT服務，可啟動TARS中間件MQTT Broker，供MQTT Client連接使用，默認端口1883。
??圖中內(nèi)容說明如下：
開啟MQTT服務： 勾選是否開啟MQTT的服務，默認為開啟。
端口： MQTT服務的端口，默認為1883。
監(jiān)視客戶端： 勾選后，可查看連接的客戶端的狀態(tài)。
允許客戶端匿名訪問： 勾選后允許客戶端不設置客戶端ID進行MQTT連接訪問。
示例： 按照上述方式設置完成后，可使用Smart的MQTTClient控件使用范例進行MQTT的連接測試，運行范例后，將MQTT服務端的地址更改為TARS服務端的地址，點擊
連接啟用連接。輸入要發(fā)送的內(nèi)容，點擊下方的發(fā)送按鈕，如果彈出消息提示框則MQTT連接成功。
# 4.5. 短信驗證
??短信驗證采用新版的阿里云通信短信接口，賬號申請、獲取Access Key Id 與Access Key Secret，以及短信模板的配置方式請在阿里云短信平臺文檔 (opens new window)查閱。此處設置的內(nèi)容后，在客戶端使用RFSmsSender類型的控件時，如不填寫內(nèi)容運行則默認使用此設置中的內(nèi)容進行填充。
??圖中內(nèi)容說明如下：
[短信驗證]-阿里云通信- Access Key Id： 阿里通信的AccessKey ID，在阿里云官方開通阿里通信得到。
- Access Key Secret： 阿里通信的AccessKey Secret，在阿里云官方網(wǎng)站得到。
- 短信模板ID： 阿里通信短信模板的ID。
- 短信簽名： 阿里通信短信簽名。
[短信驗證]-阿里大于- App Key： 阿里大于的App Key，在阿里云官方開通阿里通信得到。
- App Secret： 阿里大于的App Secret，在阿里云官方網(wǎng)站得到。
- 短信模板ID： 阿里大于短信模板的ID。
- 短信簽名： 阿里大于短信簽名。
示例：短信驗證設置完成后，可使用Smart中的短信發(fā)送范例來進行測試。在Smart中完成帳套設置的相關內(nèi)容后，填寫接收的手機號碼，然后直接點擊
[TARS發(fā)送短信]，出現(xiàn)“短信下發(fā)成功”的提示時表示短信發(fā)送成功。
# 4.6. REST/SSL
??使用SSL證書來加密通信連接，保證通信過程不被第三方竊聽。請自行查詢申請證書的方式有關內(nèi)容。
??圖中內(nèi)容說明如下：
[REST/SSL]-常規(guī)- 開啟REST： 勾選以后
[REST API插件]頁簽功能可顯示。 - 開啟用戶管理： 勾選以后
[用戶管理]頁簽功能可顯示。 - 開啟預設SQL管理： 勾選以后
[預設SQL管理]頁簽功能可顯示。
- 開啟REST： 勾選以后
[REST/SSL]-REST數(shù)據(jù)庫- 訪問方式： 設置REST模式下用戶的訪問方式。
通過SQL命令(靈活性好)：用戶在REST請求中可直接發(fā)送SQL文本來執(zhí)行。通過SQL編號(安全性高)：用戶在REST請求中發(fā)送SQL編號來執(zhí)行相應的程序。根據(jù)用戶設置：根據(jù)用戶管理中的用戶訪問方式設置來確定訪問方式。
- 訪問方式： 設置REST模式下用戶的訪問方式。
[REST/SSL]-PFX證書- 根證書： 設定根證書文件所在的地址。
- PFX證書： 設定PFX證書文件所在的地址。
- PFX證書密碼： 設定PFX證書的密碼。
[REST/SSL]-X509證書- X509證書： 設定X509證書文件所在的地址。
- X509 Key證書： 設定X509 Key證書文件所在的地址。
- 證書密碼： 設定X509證書的密碼。
# 4.7. 驅(qū)動類型
??數(shù)據(jù)庫驅(qū)動類型管理，可自行勾選。以下項目勾選后可在數(shù)據(jù)庫設置新增時選擇。
# 4.8. 黑白名單
??可設置黑名單IP限制用戶訪問中間件。每個IP地址設置一行。當指定的IP地址進入至黑名單后，此IP地址將不被允許接入至TARS服務器中。
# 4.9. 雪花算法
??Twitter的分布式雪花算法 SnowFlake 每秒自增生成26個萬個可排序的ID。
??圖中內(nèi)容說明如下：
- Worker Id： 分布式系統(tǒng)中機器地址的位數(shù)。
- Datacenter Id： 分布式系統(tǒng)中集群地址的位數(shù)。
- 起始時間戳： 雪花算法下的起始Id生成的時刻，建議選擇為中間件啟用日期。
注意
??當中間件為數(shù)據(jù)庫啟用了雪花算法用于生成主鍵后，請勿隨意更改頁面中的設置選項，否則會出現(xiàn)意想不到的錯誤。
- 示例：
??在啟用雪花算法后，可在Smart程序中使用此算法來獲取ID。
dm.GetNewID;
# 4.10. 微信公眾平臺
??勾選開啟微信公眾平臺并保存設置后，會啟用微信公眾號的相關功能。
# 4.11. 數(shù)據(jù)備份
??可設定數(shù)據(jù)庫定時自動備份功能，自動壓縮成壓縮包，可通過FTP上傳備份數(shù)據(jù)庫，還可通過郵件提醒用戶備份信息。
??圖中內(nèi)容說明如下：
[數(shù)據(jù)備份]-備份設置- 自動備份： 勾選此項開啟自動備份功能。
- 自動壓縮： 勾選此項開啟自動壓縮備份數(shù)據(jù)庫的功能，可將備份好的數(shù)據(jù)庫壓縮成壓縮包，方便轉(zhuǎn)移存儲。
- **FTP上傳：**勾選此項開啟FTP上傳功能，可以將備份好的數(shù)據(jù)庫上傳到指定FTP目錄。
- 郵件發(fā)送： 勾選此項開啟備份數(shù)據(jù)庫以后發(fā)送備份成功的信息到指定email。
- 備份路徑： 指定數(shù)據(jù)庫備份目錄，用于存儲備份好的數(shù)據(jù)庫文件。
- **備份時間：**批定備份時間，服務器時間到達指定的備份時間后，會啟動備份數(shù)據(jù)庫的功能。
- 備份天數(shù)： 指備份目錄下備份數(shù)據(jù)庫的保留天數(shù)，如指定6天，那么在備份的時候會清除6天前的備份，以保證電腦存儲不會被塞滿。
- 數(shù)據(jù)庫列表： 數(shù)據(jù)庫列表信息，來自與
數(shù)據(jù)庫設置頁簽。 - **備份庫列表：**通過
數(shù)據(jù)庫列表點選需要備份的數(shù)據(jù)庫到此處。
[數(shù)據(jù)備份]-FTP配置- FTP地址： 指定一個用于上傳備份數(shù)據(jù)庫的FTP目錄。
- 端口： 指定FTP服務器的端口號，默認21。
- **帳號：**指定FTP服務器登錄帳號名稱，可向管理員獲取。
- 密碼： 指定FTP服務器登錄帳號密碼，可向管理員獲取。
[數(shù)據(jù)備份]-郵件配置- 郵件服務器： 指定郵件服務器地址，如：smtp.163.com。
- 端口： 指定郵件服務器的端口號，默認25。
- **發(fā)件人：**指定一個發(fā)送郵件的發(fā)件人郵箱。
- 密碼： 指定一個發(fā)送郵件的發(fā)件人郵箱的密碼。
- **收件人：**指定一個接收郵件的收件人郵箱。
# 4.12. 日志
??可設置中間件顯示日志的相關設置。
- 日志緩存大小(MB)： 設置日志緩存的最大數(shù)值。
- 起始時間戳： 日志記錄的起始時間值。
- 日志保存天數(shù)： 日志記錄留存的天數(shù)。
# 4.13. 其他
??軟件標題、自動啟動等一些參數(shù)設置。
- 軟件標題： 設定軟件顯示的標題名稱。
[設置密碼]：為保持服務端正常運行，設置密碼以確保TARS服務不會被意外關閉。- 啟動后，最小化到系統(tǒng)托盤：在程序啟動之后，不會打開主界面，以界面最小化的方式運行，在系統(tǒng)托盤處顯示程序圖標。
- 關閉程序時，彈出確認對話框：在系統(tǒng)托盤處，找到TARS的圖標，使用鼠標右鍵選擇
退出關閉程序前，會有提示框彈出。 - 最小化后不更新界面，刷新間隔(秒)：當TARS處于最小化運行的狀態(tài)時，不對系統(tǒng)日志進行主動刷新顯示。只保持定期時間間隔的刷新方式。
- 顯示本機內(nèi)外網(wǎng)IP地址：在程序的狀態(tài)欄處顯示當前服務器的本機IP地址以及與外網(wǎng)訪問對接的外網(wǎng)IP地址。
- 統(tǒng)計網(wǎng)絡流量(犧牲一點性能)：在狀態(tài)欄處顯示當前的網(wǎng)絡流量統(tǒng)計信息。
- 隨Windows開機啟動：設定TARS是否跟隨Windows系統(tǒng)的啟動而自動啟動，以下有兩種啟動方式。
普通自啟（有界面，需登錄Windows）：TARS以Windows程序的方式運行，在用戶登錄至Windows后啟動并運行。后臺自啟（無界面，無需登錄Windows）：TARS以Windows服務的方式運行，在系統(tǒng)在啟動后就在后臺運行，用戶登陸后無法看到TARS的圖形管理界面。
- 定時檢查數(shù)據(jù)庫服務：TARS定期檢查各個數(shù)據(jù)庫設置的連接情況，對于無法連接的數(shù)據(jù)庫設置會彈出相關提示信息。
# 5. 用戶設置
??用戶設置界面可對RestAPI用戶進行管理操作，包括新增、修改用戶設置，刪除用戶等功能。
注意
??如果要在FastWeb中配置相關功能，需要在Node節(jié)點數(shù)據(jù)庫中設置相同名稱的連接。
??界面說明如下。
[新增]：點擊此按鈕，打開用戶管理界面并新增用戶。[編輯]：在列表中選擇要進行編輯操作的用戶，點擊打開用戶管理界面并加載用戶進行編輯。[刪除]：在列表中選擇要進行刪除操作的用戶，點擊以執(zhí)行刪除操作。[刷新]：點擊此按鈕以刷新表格的顯示。[數(shù)據(jù)庫連接名稱]：選擇要配置用戶信息的連接設置名稱。
??表格中的字段說明如下。
用戶名：設定的RestAPI用戶名稱，數(shù)據(jù)訪問方式：為用戶設定的數(shù)據(jù)庫連接訪問的形式，主要有通過SQL命令與通過SQL編號兩種方式，詳見用戶管理編輯頁面的說明。Insert：此用戶是否有插入數(shù)據(jù)的權限。Delete：此用戶是否有刪除數(shù)據(jù)的權限。Update：此用戶是否有更新數(shù)據(jù)的權限。DDL：此用戶是否有操作表的權限。重復登錄：是否運行用戶進行重復登錄的操作。設備鎖：通過設置，可限制賬號在設定的設備上登錄使用。Andorid通過綁定IMEI，PC通過唯一ID綁定，中間件提供設備唯一ID獲取接口。停用：當前用戶是否暫停使用。AppSecret：應用密鑰信息，在設置用戶時會自動生成。創(chuàng)建時間：用戶資料的創(chuàng)建時刻。更新時間：用戶資料的最近更新時刻。描述：用戶的描述信息。
??點擊界面中的[新增]或者[修改]按鈕，打開如下圖所示的頁面。
??圖中內(nèi)容說明如下：
用戶名：客戶端用戶登錄名稱。密碼：為使用MD5后的哈希值，不保存明文密碼。可在參數(shù)設置-常規(guī)設置中增加全局MD5鹽值有效防止彩虹表撞庫，被暴力破解密碼。AppSecret：借鑒阿里的安全機制，增加驗證簽名時使用到，防止REST API調(diào)用過程中數(shù)據(jù)被黑客篡改，提高安全性。手機號碼：用戶預留的手機號碼信息。描述：用戶的描述信息。數(shù)據(jù)庫訪問方式：支持通過SQL編號和SQL 命令訪問。如需要通過SQL編號方式，需要在預設SQL管理中設置好 SQL編號的內(nèi)容。通過SQL命令(靈活性好)：可直接執(zhí)行相關的SQL文本。具有較強的靈活性，在嚴格的用戶權限管理中不建議使用這種訪問方式。通過SQL編號(安全性高)：執(zhí)行預設的SQL編號內(nèi)容，這種方式的安全性較高。
查詢數(shù)據(jù)總行數(shù)：限制客戶端一次查詢數(shù)據(jù)行數(shù)，如設置為0，則表示不限制查詢行數(shù)。文件上傳最大值：允許用戶上傳的文件的最大數(shù)值，如設置為0，則表示不限制文件大小。Insert權限：是否授予用戶向表中插入數(shù)據(jù)的權限。Update權限：是否授予用戶更新表中數(shù)據(jù)的權限。Delete權限：是否授予用戶刪除表中數(shù)據(jù)的權限。DDL權限，主要的命令有CREATE、ALTER、DROP等：是否授予用戶對表結(jié)構或數(shù)據(jù)庫進行操作。停用賬號：暫停使用賬號。
# 6. 預設SQL管理
??預設SQL，可被RestAPI通過SQL編號進行調(diào)用，提高可復用性。
注意
??如果要在FastWeb中配置相關功能，需要在Node節(jié)點數(shù)據(jù)庫中設置相同名稱的連接。
??界面說明如下。
[新增]：點擊此按鈕，打開用戶管理界面并新增用戶。[編輯]：在列表中選擇要進行編輯操作的用戶，點擊打開用戶管理界面并加載用戶進行編輯。[刪除]：在列表中選擇要進行刪除操作的用戶，點擊以執(zhí)行刪除操作。[刷新]：點擊此按鈕以刷新表格的顯示。[數(shù)據(jù)庫連接名稱]：選擇要配置用戶信息的連接設置名稱。
??表格中的列說明如下。
SQL編號：引用的SQL命令的編號名稱。數(shù)據(jù)庫連接名稱：SQL編號對接使用的數(shù)據(jù)庫連接設置的名稱。描述：對SQL編號的詳細描述信息。創(chuàng)建時間：SQL編號信息的創(chuàng)建時間。更新時間：SQL編號信息最新的更新時間。SQL語句：SQL編號對應使用的SQL語句信息。
??點擊[新增]或者[編輯]按鈕，彈出預設SQL管理窗體，見下圖：
??該窗口中內(nèi)容說明如下：
- 數(shù)據(jù)庫連接名稱： 下拉列表內(nèi)來自
[數(shù)據(jù)庫連接名稱]。 - SQL編號： 預設SQL的編號，供RestAPI調(diào)用。
- 描述： 預設SQL描述說明
- SQL語句： 預設SQL的SQL語句內(nèi)容。
# 7. 郵件服務
??郵件服務用于設置為TARS平臺使用的郵件發(fā)送的郵箱地址。
??郵箱設置的說明如下：
- 服務器：電子郵箱服務器的網(wǎng)絡地址，由郵箱服務商提供。
- 端口：電子郵箱服務器的連接端口，通常為25端口。
- 發(fā)件人：TARS發(fā)送相關郵件使用的主體郵箱地址。
- 密碼：發(fā)件使用的郵箱的密碼。
- 收件人：設置收件的郵箱地址，此地址僅作為測試郵箱設置正確性使用，不作其他用途。