Compartilhar via


sp_helpdynamicsnapshot_job (Transact-SQL)

Aplica-se a: SQL Server Instâ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 = ] N'publication' ]
    [ , [ @dynamic_snapshot_jobname = ] N'dynamic_snapshot_jobname' ]
    [ , [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' ]
[ ; ]

Argumentos

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

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 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 instantâneo de dados filtrado. @dynamic_snapshot_jobname é sysname, com um padrão de %, que retorna todos os trabalhos dinâmicos para uma publicação com o @dynamic_snapshot_jobname especificado. Se um nome de trabalho não tiver sido especificado explicitamente quando o trabalho foi criado, o nome do trabalho estará no 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 , que retorna todos os trabalhos de NULLinstantâneo que correspondem ao @dynamic_snapshot_jobname especificado.

Conjunto 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 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ário
8 = Semanais
16 = Mensal
32 = Relativo mensal
64 = Inicialização automática
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 (diário) 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 em que o agente é executado em um determinado mês em que frequency_type é 32 (relativo mensal) e pode ser um desses 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 em que o agente está programado para ser executado pela primeira vez, formatado como yyyyMMdd.
active_end_date int Data em que o agente está programado para ser executado pela última vez, formatado como yyyyMMdd.
active_start_time int Hora em que o agente está programado para ser executado pela primeira vez, formatado como HHmmss.
active_end_time int Hora em que o agente está programado pela última vez para ser executado, formatado como HHmmss.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

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 os 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.