sp_MSchange_distribution_agent_properties (Transact-SQL)

Aplica-se a: SQL Server

Altera as propriedades de um trabalho do Distribution Agent que é executado em um Distribuidor do Microsoft 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_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 editor. 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 da propriedade. value é nvarchar(524), com um padrão de NULL.

Esta tabela descreve as propriedades do trabalho do Agente de Distribuição que podem ser alteradas e restrições nos valores dessas propriedades.

Propriedade	Valor	Descrição
distrib_job_login		Faça login na 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 para 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 do SQL Server
	1	Servidor de fontes de dados ODBC
	3	Provedor OLE DB
subscriptionstreams		Denota o número de conexões permitido pelo Agente de Distribuição para aplicar lotes de alterações em paralelo a um Assinante. Não há suporte para Assinantes não-SQL Server , Publicadores Oracle ou assinaturas ponto a ponto.

Observação

Depois de alterar o logon ou a senha de um agente, você deve parar e reiniciar o agente antes que as alterações entrem em vigor.

Valores do código de retorno

0 (sucesso) ou 1 (falha)

Comentários

sp_MSchange_distribution_agent_properties é usado na replicação de instantâneo e na replicação transacional.

Quando o Publicador é executado em uma instância do SQL Server 2005 (9.x) ou versão posterior, você deve usar sp_changesubscription para alterar as 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 podem executar sp_MSchange_distribution_agent_properties.

Confira também

sp_addpushsubscription_agent (Transact-SQL)
sp_addsubscription (Transact-SQL)