NSScheduledSubscriptionList (Transact-SQL)

Article
12/15/2008

Génère le rapport de liste des abonnements planifiés d'une application Microsoft SQL Server Notification Services. Ce rapport contient des informations sur tous les abonnements planifiés d'un abonné donné.

Les résultats gèrent la conversion d'heure locale et tiennent compte de l'heure d'été par rapport aux paramètres régionaux. Ils sont utiles pour déterminer la raison pour laquelle un abonnement n'a pas généré de notification au moment prévu. Les utilisateurs éprouvent souvent des difficultés à configurer correctement les informations des abonnements et les notifications sont parfois créées à des moments inopportuns.

Syntaxe

[ schema_name . ] NSScheduledSubscriptionList 
    [ @SubscriberId = ] 'subscriber_id',
    [ @StartDate = ] 'start_date' ]
    [, [ @EndDate = ] 'end_date' ]
    [, [ @Language = ] 'language_code' ]

Arguments

[ @SubscriberId = ] 'subscriber_id'

Identificateur unique permettant de représenter un abonné dans l'instance Notification Services. L'argument subscriber_id est de type nvarchar(255), sans valeur par défaut.

[ @StartDate = ] 'start_date'

Date et heure, en temps universel au format UTC ou GMT, des abonnements planifiés. L'argument start_date est de type datetime et n'a pas de valeur par défaut.

[ @EndDate = ] 'end_date'

Date et heure de fin, au format UTC, des abonnements planifiés. Si cet argument n'est pas spécifié (ou s'il est NULL), la valeur par défaut est la valeur start_date plus un jour. end_date est de type datetime.

[ @Language = ] 'language_code'

Une des langues de Notification Services ; spécifie la langue à inclure dans le rapport. language_code sert à retourner un sous-ensemble de fuseaux horaires de la table NSTimeZoneNames dans la base de données de l'instance. language_code est de type nvarchar(6) avec la valeur par défaut « en » (anglais).

Pour obtenir une liste complète des valeurs language_code, consultez Subscriber Locale Codes.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Notes

Notification Services crée la procédure stockée NSScheduledSubscriptionList dans la base de données de l'application lorsque vous créez l'instance. Lorsque vous mettez à jour l'application, Notification Services recompile la procédure stockée.

Cette procédure stockée se trouve dans le schéma de l'application, spécifié par l'élément SchemaName du fichier de définition de l'application. Si aucun nom de schéma n'est spécifié, le schéma par défaut est dbo.

Pour déterminer la date et l'heure UTC actuelles, exécutez SELECT GETUTCDATE() dans SQL Server Management Studio. L'heure UTC actuelle est dérivée de l'heure locale actuelle et du fuseau horaire défini dans le système d'exploitation de l'ordinateur sur lequel SQL Server est exécuté.

Autorisations

Les autorisations d'exécution sont octroyées par défaut aux membres des rôles de base de données NSAnalysis et db_owner et aux membres du rôle de serveur fixe sysadmin.

Ensembles de résultats

L'ensemble de résultats NSScheduledSubscriptionList est classé en fonction de la valeur de SubscriptionClassName, puis celle de SubscriptionId.

Nom de la colonne	Type de données	Description
SubscriberEnabled	tinyint	Indique si l'abonné est actuellement activé. Une valeur non nulle indique que l'abonné est activé et peut créer des notifications.
SubscriptionClassName	nvarchar(255)	Nom de la classe d'abonnement qui contient l'abonnement planifié de l'abonné.
SubscriptionId	bigint	ID d'un abonnement de l'abonné.
SubscriptionEnabled	tinyint	Indique si l'abonnement est activé. Une valeur non nulle indique que l'abonnement est activé et peut créer des notifications.
ScheduleText	nvarchar(2048)	Texte de la planification fourni par l'utilisateur pour l'abonnement.
UtcDateTime	datetime	Date et heure, au format UTC, auxquelles l'abonnement planifié doit être traité. Avec la valeur NULL, l'abonnement n'a pas d'horaire planifié qui tombe dans la plage de temps spécifiée.
LocalTimeZone	nvarchar(100)	Nom du fuseau horaire local de l'abonnement.
Observing	nvarchar(100)	Indique si l'abonnement suit l'heure d'été. La chaîne de texte retournée dépend du fuseau horaire.
LocalDateTime	datetime	Date et heure locales de l'abonnement planifié. La date et l'heure indiquent si le fuseau horaire observe l'heure d'été ou non. Avec la valeur NULL, l'abonnement n'a pas d'horaire planifié qui tombe dans la plage de temps spécifiée.

Exemples

A. Obtention d'abonnements planifiés pour une date spécifique

L'exemple suivant indique comment générer un rapport pour tous les abonnements planifiés pour le 4 mai 2004 pour l'abonnée « karen ».

L'application utilise les paramètres de SchemaName par défaut, qui placent tous les objets de l'application dans le schéma dbo.

EXEC dbo.NSScheduledSubscriptionList 
    @SubscriberId = N'karen', 
    @StartDate = '2004-05-24', 
    @EndDate = '2004-05-24 23:59:59';

B. Obtention d'abonnements planifiés pour une heure spécifique

L'exemple suivant indique comment générés un rapport pour tous les abonnements planifiés des deux derniers jours pour l'abonnée « karen ».

Dans cet exemple, la procédure stockée (comme tous les autres objets de l'application) se trouve dans le schéma Stock, tel que le spécifie l'élément SchemaName du fichier de configuration de l'application.

DECLARE @start datetime;
SET @start = DATEADD(day, -2, GETUTCDATE());
EXEC Stock.NSScheduledSubscriptionList 
    @SubscriberId = N'karen', 
    @StartDate = @start;

Voir aussi