sys.sp_MSchange_snapshot_agent_properties (Transact-SQL)

Aplica-se a: SQL Server

Altera as propriedades de um trabalho Snapshot Agent que corre num Distribuidor SQL Server 2005 (9.x) ou versão posterior. Este procedimento armazenado é usado para alterar propriedades quando o Publisher é executado numa instância do SQL Server 2000 (8.x). Este procedimento armazenado é executado no Distribuidor na base de dados de distribuição.

Transact-SQL convenções de sintaxe

Syntax

sys.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'
    [ , [ @job_security_mode = ] job_security_mode ]
[ ; ]

Arguments

[ @publisher = ] N'editora'

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

@publisher_db [ = ] N'publisher_db'

O nome da base de dados de publicações. @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 aplicar à frequência definida por @frequency_type. @frequency_interval é inteligência, 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 utilizado 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, formatada 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, formatada 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 é inicialmente agendado, formatado como HHmmss. @active_start_time_of_day é inteligência, 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, formatada como HHmmss. @active_end_time_of_day é inteligência, sem padrão.

[ @snapshot_job_name = ] N'snapshot_job_name'

O nome de um emprego Snapshot Agent existente, caso um trabalho já existente esteja a ser utilizado. @snapshot_job_name é nvarchar(100), sem padrão.

[ @publisher_security_mode = ] publisher_security_mode

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

• 0 especifica autenticação SQL Server
• 1 especifica autenticação no Windows

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

[ @publisher_login = ] N'publisher_login'

O login usado ao ligar-se ao Publisher. @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, então a conta Windows especificada em @job_login é usada ao ligar à Publisher.

[ @publisher_password = ] N'publisher_password'

A palavra-passe usada ao ligar-se ao Publisher. @publisher_password é nvarchar(524), sem padrão.

[ @job_login = ] N'job_login'

O login da conta Windows com a qual o agente corre. @job_login é nvarchar(257), sem padrão. Esta conta do Windows é sempre usada para ligações de agentes ao Distribuidor. Deve fornecer este parâmetro ao criar um novo trabalho do Snapshot Agent.

[ @job_password = ] N'job_password'

A palavra-passe da conta Windows com a qual o agente corre. @job_password é sysname, sem padrão. Deve fornecer este parâmetro ao criar um novo trabalho do Snapshot Agent.

@publisher_type [ = ] N'publisher_type'

Especifica o tipo Publisher quando o Publisher não está a correr numa instância do SQL Server. @publisher_type é sysname e pode ser um dos seguintes valores.

Para mais informações sobre as diferenças entre um Oracle Publisher e um Oracle Gateway Publisher, consulte Oracle Publishing Overview.

[ @job_security_mode = ] job_security_mode

Identificado apenas para fins informativos. Não suportado. A compatibilidade futura não é garantida.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Observações

sp_MSchange_snapshot_agent_properties é usado na replicação de snapshot, replicação transacional e replicação de mesclagem.

Deve especificar todos os parâmetros ao executar sp_MSchange_snapshot_agent_properties. Execute sp_helppublication_snapshot para devolver as propriedades atuais do trabalho Snapshot Agent.

Podes usar sp_changepublication_snapshot no Publisher para alterar as propriedades de um trabalho Snapshot Agent.

Permissions

Apenas os membros do papel fixo de servidor sysadmin no Distribuidor podem executar sp_MSchange_snapshot_agent_properties.

Conteúdo relacionado

• sp_addpublication_snapshot (Transact-SQL)