NSScheduledSubscriptionDetails (Transact-SQL)
Devuelve información detallada sobre las suscripciones de una clase de suscripción de una aplicación de Microsoft SQL Server Notification Services que están programadas para ser evaluadas en un período de tiempo dado. Este procedimiento almacenado sólo funciona con las clases de suscripción que tienen reglas de suscripción programadas.
Sintaxis
[ schema_name . ] NSScheduledSubscriptionDetails
[ @SubscriptionClassName = ] 'sub_class_name',
[ @StartTime = ] 'start_time',
[ @EndTime = ] 'end_time'
Argumentos
[ @SubscriptionClassName = ] 'sub_class_name'
Es el nombre de una clase de suscripción. sub_class_name es de tipo nvarchar(255) y no tiene ningún valor predeterminado.
[ @StartTime = ] 'start_time'
Es la fecha y hora de inicio del período de tiempo en cuestión, en UTC (hora universal coordinada u hora del meridiano de Greenwich). start_time es de tipo datetime y no tiene ningún valor predeterminado.
[ @EndTime = ] 'end_time'
Es la fecha y hora de finalización del período de tiempo en cuestión, en UTC. end_time es de tipo datetime y no tiene ningún valor predeterminado. No se puede especificar un valor de end_time superior a 24 horas después del valor de start_time.
Conjuntos de resultados
El conjunto de resultados de NSScheduledSubscriptionDetails se ordena por ScheduleTime.
| Nombre de columna | Tipo de datos | Descripción |
|---|---|---|
SubscriptionId |
bigint |
Id. único de la suscripción programada. |
SubscriberId |
nvarchar(255) |
Id. único del suscriptor al que pertenece la suscripción. |
CreationDate |
datetime |
Fecha y hora UTC en que se creó la suscripción. |
UpdateDate |
datetime |
Fecha y hora UTC en que se actualizó la suscripción por última vez. |
Enabled |
bit |
Indica si la suscripción está habilitada o deshabilitada actualmente. El valor 1 indica que la suscripción está habilitada. |
ScheduleTime |
datetime |
Fecha y hora UTC en que está programado el procesamiento de la suscripción. |
Subscription_Class_Field_Name |
Definido por la aplicación |
Nombre de un campo de clase de suscripción, tal como se define en el archivo de definición de aplicación (ADF). Cada campo de la clase de suscripción está representado por una columna en el conjunto de resultados. |
Notas
Notification Services crea el procedimiento almacenado NSScheduledSubscriptionDetails 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
Ninguno
Ejemplos
En el ejemplo siguiente se muestra cómo generar el informe de suscripciones programadas para la clase de suscripción PortfolioSubscriptions de la aplicación Stock. El informe contiene información sobre las suscripciones que están programadas para ejecutarse el 23 de mayo de 2004, utilizando los valores de hora UTC.
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.NSScheduledSubscriptionDetails
@SubscriptionClassName = N'PortfolioSubscriptions',
@StartTime = '2004-05-23 00:00:00',
@EndTime = '2004-05-23 23:59:59';
Vea también
Referencia
Procedimientos almacenados de Notification Services (Transact-SQL)
Otros recursos
Informes de rendimiento de Notification Services
SchemaName Element (ADF)