Partilhar via


Cabeçalhos de extensão SOAP

Esse recurso será removido em uma versão futura do Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam.

A partir do SQL Server 2005, uma solicitação enviada a uma instância do SQL Server usando HTTP e SOAP pode conter cabeçalhos opcionais no envelope SOAP que modificarão a forma como a solicitação é executada. De modo semelhante, às vezes, a instância do SQL Server pode retornar informações adicionais do cabeçalho de SOAP para atividades específicas, como espelhamento de banco de dados. Estes são os cabeçalhos opcionais:

  • Cabeçalhos opcionais de SQL

  • Cabeçalho de WS-Security (Web Services Security)

Cabeçalhos opcionais de SQL

Esses cabeçalhos opcionais do SQL Server foram adicionados ao suporte a HTTP SOAP principalmente para obter paridade com as opções disponíveis no acesso de dados SQL tradicional por conexões de rede nas quais se utiliza o protocolo TDS (Tabular Data Stream).

A menos que especificado o contrário nesta seção, cada um desses cabeçalhos opcionais usa o namespace URI de "https://schemas.microsoft.com/sqlserver/2004/SOAP/Options" e é associado ao prefixo de namespace sqloptions declarado da seguinte maneira para cada cabeçalho:

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

A tabela a seguir lista todos os cabeçalhos opcionais de SQL disponíveis para uso nas mensagens de solicitações SOAP no SQL Server.

Cabeçalho

Descrição

Elemento de cabeçalho sqloptions:applicationName

Permite que o cliente especifique o nome do aplicativo a ser usado.

Elemento de cabeçalho sqloptions:clientInterface

Permite que o cliente especifique uma interface cliente a ser usada.

Elemento de cabeçalho sqloptions:clientNetworkID

Permite que o cliente especifique uma ID de rede de cliente que será usado no logon de SQL.

sqloptions:clientPID (elemento de cabeçalho)

Permite que o cliente especifique a ID de processo cliente a ser utilizada.

sqloptions:databaseMirroringPartner (elemento de cabeçalho)

Usado pelo servidor para retornar informações a um parceiro de criação de espelho de banco de dados.

sqloptions:environmentChangeNotifications (elemento de cabeçalho)

Permite que o cliente especifique quais notificações de alteração de ambiente deseja receber do servidor.

Elemento de cabeçalho sqloptions:hostname

Permite que o cliente especifique um nome de host a ser usado.

Elemento de cabeçalho sqloptions:initialDatabase

Permite que o cliente especifique o banco de dados inicial a ser usado.

Elemento de cabeçalho sqloptions:initialLanguage

Permite que o cliente especifique o idioma inicial a ser usado.

Elemento de cabeçalho sqloptions:notificationRequest

Permite que o cliente solicite uma notificação do servidor.

Elemento do cabeçalho sqloptions:sqlSession

Permite que o cliente solicite uma sessão SOAP.

O cabeçalho de WS-Security

O cabeçalho de WS-Security pode ser usado com SQL Server para especificar as credenciais de nome de usuário e senha para uso na autenticação SQL Server. Para obter mais informações sobre o cabeçalho de WS-Security no SQL Server, consulte Autenticação de SQL Server por meio de SOAP.

O WS-Security se baseia em um padrão aberto que foi enviado ao OASIS (Organization for the Advancement of Structured Information Standards). Para obter mais informações sobre a arquitetura padrão de WS-Security, visite o site da Web do OASIS em .