NSScheduledSubscriptionList (Transact-SQL)

Artículo
12/15/2008

Genera el informe de lista de suscripciones programadas para una aplicación de Microsoft SQL Server Notification Services. El informe contiene información acerca de todas las suscripciones programadas para un suscriptor dado.

En los resultados se aplica la conversión a la hora local y se tienen en cuenta los cambios del horario de verano correspondientes a la configuración regional. Los resultados sirven para diagnosticar los motivos por los cuales una suscripción no generó una notificación en el momento esperado. A veces, los usuarios configuran la información de suscripción de manera incorrecta, por lo que las notificaciones se generan en momentos inesperados.

Sintaxis

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

Argumentos

[ @SubscriberId = ] 'subscriber_id'

Es el identificador único utilizado para representar un suscriptor en la instancia de Notification Services. subscriber_id es de tipo nvarchar(255) y no tiene ningún valor predeterminado.

[ @StartDate = ] 'start_date'

Es la fecha y hora de inicio de las suscripciones programadas, en UTC (hora universal coordinada u hora del meridiano de Greenwich). start_date es de tipo datetime y no tiene ningún valor predeterminado.

[ @EndDate = ] 'end_date'

Es la fecha y hora (UTC) de finalización de las suscripciones programadas. Si no se especifica (o si es NULL), el valor predeterminado es el valor de start_date más un día. end_date es de tipo datetime.

[ @Language = ] 'language_code'

Es uno de los idiomas de Notification Services y especifica el idioma que se incluirá en el informe. language_code se utiliza para devolver un subconjunto de zonas horarias de la tabla NSTimeZoneNames de la base de datos de instancias. language_code es de tipo nvarchar(6) y tiene el valor predeterminado 'en' (inglés).

Para obtener una lista completa de los valores de language_code, vea Subscriber Locale Codes.

Conjuntos de resultados

El conjunto de resultados de NSScheduledSubscriptionList se ordena por el valor de SubscriptionClassName y, después, por el valor de SubscriptionId.

Nombre de columna	Tipo de datos	Descripción
SubscriberEnabled	tinyint	Indica si el suscriptor está habilitado actualmente. Un valor distinto de cero indica que el suscriptor está habilitado y puede generar notificaciones.
SubscriptionClassName	nvarchar(255)	Nombre de la clase de suscripción que contiene la suscripción programada para el suscriptor.
SubscriptionId	bigint	Id. de una suscripción para el suscriptor.
SubscriptionEnabled	tinyint	Indica si la suscripción está habilitada. Un valor distinto de cero indica que la suscripción está habilitada y puede generar notificaciones.
ScheduleText	nvarchar(2048)	Texto de programación proporcionado por el usuario para la suscripción.
UtcDateTime	datetime	Fecha y hora (UTC) en que se va a procesar la suscripción programada. Si el valor es NULL, la suscripción no tiene ninguna hora programada dentro del intervalo de tiempo especificado.
LocalTimeZone	nvarchar(100)	Nombre de la zona horaria local para la suscripción.
Observing	nvarchar(100)	Indica si la suscripción tiene en cuenta el horario de verano. La cadena de texto devuelta es la cadena específica de la zona horaria.
LocalDateTime	datetime	Fecha y hora locales para la suscripción programada. La fecha y la hora indican si la zona horaria tiene horario de verano o es la hora estándar. Si el valor es NULL, la suscripción no tiene ninguna hora programada dentro del intervalo de tiempo especificado.

Notas

Notification Services crea el procedimiento almacenado NSScheduledSubscriptionList en la base de datos de aplicación al crear la instancia. Al actualizar la aplicación, Notification Services vuelve a compilar el procedimiento almacenado.

Este procedimiento almacenado se encuentra en el esquema de la aplicación, que se especifica mediante el elemento SchemaName del archivo de definición de aplicación (ADF). Si no se proporciona ningún nombre de esquema, el esquema predeterminado es dbo.

Para determinar la fecha y hora UTC actuales, ejecute SELECT GETUTCDATE() en SQL Server Management Studio. La hora UTC actual se deriva de la hora local actual y la configuración de zona horaria del sistema operativo del equipo en el que se ejecuta SQL Server.

Permisos

De forma predeterminada, los permisos de ejecución corresponden a los miembros de las funciones de base de datos NSAnalysis y db_owner y a los miembros de la función fija de servidor sysadmin.

Valores de código de retorno

0 (correcto) o 1 (error)

Ejemplos

A. Obtener las suscripciones programadas para una fecha específica

En el ejemplo siguiente se muestra cómo generar un informe de todas las suscripciones programadas para el 24 de mayo de 2004 para el suscriptor "karen".

La aplicación utiliza la configuración predeterminada de SchemaName, que coloca todos los objetos de la aplicación en el esquema dbo.

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

B. Obtener las suscripciones programadas para un período de tiempo específico

En el ejemplo siguiente se muestra cómo generar un informe de todas las suscripciones programadas para los dos últimos días para el suscriptor "karen".

En este ejemplo, el procedimiento almacenado (al igual que los demás objetos de aplicación) se encuentra en el esquema Stock, tal y como se especifica en el elemento SchemaName del ADF.

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

Vea también

Share via