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.

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

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

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

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

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.

Conteúdo relacionado

• sp_addpublication_snapshot (Transact-SQL)