sp_helpdynamicsnapshot_job (Transact-SQL)

  • Artigo

Aplica-se a:SQL ServerInstância Gerenciada de SQL do Azure

Retorna informações sobre trabalhos de agente que geram instantâneos de dados filtrados. Esse procedimento armazenado é executado no Publicador, no banco de dados publicador.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

[ @publication = ] 'publication' É o nome da publicação. publication é sysname, com um padrão de , que retorna informações sobre todos os trabalhos de instantâneo de %dados filtrados que correspondem à dynamic_snapshot_jobide dynamic_snapshot_jobnameespecificadas para todas as publicações.

[ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname' É o nome de um trabalho de instantâneo de dados filtrado. dynamic_snapshot_jobname é sysname, com o padrão de %', que retorna todos os trabalhos dinâmicos para uma publicação com o dynamic_snapshot_jobid especificado. Se um nome de trabalho não tiver sido explicitamente especificado quando o trabalho foi criado, o nome do trabalho terá o seguinte formato:

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

[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' É um identificador para um trabalho de instantâneo de dados filtrado. dynamic_snapshot_jobid é uniqueidentifier, com padrão de NULL, que retorna todos os trabalhos de instantâneo que correspondem ao dynamic_snapshot_jobname especificado.

Conjuntos de resultados

Nome da coluna Tipo de dados Descrição
id int Identifica o trabalho de instantâneo de dados filtrado.
job_name sysname Nome do trabalho de instantâneo de dados filtrado.
job_id uniqueidentifier Identifica o trabalho do Microsoft SQL Server Agent no Distribuidor.
dynamic_filter_login sysname Valor usado para avaliar a função SUSER_SNAME em um filtro de linha parametrizado definido para a publicação.
dynamic_filter_hostname sysname Valor usado para avaliar a função HOST_NAME em um filtro de linha parametrizado definido para a publicação.
dynamic_snapshot_location nvarchar(255) Caminho para a pasta onde os arquivos de instantâneo são lidos se um filtro de linha com parâmetros for usado.
frequency_type int É a frequência de agendamento para execução do agente, que pode ser um dos valores a seguir.

1 = Uma vez

2 = Sob demanda

4 = Diária

8 = Semanal

16 = Mensal

32 = Relativo mensal

64 = Início automático

128 = Recorrente
frequency_interval int Os dias de execução do agente, que pode ter um destes 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 da semana

10 = Dias de fim de semana
frequency_subday_type int É o tipo que define a frequência com que o agente é executado quando frequency_type é 4 (diariamente) e pode ser um desses valores.

1 = No horário 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 que o agente corre em um determinado mês quando frequency_type é 32 (relativo mensal), e pode ser um desses valores.

1 = Primeiro

2 = Segundo

4 = Terceiro

8 = Quarta

16 = Última
frequency_recurrence_factor int Número de semanas ou meses entre execuções programadas do agente.
active_start_date int Data em que o agente é agendado para ser executado pela primeira vez, formatado como yyyyMMdd.
active_end_date int Data em que o agente está agendado para ser executado pela última vez, formatado como yyyyMMdd.
active_start_time int Hora em que o agente é agendado pela primeira vez para execução, formatado como HHmmss.
active_end_time int Hora em que o agente está agendado para ser executado pela última vez, formatado como HHmmss.

Valores do código de retorno

0 (sucesso) ou 1 (fracasso)

Comentários

sp_helpdynamicsnapshot_job é usado na replicação de mesclagem.

Se todos os valores de parâmetro padrão forem usados, informações sobre todos os trabalhos de instantâneo de dados particionados serão retornadas.

Permissões

Somente membros da função de servidor fixa sysadmin, da função de banco de dados fixa db_owner e da lista de acesso à publicação da publicação podem executar sp_helpdynamicsnapshot_job.

Confira também

Procedimentos armazenados do sistema (Transact-SQL)