Share via


SOAP 延伸模組標頭

未來的 Microsoft SQL Server 版本將移除這項功能。請避免在新的開發工作中使用這項功能,並規劃修改目前使用這項功能的應用程式。

從 SQL Server 2005 開始,使用 HTTP 和 SOAP 傳送到 SQL Server 執行個體的要求,其 SOAP Envelope 可包含選擇性標頭來修改執行要求的方式。同樣地,有時候 SQL Server 執行個體也會針對特定活動 (例如資料庫鏡像) 傳回其他 SOAP 標頭資訊。以下是選擇性標頭:

  • SQL 選擇性標頭

  • Web 服務安全性 (WS-Security) 標頭

SQL 選擇性標頭

這些 SQL Server 選擇性標頭已經加入到 HTTP SOAP 支援,主要是為了以透過網路連接 (使用表格式資料流 (TDS) 通訊協定) 的傳統 SQL 資料存取方式的可用選項,達到同位檢查的目的。

除非本節中另有指定,否則其中每個選擇性標頭都是使用 "https://schemas.microsoft.com/sqlserver/2004/SOAP/Options" 的命名空間 URI,並且與 sqloptions 命名空間前置詞相關聯,對於每個標頭來說,此前置詞都是以下列方式宣告:

xmlns:sqloptions="https://schemas.microsoft.com/sqlserver/2004/SOAP/Options"

下表列出在 SQL Server 下,所有可用於 SOAP 要求訊息的 SQL 選擇性標頭。

Header

描述

sqloptions:applicationName 標頭元素

可讓用戶端指定要使用的應用程式名稱。

sqloptions:clientInterface 標頭元素

可讓用戶端指定要使用的用戶端介面。

sqloptions:clientNetworkID 標頭元素

可讓用戶端指定要用於 SQL 登入的用戶端網路識別碼。

sqloptions:clientPID 標頭元素

可讓用戶端指定要使用的用戶端處理序識別碼。

sqloptions:databaseMirroringPartner 標頭元素

供伺服器用來將資訊傳回給資料庫鏡像夥伴。

sqloptions:environmentChangeNotifications 標頭元素

可讓用戶端指定希望從伺服器收到哪些環境變更通知。

sqloptions:hostname 標頭元素

可讓用戶端指定要使用的主機名稱。

sqloptions:initialDatabase 標頭元素

可讓用戶端指定要使用的初始資料庫。

sqloptions:initialLanguage 標頭元素

可讓用戶端指定要使用的初始語言。

sqloptions:notificationRequest 標頭元素

可讓用戶端向伺服器要求通知。

sqloptions:sqlSession 標頭元素

可讓用戶端要求 SOAP 工作階段。

WS-Security 標頭

Web 服務安全性 (WS-Security) 標頭支援與 SQL Server 一起使用,以指定要用於 SQL Server 驗證的使用者名稱與密碼認證。如需支援用於 SQL Server 之 WS-Security 標頭的詳細資訊,請參閱<透過 SOAP 的 SQL Server 驗證>。

WS-Security 是以提交到結構化資訊標準推動組織 (OASIS) 的開放標準為基礎。如需 WS-Security 標準架構的詳細資訊,請造訪 OASIS 網站,網址是 http://www.oasis-open.org