sp_helpdynamicsnapshot_job (Transact-SQL)

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

Ícone de vínculo de tópicoConvenções de sintaxe 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 correspondentes ao dynamic_snapshot_jobidespecificado e dynamic_snapshot_jobnamepara 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 um padrão de %', que retorna todos os trabalhos dinâmicos de uma publicação com 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 um padrão de NULL, que retorna todos os trabalhos de instantâneo correspondentes 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 por avaliar a função SUSER_SNAME em um filtro de linha com parâmetros definido para a publicação.

dynamic_filter_hostname

sysname

Valor usado por avaliar a função HOST_NAME em um filtro de linha com parâmetros 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 freqüência de agendamento para execução do agente, que pode ser um dos valores a seguir.

1 = Uma vez

2 = Sob demanda

4 = Diariamente

8 = Semanalmente

16 = Mensalmente

32 = Relativo ao mês

64 = Iniciar automaticamente

128 = Recorrente

frequency_interval

int

Os dias de execução do agente, que pode ser 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 freqüência de execução do agente quando frequency_type é 4 (diariamente), e pode ser um destes valores.

1 = Na hora especificada

2 = Segundos

4 = Minutos

8 = Horas

frequency_subday_interval

int

Número de intervalos de frequency_subday_type que ocorre entre execuções programadas do agente.

frequency_relative_interval

int

É a semana de execução do agente em um mês determinado quando frequency_type é 32 (relativo ao mês), e pode ser um destes valores.

1 = Primeiro

2 = Segundo

4 = Terceiro

8 = Quarto

16 = Último

frequency_recurrence_factor

int

Número de semanas ou meses entre execuções programadas do agente.

active_start_date

int

Data do primeiro agendamento de execução do agente, formatada como YYYYMMDD.

active_end_date

int

Data do último agendamento de execução do agente, formatada como YYYYMMDD.

active_start_time

int

Hora do primeiro agendamento de execução do agente, formatada como HHMMSS.

active_end_time

int

Hora do último agendamento de execução do agente, formatada como HHMMSS.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_helpdynamicsnapshot_job é usado em 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.