Partager via


En-têtes d'extension SOAP

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité.

À compter de SQL Server 2005, Une demande envoyée à une instance de SQL Server à l'aide de HTTP et de SOAP peut contenir dans l'enveloppe SOAP des en-têtes facultatifs susceptibles de modifier l'exécution de la demande. De même, l'instance de SQL Server peut parfois retourner des informations d'en-tête SOAP supplémentaires sur des activités spécifiques, telles que la mise en miroir de bases de données. Les en-têtes facultatifs sont les suivants :

  • En-têtes SQL facultatifs

  • En-tête WS-Security (Web Services Security)

En-têtes SQL facultatifs

Ces en-têtes facultatifs de SQL Server ont été ajoutés à la prise en charge SOAP HTTP essentiellement à des fins de parité avec les options disponibles dans l'accès aux données SQL traditionnel via les connexions réseau utilisant le protocole TDS (Tabular Data Stream).

Sauf indication contraire dans cette section, chacun de ces en-têtes facultatifs utilise l'URI d'espace de noms « **https://schemas.microsoft.com/sqlserver/2004/SOAP/Options** » et est associé au préfixe d'espace de noms sqloptions déclaré de la façon suivante :

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

Le tableau ci-dessous répertorie tous les en-têtes SQL facultatifs utilisables dans la messagerie des demandes SOAP sous SQL Server.

En-tête

Description

Élément d'en-tête sqloptions:applicationName

Permet au client de spécifier un nom d'application à utiliser.

Élément d'en-tête sqloptions:clientInterface

Permet au client de spécifier une interface cliente à utiliser.

Élément d'en-tête sqloptions:clientNetworkID

Permet au client de spécifier un ID réseau client à utiliser dans la connexion SQL.

Élément d'en-tête sqloptions:clientPID

Permet au client de spécifier un ID de processus client à utiliser.

Élément d'en-tête sqloptions:databaseMirroringPartner

Permet au serveur de renvoyer des informations à un partenaire de mise en miroir de bases de données.

Élément d'en-tête sqloptions:environmentChangeNotifications

Permet au client de spécifier les notifications de modification d'environnement qu'il souhaite recevoir du serveur.

Élément d'en-tête sqloptions:hostname

Permet au client de spécifier un nom d'hôte à utiliser.

Élément d'en-tête sqloptions:initialDatabase

Permet au client de spécifier la base de données initiale à utiliser.

Élément d'en-tête sqloptions:initialLanguage

Permet au client de spécifier la langue initiale à utiliser.

Élément d'en-tête sqloptions:notificationRequest

Permet au client de demander une notification au serveur.

Élément d'en-tête sqloptions:sqlSession

Permet au client de demander une session SOAP.

En-tête WS-Security

L'en-tête WS-Security (Web Services Security) peut être utilisé avec SQL Server pour spécifier les informations d'identification relatives au nom et au mot de passe de l'utilisateur dans le cadre de l'authentification SQL Server. Pour plus d'informations sur la prise en charge de l'en-tête WS-Security dans SQL Server, consultez Authentification SQL Server sur SOAP.

La technologie WS-Security est basée sur une norme ouverte qui a été soumise à l'OASIS (Organization for the Advancement of Structured Information Standards). Pour plus d'informations sur l'architecture standard de WS-Security, visitez le site Web d'OASIS à l'adresse http://www.oasis-open.org.