Objetos de Automação OLE no Transact-SQL

Transact-SQL inclui vários procedimentos armazenados do sistema que permitem que objetos de Automação OLE sejam referenciados em lotes Transact-SQL, procedimentos armazenados e gatilhos. Esses procedimentos armazenados do sistema são executados como procedimentos armazenados estendidos, e os objetos de Automação OLE que são executados por meio desses procedimentos armazenados operam no espaço de endereço de uma instância do Mecanismo de Banco de Dados do SQL Server, da mesma forma que um procedimento armazenado estendido é executado.

Os procedimentos armazenados da Automação OLE permitem que Transact-SQL lotes façam referência a objetos SQL-DMO e objetos personalizados da Automação OLE, como objetos que expõem a interface IDispatch . Um servidor OLE personalizado em processo criado usando o Microsoft Visual Basic deve ter um manipulador de erros (especificado com a instrução On Error GoTo ) para as sub-rotinas Class_Initialize e Class_Terminate . Erros sem tratamento nas sub-rotinas Class_Initialize e Class_Terminate podem causar erros imprevisíveis, como uma violação de acesso em uma instância do Mecanismo de Banco de Dados. Manipuladores de erro para outras sub-rotinas também são recomendados.

A primeira etapa ao usar um objeto de Automação OLE no Transact-SQL é chamar o procedimento armazenado do sistema sp_OACreate para criar uma instância do objeto no espaço de endereço da instância do Mecanismo de Banco de Dados.

Depois que uma instância do objeto tiver sido criada, chame os seguintes procedimentos armazenados para trabalhar com as propriedades, métodos e informações de erro relacionadas ao objeto:

• sp_OAGetProperty obtém o valor de uma propriedade.

• sp_OASetProperty define o valor de uma propriedade.

• sp_OAMethod chama um método.

• sp_OAGetErrorInfo obtém as informações de erro mais recentes.

Quando não houver mais necessidade do objeto, chame sp_OADestroy para desalocar a instância do objeto criado usando sp_OACreate.

Os objetos de Automação OLE retornam dados por meio de valores e métodos de propriedade. sp_OAGetProperty e sp_OAMethod retornam esses valores de dados na forma de um conjunto de resultados.

O escopo de um objeto de Automação OLE é um lote. Todas as referências ao objeto devem estar contidas em um único lote, procedimento armazenado ou gatilho.

Quando faz referência a objetos, os objetos de Automação OLE do SQL Server dão suporte à passagem do objeto referenciado para outros objetos que ele contém. Por exemplo, ao usar o objeto SQL-DMO SQLServer , as referências podem ser feitas em bancos de dados e tabelas contidas nesse servidor.

Conteúdo relacionado

Sintaxe da Hierarquia de Objetos (Transact-SQL)

Configuração da Área de Superfície

Opção de Configuração do Servidor de Procedimentos de Automação do Ole

sp_OACreate (Transact-SQL)

sp_OAGetProperty (Transact-SQL)

sp_OASetProperty (Transact-SQL)

sp_OAMethod (Transact-SQL)

sp_OAGetErrorInfo (Transact-SQL)

sp_OADestroy (Transact-SQL)