NSScheduledSubscriptionList (Transact-SQL)

Articolo
12/15/2008

Crea un report con l'elenco delle sottoscrizioni pianificate per un'applicazione di Microsoft SQL Server Notification Services. Il report contiene informazioni su tutte le sottoscrizioni pianificate per un determinato sottoscrittore.

Per i risultati viene eseguita la conversione nell'ora locale e viene tenuto conto della differenza dovuta all'ora legale con riferimento alle impostazioni internazionali. I risultati sono utili per capire il motivo per cui una sottoscrizione non ha generato una notifica alla data e ora previste. Accade di frequente che gli utenti configurino le informazioni relative alle sottoscrizioni in modo inesatto, con la conseguenza che le notifiche vengono generate in momenti imprevisti.

Sintassi

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

Argomenti

[ @SubscriberId = ] 'subscriber_id'

Identificatore univoco utilizzato per rappresentare un sottoscrittore nell'istanza di Notification Services. subscriber_id è di tipo nvarchar(255) e non prevede alcun valore predefinito.

[ @StartDate = ] 'start_date'

Data e ora UTC (Coordinated Universal Time o ora di Greenwich) di inizio per le sottoscrizioni pianificate. start_date è di tipo datetime e non prevede alcun valore predefinito.

[ @EndDate = ] 'end_date'

Data e ora UTC di fine per le sottoscrizioni pianificate. Se l'argomento non viene specificato (o se il valore è NULL), come valore predefinito verrà utilizzato il valore di start_date più un giorno. end_date è di tipo datetime.

[ @Language = ] 'language_code'

Una delle lingue di Notification Services e specifica la lingua da includere nel report. language_code restituisce un sottoinsieme di fusi orari dalla tabella NSTimeZoneNames del database dell'istanza. language_code è di tipo nvarchar(6) e il valore predefinito è 'en' (inglese).

Per l'elenco completo dei valori di language_code, vedere Subscriber Locale Codes.

Set di risultati

Il set di risultati di NSScheduledSubscriptionList è ordinato innanzitutto in base al valore di SubscriptionClassName e quindi in base al valore di SubscriptionId.

Nome colonna	Tipo di dati	Descrizione
SubscriberEnabled	tinyint	Indica se il sottoscrittore è abilitato. Un valore diverso da zero indica che il sottoscrittore è abilitato e può generare notifiche.
SubscriptionClassName	nvarchar(255)	Nome della classe di sottoscrizione che contiene la sottoscrizione pianificata per il sottoscrittore.
SubscriptionId	bigint	ID di una sottoscrizione per il sottoscrittore.
SubscriptionEnabled	tinyint	Indica se la sottoscrizione è abilitata. Un valore diverso da zero indica che la sottoscrizione è abilitata e può generare notifiche.
ScheduleText	nvarchar(2048)	Testo della pianificazione specificato dall'utente per la sottoscrizione.
UtcDateTime	datetime	Data e ora UTC in cui verrà elaborata la sottoscrizione pianificata. Se il valore è NULL, alla sottoscrizione non sono associati una data e ora pianificati compresi nell'intervallo di tempo specificato.
LocalTimeZone	nvarchar(100)	Nome del fuso orario locale per la sottoscrizione.
Observing	nvarchar(100)	Indica se per la sottoscrizione viene osservata l'ora legale. La stringa di testo restituita è la stringa specifica del fuso orario.
LocalDateTime	datetime	Data e ora locale per la sottoscrizione pianificata. La data e l'ora indicano se per il fuso orario è attiva l'ora legale o l'ora solare. Se il valore è NULL, alla sottoscrizione non sono associati una data e ora pianificati compresi nell'intervallo di tempo specificato.

Osservazioni

Notification Services crea la stored procedure NSScheduledSubscriptionList nel database dell'applicazione quando viene creata l'istanza. Quando si aggiorna l'applicazione, Notification Services ricompila la stored procedure.

Questa stored procedure è disponibile nello schema dell'applicazione, specificato dall'elemento SchemaName del file di definizione dell'applicazione (ADF). Se non si specifica un nome di schema, viene utilizzato lo schema predefinito dbo.

Per stabilire la data e l'ora UTC correnti, eseguire SELECT GETUTCDATE() in SQL Server Management Studio. L'ora UTC corrente viene calcolata in base all'ora locale corrente e all'impostazione del fuso orario del sistema operativo del computer in cui è in esecuzione SQL Server.

Autorizzazioni

Le autorizzazioni di esecuzione vengono assegnate per impostazione predefinita ai membri del ruolo di database NSAnalysis, del ruolo predefinito del database db_owner e del ruolo predefinito del server sysadmin.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Esempi

A. Ottenere le sottoscrizioni pianificate per una data specifica

Nell'esempio seguente viene illustrato come creare un report di tutte le sottoscrizioni pianificate per il 24 maggio 2004 per il sottoscrittore "karen".

L'applicazione utilizza le impostazioni predefinite di SchemaName, che prevedono l'inserimento di tutti gli oggetti dell'applicazione nello schema dbo.

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

A. Ottenere le sottoscrizioni pianificate per un periodo di tempo specifico

Nell'esempio seguente viene illustrato come creare un report di tutte le sottoscrizioni pianificate negli ultimi due giorni per il sottoscrittore "karen".

In questo esempio, la stored procedure (come tutti gli altri oggetti dell'applicazione) è inclusa nello schema Stock, come specificato nell'elemento SchemaName del file di configurazione dell'applicazione (ADF).

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

Vedere anche

Share via