腳本開發 / 連接器對象 `DFF.CONN` / Microsoft SQL Server

Microsoft SQL Server 連接器操作對象主要提供 Microsoft SQL Server 的操作方法。

DFF.CONN(...) 參數如下：

參數	類型	必須 / 默認值	説明
`connector_id`	str	必須	連接器 ID
`database`	str	`None`	指定數據庫

`.query(...)`

執行 SQL 語句並返回 list[dict] 格式的查詢結果，參數如下：

參數	類型	必須 / 默認值	説明
`sql`	str	必須	SQL 語句，可包含參數佔位符。 `?` 表示需要轉義的參數； `??` 表示不需要轉義的參數
`sql_params`	list	`None`	SQL 參數

示例
sql = 'SELECT * FROM ?? WHERE seq > ?'
sql_params = ['demo', 1]
result = db.query(sql, sql_params=sql_params)

執行寫入、更新或刪除等 SQL 語句。參數與 .query(...) 相同。

示例
sql = 'DELETE FROM ?? WHERE id = ?'
sql_params = ['demo', 1]
result = db.non_query(sql, sql_params=sql_params)

當前實現直接返回 pymssql.Cursor.execute(...) 的返回值，通常為 None，不能用它獲取影響行數。

.query(...) 和 .non_query(...) 執行成功後都會自動提交事務；執行失敗時自動回滾並拋出異常。

需要在同一事務中執行多條 SQL 時，使用以下方法：

方法	説明
`.start_trans()`	開始事務並返回事務連接對象
`.trans_query(trans_conn, sql, sql_params=None)`	在事務中執行查詢並返回 `list[dict]`
`.trans_non_query(trans_conn, sql, sql_params=None)`	在事務中執行非查詢 SQL，通常返回 `None`
`.commit(trans_conn)`	提交事務並關閉事務連接
`.rollback(trans_conn)`	回滾事務並關閉事務連接

事務執行過程中出現異常時，應調用 .rollback(trans_conn)；同一個事務連接對象完成提交或回滾後不可繼續使用。

query(...) 和 non_query(...) 內部使用 DFF.SQL(...) 構造 SQL 語句並支持構造複雜動態的 SQL 語句。

如 WHERE IN (...) 不確定數量的值，或者 INSERT INTO ... VALUES ... 進行批量寫入數據等。