sp_MSchange_distribution_agent_properties (Transact-SQL)

Altera as propriedades de um trabalho do Distribution Agent, executado no Microsoft SQL Server 2005 ou em uma versão posterior do Distribuidor. Esse procedimento armazenado é usado para alterar propriedades quando o Publicador é executado em uma instância do SQL 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_distribution_agent_properties [ @publisher = ] 'publisher'
        , [ @publisher_db = ] 'publisher_db'
        , [ @publication = ] 'publication' 
        , [ @subscriber = ] 'subscriber' 
        , [ @subscriber_db = ] 'subscriber_db' 
        , [ @property = ] 'property' 
        , [ @value = ] 'value' ]

Argumentos

  • [ @publisher = ] 'publisher'
    É o nome do Publicador. publisher é sysname, sem padrão.

  • [ @publisher_db= ] 'publisher_db'
    É o nome do banco de dados de publicação. publisher_db é sysname, sem padrão.

  • [ @publication = ] 'publication'
    É o nome da publicação. publication é sysname, sem padrão.

  • [ @subscriber= ] 'subscriber'
    É o nome do Assinante. subscriber é sysname, sem padrão.

  • [ @subscriber_db= ] 'subscriber_db'
    É o nome do banco de dados de assinatura. subscriber_db é sysname, sem padrão.

  • [ @property = ] 'property'
    É a propriedade de publicação a ser alterada. property é sysname, sem padrão.

  • [ @value = ] 'value'
    É o novo valor de propriedade. value é nvarchar(524), com um padrão NULL.

    Esta tabela descreve as propriedades do trabalho do Distribution Agent que podem ser alteradas e restrições nos valores dessas propriedades.

    Propriedade

    Valor

    Descrição

    distrib_job_login

    Logon para a conta do Microsoft Windows na qual o agente é executado.

    distrib_job_password

    Senha para a conta do Windows na qual o trabalho do agente é executado.

    subscriber_catalog

    Catálogo a ser usado ao fazer uma conexão com o provedor OLE DB. Essa propriedade só é válida para Assinantes não-SQL Server.

    subscriber_datasource

    Nome da fonte de dados conforme entendido pelo provedor OLE DB. Essa propriedade só é válida para Assinantes não-SQL Server.

    subscriber_location

    Local do banco de dados conforme entendido pelo provedor OLE DB. Essa propriedade só é válida para Assinantes não-SQL Server.

    subscriber_login

    Logon a ser usado na conexão com um Assinante para sincronizar a assinatura.

    subscriber_password

    Senha do assinante.

    Não use uma senha em branco. Use uma senha forte.

    subscriber_provider

    PROGID (identificador programático) exclusivo com o qual o provedor OLE DB da fonte de dados não-SQL Server é registrado. Essa propriedade só é válida para Assinantes não-SQL Server.

    subscriber_providerstring

    Cadeia de conexão específica de provedor OLE DB que identifica a fonte de dados. Essa propriedade só é válida para Assinantes não-SQL Server.

    subscriber_security_mode

    1

    Autenticação do Windows

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

    0

    Autenticação do SQL Server.

    subscriber_type

    0

    Assinante SQL Server

    1

    Servidor de fontes de dados ODBC

    3

    Provedor OLE DB

    subscriptionstreams

    Denota o número de conexões permitido pelo Distribution Agent para dividir em lotes de alterações em paralelo a um Assinante. Sem suporte para Assinantes não-SQL Server, Publicadores Oracle ou assinaturas ponto a ponto.

    ObservaçãoObservação

    Depois de alterar o logon ou senha de um agente, você deve parar e reiniciar o agente para que a alteração entre em vigor.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_MSchange_distribution_agent_properties é usado em replicação de instantâneo e replicação da transição.

Quando o Publicador é executado em uma instância do SQL Server 2005 ou versão posterior, você deve usar sp_changesubscription para alterar propriedades de um trabalho do Merge Agent que sincroniza uma assinatura push executada no Distribuidor.

Permissões

Somente membros da função de servidor fixa sysadmin no Distribuidor pode executar sp_MSchange_distribution_agent_properties.