Share via


Encabezados de extensión SOAP

Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.

A partir de SQL Server 2005, una solicitud enviada a una instancia de SQL Server mediante el uso de HTTP y SOAP puede contener encabezados opcionales en SOAP ENVELOPE que modifiquen la forma en que se ejecuta la solicitud. De manera similar, en ocasiones la instancia de SQL Server puede devolver información adicional de encabezado de SOAP para determinadas actividades, como el reflejo de bases de datos. Estos son los encabezados opcionales:

  • Encabezados opcionales de SQL

  • Encabezado de Web Services Security (WS-Security)

Encabezados opcionales de SQL

Estos encabezados opcionales de SQL Server se agregaron por motivos de compatibilidad con SOAP HTTP, principalmente para obtener paridad con opciones disponibles de acceso de datos SQL tradicional por conexiones de red en las que se utiliza el protocolo Secuencia de datos tabular (TDS).

A menos que se especifique lo contrario en esta sección, cada uno de estos encabezados opcionales utiliza el espacio de nombres URI (Identificador uniforme de recursos) de "https://schemas.microsoft.com/sqlserver/2004/SOAP/Options" y está asociado al prefijo de espacio de nombres sqloptions que se declara de la siguiente manera para cada encabezado:

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

En la tabla siguiente se indican todos los encabezados opcionales de SQL disponibles para su uso en mensajes de solicitudes SOAP en SQL Server.

Encabezado

Descripción

sqloptions:applicationName (elemento de encabezado)

Habilita al cliente para especificar el nombre de aplicación que va a utilizar.

sqloptions:clientInterface (elemento de encabezado)

Habilita al cliente para especificar la interfaz cliente que va a utilizar.

sqloptions:clientNetworkID (elemento de encabezado)

Habilita al cliente para especificar el Id. de red de cliente que va a utilizar en el inicio de sesión de SQL.

sqloptions:clientPID (elemento de encabezado)

Habilita al cliente para especificar el Id. de proceso cliente que va a utilizar.

sqloptions:databaseMirroringPartner (elemento de encabezado)

El servidor lo utiliza para devolver información a un asociado de creación de reflejo de base de datos.

sqloptions:environmentChangeNotifications (elemento de encabezado)

Habilita al cliente para especificar las notificaciones de cambio de entorno que desea recibir del servidor.

sqloptions:hostname (elemento de encabezado)

Habilita al cliente para especificar el nombre de host que va a utilizar.

sqloptions:initialDatabase (elemento de encabezado)

Habilita al cliente para especificar la base de datos inicial que va a utilizar.

sqloptions:initialLanguage (elemento de encabezado)

Habilita al cliente para especificar el lenguaje inicial que va a utilizar.

sqloptions:notificationRequest (elemento de encabezado)

Habilita al cliente para solicitar una notificación del servidor.

sqloptions:sqlSession (elemento de encabezado)

Habilita al cliente para solicitar una sesión SOAP.

Encabezado de WS-Security

El encabezado de Web Services Security (WS-Security) es compatible con SQL Server para especificar las credenciales de nombre de usuario y contraseña que se van a utilizar en la autenticación SQL Server. Para obtener más información acerca de la compatibilidad del encabezado de WS-Security en SQL Server, vea Autenticación de SQL Server por medio de SOAP.

WS-Security se basa en un estándar abierto que se ha presentado a OASIS (Organization for the Advancement of Structured Information Standards). Para obtener más información acerca de la arquitectura estándar de WS-Security, visite el sitio Web de OASIS en http://www.oasis-open.org.