Compartilhar via


sp_MSchange_snapshot_agent_properties (Transact-SQL)

Aplica-se: SQL Server

Altera as propriedades de um trabalho do Snapshot Agent executado em um Distribuidor do SQL Server 2005 (9.x) ou versão posterior. Esse procedimento armazenado é usado para alterar propriedades quando o Publicador é executado em uma instância do SQL Server 2000 (8.x). Esse procedimento armazenado é executado no Distribuidor, no banco de dados de distribuição.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_MSchange_snapshot_agent_properties
    [ @publisher = ] N'publisher'
    , [ @publisher_db = ] N'publisher_db'
    , [ @publication = ] N'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 = ] N'snapshot_job_name'
    , [ @publisher_security_mode = ] publisher_security_mode
    , [ @publisher_login = ] N'publisher_login'
    , [ @publisher_password = ] N'publisher_password'
    , [ @job_login = ] N'job_login'
    , [ @job_password = ] N'job_password'
    , [ @publisher_type = ] N'publisher_type'
[ ; ]

Argumentos

@publisher [ = ] N'editor'

O nome do Editor. @publisher é sysname, sem padrão.

@publisher_db [ = ] N'publisher_db'

O nome do banco de dados de publicação. @publisher_db é sysname, sem padrão.

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

O nome da publicação. @publication é sysname, sem padrão.

@frequency_type [ = ] frequency_type

Especifica a frequência com que o Snapshot Agent é executado. @frequency_type é int e pode ser um desses valores.

Valor Descrição
1 Uma vez
2 Sob demanda
4 Diário
8 Semanal
10 Mensal
20 Mensalmente, relativo ao intervalo de frequência
40 Quando o SQL Server Agent é iniciado

@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

As unidades para @frequency_subday_interval. @frequency_subday é int e pode ser um desses valores.

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

@frequency_subday_interval [ = ] frequency_subday_interval

O intervalo para @frequency_subday. @frequency_subday_interval é int, sem padrão.

@frequency_relative_interval [ = ] frequency_relative_interval

A data em que o Snapshot Agent é executado. @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 em que o Snapshot Agent é agendado pela primeira vez, formatado como yyyyMMdd. @active_start_date é int, sem padrão.

@active_end_date [ = ] active_end_date

A data em que o Snapshot Agent deixa de ser agendado, formatado como yyyyMMdd. @active_end_date é int, sem padrão.

@active_start_time_of_day [ = ] active_start_time_of_day

A hora do dia em que o Snapshot Agent é agendado pela primeira vez, formatado 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 em que o Snapshot Agent deixa de ser agendado, formatado como HHmmss. @active_end_time_of_day é int, sem padrão.

@snapshot_job_name [ = ] N'snapshot_job_name'

O nome de um nome de trabalho existente do Snapshot Agent se um trabalho existente estiver sendo usado. @snapshot_job_name é nvarchar(100), sem padrão.

@publisher_security_mode [ = ] publisher_security_mode

O modo de segurança usado pelo agente ao se conectar ao Publicador. @publisher_security_mode é int, sem padrão. Um valor de 0 deve ser especificado para Publicadores não-SQL Server.

  • 0 especifica a autenticação do SQL Server
  • 1 especifica a autenticação do Windows

Quando possível, use a autenticação do Windows.

@publisher_login [ = ] N'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 @publisher_security_mode for 1, a conta do Windows especificada em @job_login será usada ao se conectar ao Publicador.

@publisher_password [ = ] N'publisher_password'

A senha usada ao se conectar ao Publicador. @publisher_password é nvarchar(524), sem padrão.

Importante

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 [ = ] N'job_login'

O logon da conta do Windows sob a 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. Essa propriedade não pode ser alterada para um Publicador que não seja do SQL Server.

@job_password [ = ] N'job_password'

A senha da conta do Windows sob a 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.

Importante

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 [ = ] N'publisher_type'

Especifica o tipo de Publicador quando o Publicador não está em execução em uma instância do SQL Server. @publisher_type é sysname e pode ser um dos valores a seguir.

Valor Descrição
MSSQLSERVER Especifica um Publicador do 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.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

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

Você deve especificar todos os parâmetros ao executar sp_MSchange_snapshot_agent_propertieso . Execute sp_helppublication_snapshot para retornar as propriedades atuais do trabalho do Snapshot Agent.

Você pode usar sp_changepublication_snapshot no Publicador para alterar as propriedades de um trabalho do Snapshot Agent.

Permissões

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