Compartilhar via


sp_MSchange_snapshot_agent_properties (Transact-SQL)

Altera as propriedades de um trabalho do Snapshot Agent, 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 MicrosoftSQL Server 2000. Esse procedimento armazenado é executado no Distribuidor, no banco de dados de distribuição.

Ícone de vínculo de tópicoConvenções de 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 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çaObservaçã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çaObservaçã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.