NSScheduledSubscriptionDetails (Transact-SQL)
Возвращает подробные сведения о подписках того или иного класса подписки в приложении служб Microsoft SQL Server Notification Services, выполнение которых назначено в пределах заданного промежутка времени. Эта хранимая процедура работает только с теми классами подписок, для которых имеются правила подписок по расписанию.
Синтаксис
[ schema_name . ] NSScheduledSubscriptionDetails
[ @SubscriptionClassName = ] 'sub_class_name',
[ @StartTime = ] 'start_time',
[ @EndTime = ] 'end_time'
Аргументы
- [ @SubscriptionClassName = ] 'sub_class_name'
Имя класса подписки. Аргумент sub_class_name имеет тип nvarchar(255) и не имеет значения по умолчанию.
- [ @StartTime = ] 'start_time'
Дата и время запуска в формате UTC (координированное всемирное время или время по Гринвичу) для запрашиваемого периода времени. Аргумент start_time имеет тип datetime и не имеет значения по умолчанию.
- [ @EndTime = ] 'end_time'
Дата и время окончания в формате UTC для запрашиваемого периода времени. Аргумент end_time имеет тип datetime и не имеет значения по умолчанию. Значение аргумента end_time не может быть больше, чем время, указанное в аргументе start_time, плюс 24 часа.
Значения кодов возврата
Нет
Результирующие наборы
Результирующий набор NSScheduledSubscriptionDetails упорядочивается по параметру ScheduleTime.
| Имя столбца | Тип данных | Описание |
|---|---|---|
SubscriptionId |
bigint |
Уникальный идентификатор назначенной по расписанию подписки. |
SubscriberId |
nvarchar(255) |
Уникальный идентификатор подписчика, владеющего подпиской. |
CreationDate |
datetime |
Дата и время создания подписки в формате UTC. |
UpdateDate |
datetime |
Дата и время последнего обновления подписки в формате UTC. |
Enabled |
bit |
Указывает, включена или отключена подписка в данный момент. Значение 1 означает, что подписка включена. |
ScheduleTime |
datetime |
Дата и время в формате UTC, на которые назначена обработка подписки. |
Subscription_Class_Field_Name |
приложение определено |
Имя поля класса подписки, определенное в файле определения приложения (ADF). Каждое поле в классе подписки в результирующем наборе представляется столбцом. |
Замечания
Службы Notification Services при создании экземпляра создают в базе данных приложения хранимую процедуру NSScheduledSubscriptionDetails. При обновлении приложения службы Notification Services перекомпилируют хранимую процедуру.
Эта хранимая процедура находится в схеме приложения, заданной элементом SchemaName файла определения приложения (ADF). Если имя схемы не задано, применяется схема по умолчанию dbo.
Для определения текущих даты и времени в формате UTC запустите инструкцию SELECT GETUTCDATE() в среде SQL Server Management Studio. Текущее время в формате UTC складывается из текущего местного времени и настройки часового пояса в операционной системе компьютера, на котором запущен SQL Server.
Разрешения
Разрешения на выполнение по умолчанию назначены членам ролей баз данных NSAnalysis и db_owner, а также фиксированной серверной роли sysadmin.
Примеры
В следующем примере показано, как создать отчет о назначенных подписках класса PortfolioSubscriptions приложения Stock. Отчет содержит сведения о подписках, назначенных на запуск 23 мая 2004 г. по времени UTC.
Приложением используются настройки схемы SchemaName по умолчанию, при которых все объекты приложения помещаются в схему dbo.
EXEC dbo.NSScheduledSubscriptionDetails
@SubscriptionClassName = N'PortfolioSubscriptions',
@StartTime = '2004-05-23 00:00:00',
@EndTime = '2004-05-23 23:59:59';
См. также
Справочник
Хранимые процедуры служб Notification Services (Transact-SQL)
Другие ресурсы
Отчеты о производительности служб Notification Services
SchemaName Element (ADF)