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.
Convenções da 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 filtrados. 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 de um trabalho de instantâneo de dados filtrados. 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 MicrosoftSQL 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 frequê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 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 de execução do agente quando frequency_type é 4 (diariamente), e pode ter 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 ter 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 AAAAMMDD. |
active_end_date |
int |
Data do último agendamento de execução do agente, formatada como AAAAMMDD. |
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.