Microsoft OLE DB Provider for SQL Server 概觀
Microsoft OLE DB Provider for SQL Server SQLOLEDB 可讓 ADO 存取 Microsoft SQL Server。
重要
SQL Server Native Client (通常縮寫的 SNAC) 已從 SQL Server 2022 (16.x) 中移除，SQL Server Management Studio 19 (SSMS) 。 SQL Server Native Client OLE DB 提供者 (SQLNCLI 或 SQLNCLI11) 和舊版 Microsoft OLE DB Provider for SQL Server (SQLOLEDB) 不建議用於新開發。 請切換至新的Microsoft OLE DB Driver (MSOLEDBSQL) ，以供未來SQL Server使用。
連接字串參數
若要連接到此提供者，請將 Provider 引數設定為 ConnectionString 屬性為：
SQLOLEDB
您也可以使用 Provider 屬性來設定或讀取此值。
一般連接字串
此提供者的一般連接字串為：
"Provider=SQLOLEDB;Data Source=serverName;"
Initial Catalog=databaseName;
User ID=MyUserID;Password=MyPassword;"
字串包含下列關鍵字：
| 關鍵字 | 描述 |
|---|---|
| 提供者 | 指定 OLE DB Provider for SQL Server。 |
| 資料來源 或 伺服器 | 指定伺服器的名稱。 |
| 初始目錄 或 資料庫 | 指定伺服器上的資料庫名稱。 |
| 使用者識別碼 或 uid | 指定SQL Server驗證) 的使用者名稱 (。 |
| 密碼 或 pwd | 指定SQL Server驗證) 的使用者密碼 (。 |
注意
如果您要連接到支援Windows 驗證的資料來源提供者，您應該指定Trusted_Connection=yes或Integrated Security = SSPI，而不是連接字串中的使用者識別碼和密碼資訊。
Provider-Specific連線參數
除了 ADO 所定義的連接參數之外，提供者還支援數個提供者特定的連接參數。 如同 ADO 連接屬性，這些提供者特定屬性可以透過Connection的Properties集合來設定，也可以設定為ConnectionString的一部分。
| 參數 | Description |
|---|---|
| Trusted_Connection | 指出使用者驗證模式。 這可以設定為 [是 ] 或 [ 否]。 預設值為 [否]。 如果此屬性設定為[是]，SQLOLEDB 會使用 Microsoft Windows NT 驗證模式來授權使用者存取Location和Datasource屬性值所指定的SQL Server資料庫。 如果此屬性設定為[否]，SQLOLEDB 會使用混合模式來授權使用者存取SQL Server資料庫。 SQL Server登入和密碼是在[使用者識別碼] 和 [密碼]屬性中指定。 |
| 目前的語言 | 表示語言名稱SQL Server。 識別系統訊息選取與格式所使用的語言。 語言必須安裝在SQL Server上，否則開啟連線將會失敗。 |
| 網路位址 | 指出Location屬性所指定SQL Server的網路位址。 |
| Network Library | 指出用來與SQL Server通訊的網路程式庫 (DLL) 名稱。 名稱不得包含路徑或 .dll 副檔名。 預設是由SQL Server用戶端組態所提供。 |
| 準備使用程式 | 決定當Prepared屬性 (備妥命令時，SQL Server是否建立暫存程式) 。 |
| 自動轉譯 | 指出是否轉換 OEM/ANSI 字元。 這個屬性可以設定為 True 或 False。 預設值是 True。 如果此屬性設定為True，當擷取多位元組字元字串或傳送至 SQL Server時，SQLOLEDB 會執行 OEM/ANSI 字元轉換。 如果此屬性設定為 False，SQLOLEDB 不會在多位元組字元字串資料上執行 OEM/ANSI 字元轉換。 |
| Packet Size | 表示以位元組為單位的網路封包大小。 封包大小屬性值必須介於 512 和 32767 之間。 預設 SQLOLEDB 網路封包大小為 4096。 |
| 應用程式名稱 | 表示用戶端應用程式名稱。 |
| 工作站 ID | 識別工作站的字串。 |
Command 物件使用方式
SQLOLEDB 接受 ODBC、ANSI 和 SQL Server 特定 Transact-SQL 的惡意程式碼作為有效的語法。 例如，下列 SQL 陳述式會使用 ODBC SQL 逸出序列來指定 LCASE 字串函數：
SELECT customerid={fn LCASE(CustomerID)} FROM Customers
LCASE 會傳回字元字串，將所有大寫字元轉換為其小寫的對等項目。 ANSI SQL 字串函式 LOWER 會執行相同的作業，因此下列 SQL 語句相當於稍早顯示的 ODBC 語句：
SELECT customerid=LOWER(CustomerID) FROM Customers
當指定為命令的文字時，SQLOLEDB 會成功處理任一形式的 語句。
預存程序
使用 SQLOLEDB 命令執行SQL Server預存程式時，請使用命令文字中的 ODBC 程序呼叫逸出序列。 然後，SQLOLEDB 會使用 SQL Server 的遠端程序呼叫機制，將命令處理優化。 例如，下列 ODBC SQL 語句是 Transact-SQL 表單上慣用的命令文字：
ODBC SQL
{call SalesByCategory('Produce', '1995')}
Transact-SQL
EXECUTE SalesByCategory 'Produce', '1995'
SQL Server功能
使用 SQL Server，ADO 可以使用 XML 作為命令輸入，並以 XML 資料流程格式擷取結果，而不是在 Recordset物件中擷取結果。 如需詳細資訊，請參閱 使用資料流程進行命令輸入 和 將結果集擷取至資料流程。
使用 MDAC 2.7、MDAC 2.8 或 Windows DAC 6.0 存取SQL_variant資料
Microsoft SQL Server具有稱為SQL_variant的資料類型。 與 OLE DB 的DBTYPE_VARIANT類似， SQL_variant 資料類型可以儲存數種不同類型的資料。 不過， DBTYPE_VARIANT 與 SQL_variant之間有一些主要差異。 ADO 也會處理儲存為 SQL_variant 值的資料，與處理其他資料類型的方式不同。 下列清單說明當您存取儲存在類型SQL_variant資料行SQL Server資料時，需要考慮的問題。
在 MDAC 2.7、MDAC 2.8 和 Windows Data Access Components (Windows DAC) 6.0 中，OLE DB Provider for SQL Server 支援SQL_variant類型。 OLE DB Provider for ODBC 不會。
SQL_variant類型與DBTYPE_VARIANT資料類型不完全相符。 SQL_variant類型支援一些DBTYPE_VARIANT不支援的新子類型，包括GUID、ANSI (非 UNICODE) 字串，以及BIGINT。 使用稍早所列的子類型將無法正常運作。
SQL_variant子類型NUMERIC不符合大小DBTYPE_DECIMAL。
多個資料類型強制型轉會導致類型不符。 例如，將GUID子類型的SQL_variant強制轉型為DBTYPE_VARIANT會導致) 的 safearray (子類型。 將這個類型轉換回 SQL_variant 會導致 陣列 的新子類型 (位元組) 。
包含SQL_variant資料的記錄集欄位可以遠端 (封送處理) ，或只有在SQL_variant包含特定子類型時才保存。 嘗試使用下列不支援的子類型遠端或保存資料，會導致從 Microsoft 持續性提供者 (MSPersist) 不支援) 的轉換 (執行階段錯誤： VT_VARIANT、 VT_RECORD、 VT_ILLEGAL、 VT_UNKNOWN、 VT_BSTR和 VT_DISPATCH。
MDAC 2.7、MDAC 2.8 和 Windows DAC 6.0 中的 OLE DB Provider for SQL Server具有稱為Allow Native Variants的動態屬性，如名稱所示，可讓開發人員以原生形式存取SQL_variant，而不是DBTYPE_VARIANT。 如果已設定此屬性，且使用用戶端資料指標引擎開啟 Recordset (adUseClient) ， 則 Recordset.Open 呼叫將會失敗。 如果已設定此屬性，且使用伺服器資料指標開啟 Recordset (adUseServer) ， 則 Recordset.Open 呼叫將會成功，但存取 類型SQL_variant 的資料行將會產生錯誤。
在使用 MDAC 2.5 的用戶端應用程式中，SQL_variant資料可以搭配 Microsoft SQL Server 的查詢使用。 不過， SQL_variant 資料的值會被視為字串。 這類用戶端應用程式應該升級至 MDAC 2.7、MDAC 2.8 或 Windows DAC 6.0。
記錄集行為
SQLOLEDB 無法使用SQL Server資料指標來支援許多命令所產生的多重結果。 如果取用者要求需要SQL Server資料指標支援的記錄集，如果使用的命令文字會產生超過單一記錄集的結果，就會發生錯誤。
SQL Server資料指標支援可捲動的 SQLOLEDB 記錄集。 SQL Server會對資料庫其他使用者所做的變更敏感性資料指標施加限制。 具體而言，某些資料指標中的資料列無法排序，而且嘗試使用包含 SQL ORDER BY 子句的命令建立記錄集可能會失敗。
動態屬性
Microsoft OLE DB Provider for SQL Server會將數個動態屬性插入未開啟的 Connection、Recordset和Command物件的Properties集合中。
下表是每個動態屬性的 ADO 和 OLE DB 名稱的交叉索引。 OLE DB 程式設計人員參考以「描述」一詞參照 ADO 屬性名稱。您可以在 OLE DB 程式設計人員參考中找到這些屬性的詳細資訊。 在索引中搜尋 OLE DB 屬性名稱，或參閱 附錄 C：OLE DB 屬性。
連線動態屬性
下列屬性會新增至Connection物件的Properties集合。
| ADO 屬性名稱 | OLE DB 屬性名稱 |
|---|---|
| Active Sessions | DBPROP_ACTIVESESSIONS |
| Asynchable Abort | DBPROP_ASYNCTXNABORT |
| Asynchable Commit | DBPROP_ASYNCTNXCOMMIT |
| 自動認可隔離等級 | DBPROP_SESS_AUTOCOMMITISOLEVELS |
| 目錄位置 | DBPROP_CATALOGLOCATION |
| 目錄字詞 | DBPROP_CATALOGTERM |
| 資料行定義 | DBPROP_COLUMNDEFINITION |
| 連接逾時 | DBPROP_INIT_TIMEOUT |
| 目前目錄 | DBPROP_CURRENTCATALOG |
| 資料來源 | DBPROP_INIT_DATASOURCE |
| 資料來源名稱 | DBPROP_DATASOURCENAME |
| 資料來源物件執行緒模型 | DBPROP_DSOTHREADMODEL |
| DBMS 名稱 | DBPROP_DBMSNAME |
| DBMS 版本 | DBPROP_DBMSVER |
| 擴充屬性 | DBPROP_INIT_PROVIDERSTRING |
| GROUP BY 支援 | DBPROP_GROUPBY |
| 異質資料表支援 | DBPROP_HETEROGENEOUSTABLES |
| 識別碼區分大小寫 | DBPROP_IDENTIFIERCASE |
| 初始目錄 | DBPROP_INIT_CATALOG |
| 隔離等級 | DBPROP_SUPPORTEDTXNISOLEVELS |
| 隔離保留 | DBPROP_SUPPORTEDTXNISORETAIN |
| 地區設定識別碼 | DBPROP_INIT_LCID |
| 索引大小上限 | DBPROP_MAXINDEXSIZE |
| 資料列大小上限 | DBPROP_MAXROWSIZE |
| 資料列大小上限包括 BLOB | DBPROP_MAXROWSIZEINCLUDESBLOB |
| SELECT 中的資料表上限 | DBPROP_MAXTABLESINSELECT |
| 多個參數集 | DBPROP_MULTIPLEPARAMSETS |
| 多個結果 | DBPROP_MULTIPLERESULTS |
| 多個儲存物件 | DBPROP_MULTIPLESTORAGEOBJECTS |
| 多資料表更新 | DBPROP_MULTITABLEUPDATE |
| Null 定序順序 | DBPROP_NullCOLLATION |
| Null 串連行為 | DBPROP_CONCATNULLBEHAVIOR |
| OLE DB 版本 | DBPROP_PROVIDEROLEDBVER |
| OLE 物件支援 | DBPROP_OLEOBJECTS |
| 開啟資料列集支援 | DBPROP_OPENROWSETSUPPORT |
| 選取清單中的 ORDER BY 資料行 | DBPROP_ORDERBYCOLUMNSINSELECT |
| 輸出參數可用性 | DBPROP_OUTPUTPARAMETERAVAILABILITY |
| 依 Ref 存取子傳遞 | DBPROP_BYREFACCESSORS |
| 密碼 | DBPROP_AUTH_PASSWORD |
| 保存安全性資訊 | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO |
| 永續性識別碼類型 | DBPROP_PERSISTENTIDTYPE |
| 準備中止行為 | DBPROP_PREPAREABORTBEHAVIOR |
| 準備認可行為 | DBPROP_PREPARECOMMITBEHAVIOR |
| 程式字詞 | DBPROP_PROCEDURETERM |
| 提示 | DBPROP_INIT_PROMPT |
| 提供者易記名稱 | DBPROP_PROVIDERFRIENDLYNAME |
| Provider Name | DBPROP_PROVIDERFILENAME |
| 提供者版本 | DBPROP_PROVIDERVER |
| Read-Only資料來源 | DBPROP_DATASOURCEREADONLY |
| 命令上的資料列集轉換 | DBPROP_ROWSETCONVERSIONSONCOMMAND |
| 架構字詞 | DBPROP_SCHEMATERM |
| 架構使用方式 | DBPROP_SCHEMAUSAGE |
| SQL 支援 | DBPROP_SQLSUPPORT |
| 結構化儲存體 | DBPROP_STRUCTUREDSTORAGE |
| 子查詢支援 | DBPROP_SUBQUERIES |
| 資料表字詞 | DBPROP_TABLETERM |
| 交易 DDL | DBPROP_SUPPORTEDTXNDDL |
| 使用者識別碼 | DBPROP_AUTH_USERID |
| 使用者名稱 | DBPROP_USERNAME |
| 視窗控制代碼 | DBPROP_INIT_HWND |
Recordset 動態屬性
下列屬性會新增至Recordset物件的Properties集合。
| ADO 屬性名稱 | OLE DB 屬性名稱 |
|---|---|
| 存取順序 | DBPROP_ACCESSORDER |
| 封鎖儲存物件 | DBPROP_BLOCKINGSTORAGEOBJECTS |
| 書簽類型 | DBPROP_BOOKMARKTYPE |
| Bookmarkable | DBPROP_IROWSETLOCATE |
| 變更插入的資料列 | DBPROP_CHANGEINSERTEDROWS |
| 資料行許可權 | DBPROP_COLUMNRESTRICT |
| 資料行集通知 | DBPROP_NOTIFYCOLUMNSET |
| 命令逾時 | DBPROP_COMMANDTIMEOUT |
| 延遲資料行 | DBPROP_DEFERRED |
| 延遲儲存物件更新 | DBPROP_DELAYSTORAGEOBJECTS |
| 擷取回溯 | DBPROP_CANFETCHBACKWARDS |
| 保留資料列 | DBPROP_CANHOLDROWS |
| IAccessor | DBPROP_IAccessor |
| IColumnsInfo | DBPROP_IColumnsInfo |
| IColumnsRowset | DBPROP_IColumnsRowset |
| IConnectionPointContainer | DBPROP_IConnectionPointContainer |
| IConvertType | DBPROP_IConvertType |
| 固定資料列 | DBPROP_IMMOBILEROWS |
| IRowset | DBPROP_IRowset |
| IRowsetChange | DBPROP_IRowsetChange |
| IRowsetIdentity | DBPROP_IRowsetIdentity |
| IRowsetInfo | DBPROP_IRowsetInfo |
| IRowsetLocate | DBPROP_IRowsestLocate |
| IRowsetResynch | |
| IRowsetScroll | DBPROP_IRowsetScroll |
| IRowsetUpdate | DBPROP_IRowsetUpdate |
| ISequentialStream | DBPROP_ISequentialStream |
| ISupportErrorInfo | DBPROP_ISupportErrorInfo |
| 常值書簽 | DBPROP_LITERALBOOKMARKS |
| 常值資料列識別 | DBPROP_LITERALIDENTITY |
| 開啟的資料列上限 | DBPROP_MAXOPENROWS |
| 暫止資料列上限 | DBPROP_MAXPENDINGROWS |
| 最大資料列 | DBPROP_MAXROWS |
| 通知細微性 | DBPROP_NOTIFICATIONGRANULARITY |
| 通知階段 | DBPROP_NOTIFICATIONPHASES |
| 物件交易 | DBPROP_TRANSACTEDOBJECT |
| 其他人的變更可見 | DBPROP_OTHERUPDATEDELETE |
| 其他人的插入可見 | DBPROP_OTHERINSERT |
| 擁有變更可見 | DBPROP_OWNUPDATEDELETE |
| 擁有插入可見 | DBPROP_OWNINSERT |
| 在中止時保留 | DBPROP_ABORTPRESERVE |
| 在認可時保留 | DBPROP_COMMITPRESERVE |
| 快速重新開機 | DBPROP_QUICKRESTART |
| 重新進入事件 | DBPROP_REENTRANTEVENTS |
| 移除已刪除的資料列 | DBPROP_REMOVEDELETED |
| 報告多個變更 | DBPROP_REPORTMULTIPLECHANGES |
| 傳回擱置插入 | DBPROP_RETURNPENDINGINSERTS |
| 資料列刪除通知 | DBPROP_NOTIFYROWDELETE |
| 第一列變更通知 | DBPROP_NOTIFYROWFIRSTCHANGE |
| 資料列插入通知 | DBPROP_NOTIFYROWINSERT |
| 資料列許可權 | DBPROP_ROWRESTRICT |
| 資料列重新同步通知 | DBPROP_NOTIFYROWRESYNCH |
| 資料列執行緒模型 | DBPROP_ROWTHREADMODEL |
| 資料列復原變更通知 | DBPROP_NOTIFYROWUNDOCHANGE |
| 資料列復原刪除通知 | DBPROP_NOTIFYROWUNDODELETE |
| 資料列復原插入通知 | DBPROP_NOTIFYROWUNDOINSERT |
| 資料列更新通知 | DBPROP_NOTIFYROWUPDATE |
| 資料列集擷取位置變更通知 | DBPROP_NOTIFYROWSETFETCHPOSISIONCHANGE |
| 資料列集發行通知 | DBPROP_NOTIFYROWSETRELEASE |
| 向後捲動 | DBPROP_CANSCROLLBACKWARDS |
| 伺服器資料指標 | DBPROP_SERVERCURSOR |
| 略過已刪除的書簽 | DBPROP_BOOKMARKSKIPPED |
| 強式資料列識別 | DBPROP_STRONGITDENTITY |
| 唯一資料列 | DBPROP_UNIQUEROWS |
| 可更新性 | DBPROP_UPDATABILITY |
| 使用書簽 | DBPROP_BOOKMARKS |
命令動態屬性
下列屬性會新增至Command物件的Properties集合。
| ADO 屬性名稱 | OLE DB 屬性名稱 |
|---|---|
| 存取順序 | DBPROP_ACCESSORDER |
| 基底路徑 | SSPROP_STREAM_BASEPATH |
| 封鎖儲存物件 | DBPROP_BLOCKINGSTORAGEOBJECTS |
| 書簽類型 | DBPROP_BOOKMARKTYPE |
| 可書簽 | DBPROP_IROWSETLOCATE |
| 變更插入的資料列 | DBPROP_CHANGEINSERTEDROWS |
| 資料行許可權 | DBPROP_COLUMNRESTRICT |
| 資料行集通知 | DBPROP_NOTIFYCOLUMNSET |
| 內容類型 | SSPROP_STREAM_CONTENTTYPE |
| 資料指標自動擷取 | SSPROP_CURSORAUTOFETCH |
| 延遲資料行 | DBPROP_DEFERRED |
| 延遲準備 | SSPROP_DEFERPREPARE |
| 延遲儲存物件更新 | DBPROP_DELAYSTORAGEOBJECTS |
| 擷取回溯 | DBPROP_CANFETCHBACKWARDS |
| 保留資料列 | DBPROP_CANHOLDROWS |
| IAccessor | DBPROP_IAccessor |
| IColumnsInfo | DBPROP_IColumnsInfo |
| IColumnsRowset | DBPROP_IColumnsRowset |
| IConnectionPointContainer | DBPROP_IConnectionPointContainer |
| IConvertType | DBPROP_IConvertType |
| 固定資料列 | DBPROP_IMMOBILEROWS |
| IRowset | DBPROP_IRowset |
| IRowsetChange | DBPROP_IRowsetChange |
| IRowsetIdentity | DBPROP_IRowsetIdentity |
| IRowsetInfo | DBPROP_IRowsetInfo |
| IRowsetLocate | DBPROP_IRowsetLocate |
| IRowsetResynch | DBPROP_IRowsetResynch |
| IRowsetScroll | DBPROP_IRowsetScroll |
| IRowsetUpdate | DBPROP_IRowsetUpdate |
| ISequentialStream | DBPROP_ISequentialStream |
| ISupportErrorInfo | DBPROP_ISupportErrorInfo |
| 常值書簽 | DBPROP_LITERALBOOKMARKS |
| 常值資料列識別 | DBPROP_LITERALIDENTITY |
| 鎖定模式 | DBPROP_LOCKMODE |
| 開啟的資料列上限 | DBPROP_MAXOPENROWS |
| 暫止資料列上限 | DBPROP_MAXPENDINGROWS |
| 最大資料列數 | DBPROP_MAXROWS |
| 通知細微性 | DBPROP_NOTIFICATIONGRANULARITY |
| 通知階段 | DBPROP_NOTIFICATIONPHASES |
| 物件交易 | DBPROP_TRANSACTEDOBJECT |
| 其他人的變更可見 | DBPROP_OTHERUPDATEDELETE |
| 其他人的插入可見 | DBPROP_OTHERINSERT |
| 輸出編碼屬性 | DBPROP_OUTPUTENCODING |
| Output Stream 屬性 | DBPROP_OUTPUTSTREAM |
| 顯示自己的變更 | DBPROP_OWNUPDATEDELETE |
| 擁有插入可見 | DBPROP_OWNINSERT |
| 在中止時保留 | DBPROP_ABORTPRESERVE |
| 認可時保留 | DBPROP_COMMITPRESERVE |
| 快速重新開機 | DBPROP_QUICKRESTART |
| 重新進入事件 | DBPROP_REENTRANTEVENTS |
| 移除已刪除的資料列 | DBPROP_REMOVEDELETED |
| 報告多個變更 | DBPROP_REPORTMULTIPLECHANGES |
| 傳回擱置插入 | DBPROP_RETURNPENDINGINSERTS |
| 資料列刪除通知 | DBPROP_NOTIFYROWDELETE |
| 資料列第一次變更通知 | DBPROP_NOTIFYROWFIRSTCHANGE |
| 資料列插入通知 | DBPROP_NOTIFYROWINSERT |
| 資料列許可權 | DBPROP_ROWRESTRICT |
| 資料列重新同步處理通知 | DBPROP_NOTIFYROWRESYNCH |
| 資料列執行緒模型 | DBPROP_ROWTHREADMODEL |
| 資料列復原變更通知 | DBPROP_NOTIFYROWUNDOCHANGE |
| 資料列復原刪除通知 | DBPROP_NOTIFYROWUNDODELETE |
| 資料列復原插入通知 | DBPROP_NOTIFYROWUNDOINSERT |
| 資料列更新通知 | DBPROP_NOTIFYROWUPDATE |
| 資料列集擷取位置變更通知 | DBPROP_NOTIFYROWSETFETCHPOSITIONCHANGE |
| 資料列集發行通知 | DBPROP_NOTIFYROWSETRELEASE |
| 向後捲動 | DBPROP_CANSCROLLBACKWARDS |
| 伺服器資料指標 | DBPROP_SERVERCURSOR |
| 插入上的伺服器資料 | DBPROP_SERVERDATAONINSERT |
| 略過已刪除的書簽 | DBPROP_BOOKMARKSKIP |
| 強式資料列識別 | DBPROP_STRONGIDENTITY |
| 可更新性 | DBPROP_UPDATABILITY |
| 使用書簽 | DBPROP_BOOKMARKS |
| XML 根目錄 | SSPROP_STREAM_XMLROOT |
| XSL | SSPROP_STREAM_XSL |
如需 Microsoft SQL Server OLE DB 提供者的特定實作詳細資料和功能資訊，請參閱SQL Server提供者。