sp_MSchange_snapshot_agent_properties (Transact-SQL)

Artigo
05/07/2013

Altera as propriedades de um trabalho do Agente de Instantâneo, executado em uma versão do Distribuidor do MicrosoftSQL Server 2005 ou versão posterior. Esse procedimento armazenado é usado para alterar propriedades quando o Publicador é executado em uma instância do Microsoft SQL Server 2000. Esse procedimento armazenado é executado no Distribuidor, no banco de dados de distribuição.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

sp_MSchange_snapshot_agent_properties [ @publisher = ] 'publisher' 
        , [ @publisher_db = ] 'publisher_db' 
        , [ @publication = ] 'publication'  
        , [ @frequency_type= ] frequency_type 
        , [ @frequency_interval= ] frequency_interval 
        , [ @frequency_subday= ] frequency_subday 
        , [ @frequency_subday_interval= ] frequency_subday_interval 
        , [ @frequency_relative_interval= ] frequency_relative_interval 
        , [ @frequency_recurrence_factor= ] frequency_recurrence_factor 
        , [ @active_start_date= ] active_start_date 
        , [ @active_end_date= ] active_end_date 
        , [ @active_start_time_of_day= ] active_start_time_of_day 
        , [ @active_end_time_of_day= ] active_end_time_of_day 
        , [ @snapshot_job_name = ] 'snapshot_agent_name' 
        , [ @publisher_security_mode = ] publisher_security_mode 
        , [ @publisher_login = ] 'publisher_login' 
        , [ @publisher_password = ] 'publisher_password'  
        , [ @job_login = ] 'job_login' 
        , [ @job_password = ] 'job_password' 
        , [ @publisher_type = ] 'publisher_type'

Argumentos

[ @publisher = ] 'publisher'
É o nome do Publicador. publisher é sysname, sem padrão.
[ @publisher_db= ] 'publisher_db'
É o nome do banco de dados de publicação. publisher_db é sysname, sem padrão.
[ @publication = ] 'publication'
É o nome da publicação. publication é sysname, sem padrão.
[ @frequency_type = ] frequency_type
É a frequência de execução do Agente de Instantâneo. frequency_type é int, e pode ter um destes valores.

Valor

Descrição

1

Uma vez

2

Sob demanda

4

Diariamente

8

Semanalmente

10

Mensalmente

20

Mensalmente, relativo ao intervalo de frequência

40

Quando o SQL Server Agent inicia
[ @frequency_interval = ] frequency_interval
É o valor a ser aplicado à frequência definida por frequency_type. frequency_interval é int, sem padrão.
[ @frequency_subday = ] frequency_subday
São as unidades de freq_subday_interval. frequency_subday é int, e pode ter um destes valores.

Valor

Descrição

1

Uma vez

2

Segundo

4

Minuto

8

Hora
[ @frequency_subday_interval = ] frequency_subday_interval
É o intervalo de frequency_subday. frequency_subday_interval é int, sem padrão.
[ @frequency_relative_interval = ] frequency_relative_interval
É a data de execução do Agente de Instantâneo. frequency_relative_interval é int, sem padrão.
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
É o fator de recorrência usado por frequency_type. frequency_recurrence_factor é int, sem padrão.
[ @active_start_date = ] active_start_date
É a data do primeiro agendamento do Agente de Instantâneo, formatada como AAAAMMDD. active_start_date é int, sem padrão.
[ @active_end_date = ] active_end_date
É a data em que o Agente de Instantâneo para de ser agendado, formatada como AAAAMMDD. active_end_date é int, sem padrão.
[ @active_start_time_of_day = ] active_start_time_of_day
É a hora do dia do primeiro agendamento do Agente de Instantâneo, formatada como HHMMSS. active_start_time_of_day é int, sem padrão.
[ @active_end_time_of_day = ] active_end_time_of_day
É a hora do dia do último agendamento do Agente de Instantâneo, formatada como HHMMSS. active_end_time_of_day é int, sem padrão.
[ @snapshot_job_name = ] 'snapshot_agent_name'
É o nome de um trabalho existente do Agente de Instantâneo se um trabalho existente estiver sendo usado. snapshot_agent_name é nvarchar(100), sem padrão.
[ @publisher_security_mode = ] publisher_security_mode
É o modo de segurança usado pelo agente ao conectar-se ao Publicador. publisher_security_mode é int, sem padrão. 0 especifica Autenticação do SQL Server e 1 especifica Autenticação do Windows. Um valor 0 deve ser especificado para Publicadores que não sejam do SQL Server. Quando possível, use a Autenticação do Windows.
[ @publisher_login= ] 'publisher_login'
É o logon usado na conexão com o Publicador. publisher_login é sysname, sem padrão. publisher_login deve ser especificado quando publisher_security_mode é 0. Se publisher_login for NULL e o publicador *_*security_mode for 1, então a conta do Windows especificada em job_login será usada na conexão com o Publicador.

Valor	Descrição
1	Uma vez
2	Sob demanda
4	Diariamente
8	Semanalmente
10	Mensalmente
20	Mensalmente, relativo ao intervalo de frequência
40	Quando o SQL Server Agent inicia

Valor	Descrição
1	Uma vez
2	Segundo
4	Minuto
8	Hora

[ @publisher_password= ] 'publisher_password'
É a senha usada ao conectar-se ao Publicador. publisher_password é nvarchar(524), sem padrão.

Observação sobre segurança
Não armazene informações de autenticação em arquivos de script. Para ajudar a melhorar a segurança, recomendamos que você forneça nomes de login e senhas em tempo de execução.

[ @job_login= ] 'job_login'
É o logon da conta do Windows na qual o agente é executado. job_login é nvarchar(257), sem padrão. Essa conta do Windows sempre é usada para conexões de agente com o Distribuidor. Você deve fornecer esse parâmetro ao criar um novo trabalho do Agente de Instantâneo. Isso não pode ser alterado para um editor não SQL Server*.*

[ @job_password= ] 'job_password'
É a senha da conta do Windows na qual o agente é executado. job_password é sysname, sem padrão. Você deve fornecer esse parâmetro ao criar um novo trabalho do Agente de Instantâneo.

Observação sobre segurança
Não armazene informações de autenticação em arquivos de script. Para ajudar a melhorar a segurança, recomendamos que você forneça nomes de login e senhas em tempo de execução.

[ @publisher_type= ] 'publisher_type'
Especifica o tipo de Publicador quando o Publicador não está sendo executado em uma instância do SQL Server. publisher_type é sysname e pode ser um dos valores a seguir.

Valor

Descrição

MSSQLSERVER

Especifica um Editor SQL Server.

ORACLE

Especifica um Publicador Oracle padrão.

ORACLE GATEWAY

Especifica um Editor Oracle Gateway.

Para obter mais informações sobre as diferenças entre um Publicador Oracle e um Publicador Oracle Gateway, consulte Visão geral da Publicação Oracle.

Valor	Descrição
MSSQLSERVER	Especifica um Editor SQL Server.
ORACLE	Especifica um Publicador Oracle padrão.
ORACLE GATEWAY	Especifica um Editor Oracle Gateway.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_MSchange_snapshot_agent_properties é usado em replicação de instantâneo, transacional e de mesclagem.

Você deve especificar todos os parâmetros ao executar sp_MSchange_sbapshot_agent_properties. Execute sp_helppublication_snapshot para retornar às propriedades atuais do trabalho do Agente de Instantâneo.

Quando o Publicador é executado uma instância do SQL Server 2005 ou versão posterior, você deve usar sp_changepublication_snapshot para alterar as propriedades de um trabalho de Agente de Instantâneo.

Permissões

Somente membros da função de servidor fixa sysadmin no Distribuidor pode executar sp_MSchange_snapshot_agent_properties.

Consulte também

Referência

sp_addpublication_snapshot (Transact-SQL)

Partilhar via