Alert Object

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é.

The Alert object represents a single SQL Server Agent alert. Alerts respond to either specific Microsoft SQL Server error messages or SQL Server errors of a specified severity.

Modèle objet SQL-DMO qui affiche l'objet en cours

Notes

You can use the Alert object to create and manage SQL Server Agent alerts:

  • Create an alert to respond to a specific SQL Server error.

  • Change the properties of an existing alert to modify its behavior.

  • Change the notified operators on an instance of the error condition.

The Name property of an Alert object uses the SQL Server data type sysname. The string must be a unique value for each Alert object in the Alerts collection.

SQL Server does not allow the creation of more than one alert on any given error condition or severity level. More than one alert can be defined on a specific message identifier; however, each alert defined must be limited in scope by associating the alert with a specific database.

SQL Server alerts are enabled by default. However, an alert created with the minimum required values will fire no notifications. You must assign operators to the alert by using the AddNotification method of the Alert or Operator object.

To create an alert

  1. Create an Alert object.

  2. Set the Name property.

  3. Set the response type for the alert by setting the value of the Severity property or the MessageIDproperty.

  4. Set any optional properties you want. For example, set the DatabaseName property to limit the alert's action to a specific database, or use the AddNotification method to add operators to the alert.

  5. Add the Alert object to the Alerts collection of a connected JobServer object.

To alter an existing alert

  1. Get an Alert object from the Alerts collection of a connected JobServer object.

  2. Use the BeginAlter method to mark the beginning of the changes.

  3. Set the Alert object properties to reflect changes in alert behaviors.

  4. Use the DoAlter method to submit the alert changes to SQL Server.

Voir aussi

Référence

Concepts