sp_MSchange_snapshot_agent_properties (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 da 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 freqüência de execução do Snapshot Agent. frequency_type é int, e pode ser um desses valores.

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

• [ @frequency_interval = ] frequency_interval
  É o valor a ser aplicado à freqüência definido por frequency_type. frequency_interval é int, sem padrão.

• [ @frequency_subday = ] frequency_subday
  São as unidades para freq_subday_interval. frequency_subday é int, e pode ser um desses valores.

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

• [ @frequency_subday_interval=] frequency_subday_interval
  É o intervalo do . frequency_subday é frequency_subday_intervalé int, sem padrão.

• [ @frequency_relative_interval = ] frequency_relative_interval
  É a data de execução do Snapshot Agent. frequency_relative_interval é int, sem padrão.

• [ @frequency_recurrence_factor = ] frequency_recurrence_factor
  É o fator de recorrência usado pelo frequency_type. frequency_recurrence_factor is int, sem padrão.

• [ @active_start_date = ] active_start_date
  É a data do primeiro agendamento do Snapshot Agent, 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 do primeiro agendamento do Snapshot Agent, 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 em que o Snapshot Agent deixa de ser agendado, formatada como HHMMSS. active_end_time_of_day é int, sem padrão.

• [ @snapshot_job_name = ] 'snapshot_agent_name'
  É o nome de um trabalho existente de Snapshot Agent 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 se conectar 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 de 0 deve ser especificado para Publicadores não-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 for 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.

• [ @publisher_password= ] 'publisher_password'
  É a senha usada na conexão com o 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 para a 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 Snapshot Agent. Isso não pode ser alterado para um editor não-SQL Server*.*

• [ @job_password= ] 'job_password'
  É a senha para a 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 Snapshot Agent.

  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 Editor padrão Oracle.
  ORACLE GATEWAY	Especifica um Publicador 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 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 Snapshot Agent.

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 Snapshot Agent.

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

Conceitos