Objets d'automatisation OLE dans Transact-SQL

Transact-SQL inclut plusieurs procédures stockées système qui permettent aux objets OLE Automation d’être référencés dans Transact-SQL lots, procédures stockées et déclencheurs. Ces procédures stockées système s’exécutent en tant que procédures stockées étendues, et les objets OLE Automation exécutés via les procédures stockées s’exécutent dans l’espace d’adressage d’une instance du moteur de base de données SQL Server de la même façon qu’une procédure stockée étendue s’exécute.

Les procédures stockées OLE Automation permettent aux paquets Transact-SQL de référencer des objets SQL-DMO et des objets OLE Automation personnalisés, comme ceux qui exposent l’interface IDispatch. Un serveur OLE in-process personnalisé créé à l’aide de Microsoft Visual Basic doit avoir un gestionnaire d’erreurs (spécifié avec l’instruction On Error GoTo ) pour les sous-routines Class_Initialize et Class_Terminate . Les erreurs non gérées dans les Class_Initialize et les sous-routines Class_Terminate peuvent entraîner des erreurs imprévisibles, telles qu’une violation d’accès dans une instance du moteur de base de données. Les gestionnaires d’erreurs pour d’autres sous-routines sont également recommandés.

La première étape lors de l’utilisation d’un objet OLE Automation dans Transact-SQL consiste à appeler la procédure stockée système sp_OACreate pour créer une instance de l’objet dans l’espace d’adressage de l’instance du moteur de base de données.

Une fois qu’une instance de l’objet a été créée, appelez les procédures stockées suivantes pour utiliser les propriétés, méthodes et informations d’erreur relatives à l’objet :

• sp_OAGetProperty obtient la valeur d’une propriété.

• sp_OASetProperty définit la valeur d’une propriété.

• sp_OAMethod appelle une méthode.

• sp_OAGetErrorInfo obtient les informations d’erreur les plus récentes.

Lorsqu’il n’y a plus besoin de l’objet, appelez sp_OADestroy pour libérer l’instance de l’objet créé à l’aide de sp_OACreate.

Les objets OLE Automation retournent des données par le biais de valeurs et de méthodes de propriété. sp_OAGetProperty et sp_OAMethod renvoyer ces valeurs de données sous la forme d’un jeu de résultats.

L’étendue d’un objet OLE Automation est un traitement par lot. Toutes les références à l’objet doivent être contenues dans un seul lot, procédure stockée ou déclencheur.

Lorsqu’il fait référence à des objets, les objets OLE Automation SQL Server prennent en charge le passage de l’objet référencé à d’autres objets qu’il contient. Par exemple, lors de l’utilisation de l’objet SQL-DMO SQLServer , des références peuvent être apportées aux bases de données et aux tables contenues sur ce serveur.

Contenu associé

Syntaxe de hiérarchie d’objets (Transact-SQL)

Configuration de la surface d'exposition

Option de configuration du serveur Ole Automation Procedures

sp_OACreate (Transact-SQL)

sp_OAGetProperty (Transact-SQL)

sp_OASetProperty (Transact-SQL)

sp_OAMethod (Transact-SQL)

sp_OAGetErrorInfo (Transact-SQL)

sp_OADestroy (Transact-SQL)