sys.sp_helpdynamicsnapshot_job (Transact-SQL)

Aplica-se a: SQL ServerAzure SQL Managed Instance

Devolve informação sobre trabalhos de agente que geram instantâneos de dados filtrados. Este procedimento armazenado é executado no Publisher no banco de dados de publicação.

Transact-SQL convenções de sintaxe

Syntax

sys.sp_helpdynamicsnapshot_job
    [ [ @publication = ] N'publication' ]
    [ , [ @dynamic_snapshot_jobname = ] N'dynamic_snapshot_jobname' ]
    [ , [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' ]
[ ; ]

Arguments

@publication [ = ] N'publicação'

O nome da publicação. @publication é sysname, com um padrão de %, que devolve informação sobre todos os trabalhos de snapshot de dados filtrados que correspondem ao @dynamic_snapshot_jobid e @dynamic_snapshot_jobname especificados para todas as publicações.

[ @dynamic_snapshot_jobname = ] N'dynamic_snapshot_jobname'

O nome de um trabalho de snapshot de dados filtrado. @dynamic_snapshot_jobname é sysname, com um padrão de %, que devolve todos os trabalhos dinâmicos de uma publicação com a @dynamic_snapshot_jobname especificada. Se o nome da vaga não foi explicitamente especificado quando a função foi criada, o nome da função está no formato 'dyn_' + <name of the standard snapshot job> + <GUID>.

[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'

Um identificador para um trabalho de snapshot de dados filtrado. @dynamic_snapshot_jobid é um identificador único, com um padrão de NULL, que devolve todos os trabalhos de snapshot que correspondem à @dynamic_snapshot_jobname especificada.

Conjunto de resultados

Nome da coluna Tipo de dados Descrição
id int Identifica o trabalho de snapshot de dados filtrado.
job_name sysname Nome do trabalho de snapshot de dados filtrado.
job_id uniqueidentifier Identifica o trabalho de SQL Server Agent no Distribuidor.
dynamic_filter_login sysname Valor usado para avaliar a função SUSER_SNAME num filtro de linha parametrizado definido para a publicação.
dynamic_filter_hostname sysname Valor usado para avaliar a função HOST_NAME num filtro de linhas parametrizado definido para a publicação.
dynamic_snapshot_location nvarchar(255) Caminho para a pasta de onde os ficheiros snapshot são lidos se for usado um filtro de linhas parametrizado.
frequency_type int É a frequência com que o agente está programado para executar, que pode ser um destes valores.

1 = Uma vez
2 = A pedido
4 = Diário
8 = Semanal
16 = Mensal
32 = Relativo mensal
64 = Arranque automático
128 = Recorrentes
frequency_interval int Os dias em que o agente corre, o que pode ser um desses valores.

1 = Domingo
2 = Segunda-feira
3 = Terça-feira
4 = Quarta-feira
5 = Quinta-feira
6 = Sexta-feira
7 = Sábado
8 = Dia
9 = Dias úteis
10 = Dias de fim de semana
frequency_subday_type int É o tipo que define com que frequência o agente é executado quando frequency_type é 4 (diariamente), e pode ser um destes valores.

1 = No momento especificado
2 = Segundos
4 = Minutos
8 = Horas
frequency_subday_interval int Número de intervalos de frequency_subday_type que ocorrem entre a execução programada do agente.
frequency_relative_interval int É a semana em que o agente corre num dado mês em que frequency_type é 32 (relativo mensal), e pode ser um destes valores.

1 = Primeiro
2 = Segundo
4 = Terceira
8 = Quarto
16 = Último
frequency_recurrence_factor int Número de semanas ou meses entre a execução programada do agente.
active_start_date int Data em que o agente está agendado para a sua primeira publicação, formatada como yyyyMMdd.
active_end_date int Data em que o agente está agendado pela última vez para correr, formatada como yyyyMMdd.
active_start_time int Tempo em que o agente está agendado para a primeira execução, formatado como HHmmss.
active_end_time int Hora em que o agente está agendado para a última execução, formatado como HHmmss.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Observações

sp_helpdynamicsnapshot_job é usado na replicação por fusão.

Se forem usados todos os valores de parâmetros padrão, é devolvida informação sobre todos os trabalhos de snapshot de dados particionados para toda a base de dados de publicação.

Permissions

Apenas os membros do sysadmin função fixa de servidor, a db_owner função fixa de base de dados e a lista de acesso à publicação para a publicação podem executar sp_helpdynamicsnapshot_job.