Share via

  • Статья

sp_helpdynamicsnapshot_job (Transact-SQL)

Возвращает сведения о заданиях агента, которые формируют моментальные снимки фильтрованных данных. Эта хранимая процедура выполняется на издателе в базе данных публикации.

Значок ссылки на разделСинтаксические обозначения в Transact-SQL

Синтаксис

sp_helpdynamicsnapshot_job [ [ @publication = ] 'publication' ] 
    [ , [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname' ]
    [ , [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' ]

Аргументы

  • [ @publication=] 'publication'
    Имя публикации. Аргумент publication имеет тип sysname и значение % по умолчанию. При этом значении возвращаются сведения по всем заданиям моментальных снимков фильтрованных данных, которые совпадают с указанными dynamic_snapshot_jobid и dynamic_snapshot_jobname для всех публикаций.

  • [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname'
    Имя задания моментального снимка фильтрованных данных. Аргумент dynamic_snapshot_jobname имеет тип sysname и значение % по умолчанию. При этом значении возвращаются все динамические задания для публикации с указанным аргументом dynamic_snapshot_jobid. Если имя задания было задано явно во время создания задания, оно будет в следующем формате:

    'dyn_' + <name of the standard snapshot job> + <GUID>

  • [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'
    Идентификатор задания моментального снимка фильтрованных данных. Аргумент dynamic_snapshot_jobid имеет тип uniqueidentifier и значение NULL по умолчанию. При этом значении возвращаются все задания моментального снимка, которые совпадают с указанным аргументом dynamic_snapshot_jobname.

Результирующие наборы

Имя столбца

Тип данных

Описание

id

int

Задание моментального снимка фильтрованных данных.

job_name

sysname

Имя задания моментального снимка фильтрованных данных.

job_id

uniqueidentifier

Задание агента Microsoft SQL Server на стороне распространителя.

dynamic_filter_login

sysname

Значение, используемое для вычисления функции SUSER_SNAME в параметризованном фильтре строк, определенном для публикации.

dynamic_filter_hostname

sysname

Значение, используемое для вычисления функции HOST_NAME в параметризованном фильтре строк, определенном для публикации.

dynamic_snapshot_location

nvarchar(255)

Путь к папке, откуда считываются файлы моментального снимка, если используется параметризованный фильтр строк.

frequency_type

int

Частота, с которой агент выполняется по расписанию, может иметь одно из следующих значений.

1 = Один раз

2 = По требованию

4 = Ежедневно

8 = Еженедельно

16 = Ежемесячно

32 = Ежемесячное расписание

64 = Автозапуск

128 = Повторять

frequency_interval

int

День, когда агент выполняется, может иметь одно из следующих значений.

1 = Воскресенье

2 = Понедельник

3 = Вторник

4 = Среда

5 = Четверг

6 = Пятница

7 = Суббота

8 = День

9 = Рабочие дни

10 = Выходные дни

frequency_subday_type

int

Тип, который определяет, как часто запускается агент, если аргумент frequency_type равен 4 (ежедневно) и может принимать одно из следующих значений.

1 = В указанное время

2 = Секунды

4 = Минуты

8 = Часы

frequency_subday_interval

int

Число интервалов frequency_subday_type, которые проходят между запланированными выполнениями агента.

frequency_relative_interval

int

Неделя, когда запускается агент в данном месяце, если аргумент frequency_type равен 32 (ежемесячно, относительная дата), и может принимать одно из таких значений.

1 = Первая

2 = Вторая

4 = Третья

8 = Четвертая

16 = Последняя

frequency_recurrence_factor

int

Число недель или месяцев между запланированными выполнениями агента.

active_start_date

int

Дата, когда агент будет впервые выполнен, в формате ГГГГММДД.

active_end_date

int

Дата, когда агент будет выполнен в последний раз, в формате ГГГГММДД.

active_start_time

int

Время, когда агент будет впервые выполнен, в формате ЧЧММСС.

active_end_time

int

Время, когда агент будет выполнен в последний раз, в формате ЧЧММСС.

Значения кодов возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Замечания

Процедура sp_helpdynamicsnapshot_job используется в репликации слиянием.

Если для всех аргументов используются значения по умолчанию, возвращаются сведения по всем заданиям моментального снимка секционных данных для всей базы данных публикации.

Разрешения

Только члены предопределенной роли сервера sysadmin и предопределенной роли базы данных db_owner, а также входящие в список доступа публикации могут выполнять процедуру sp_helpdynamicsnapshot_job.