sys.sp_MSchange_distribution_agent_properties (Transact-SQL)

Aplica-se a: SQL Server

Altera as propriedades de um trabalho do Distribution Agent que corre num Distribuidor do 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_distribution_agent_properties
    [ @publisher = ] N'publisher'
    , [ @publisher_db = ] N'publisher_db'
    , [ @publication = ] N'publication'
    , [ @subscriber = ] N'subscriber'
    , [ @subscriber_db = ] N'subscriber_db'
    , [ @property = ] N'property'
    , [ @value = ] N'value'
[ ; ]

Arguments

@publisher [ = ] N'editor'

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.

[ @subscriber = ] N'assinante'

O nome do Assinante. @subscriber é sysname, sem padrão.

[ @subscriber_db = ] N'subscriber_db'

O nome da base de dados de subscrição. @subscriber_db é sysname, sem padrão.

@property [ = ] N'propriedade'

A propriedade de publicação deve mudar. @property é sysname, sem padrão.

@value [ = ] N'valor'

O novo valor da propriedade. @value é nvarchar(524), sem padrão.

Esta tabela descreve as propriedades do trabalho do Distribution Agent que podem ser alteradas, bem como as restrições aos valores dessas propriedades.

Property Valor Description
distrib_job_login Inicie sessão na conta Microsoft Windows com a qual o agente opera.
distrib_job_password Palavra-passe para a conta Windows sob a qual o trabalho do agente é executado.
subscriber_catalog 1 Catálogo a ser usado ao estabelecer uma ligação ao fornecedor OLE DB.
subscriber_datasource 1 Nome da fonte de dados conforme entendido pelo fornecedor OLE DB.
subscriber_location 1 Localização da base de dados conforme entendida pelo fornecedor OLE DB.
subscriber_login Faça login para usar ao ligar-se a um Assinante para sincronizar a subscrição.
subscriber_password Palavra-passe de assinante.

Não utilize uma palavra-passe em branco. Use uma senha forte.
subscriber_provider 1 Identificador programático único (PROGID) com o qual o fornecedor OLE DB para a fonte de dados não-SQL Server está registado.
subscriber_providerstring 1 String de cadeia de ligação específica do fornecedor OLE DB que identifica a fonte de dados.
subscriber_security_mode 1 Autenticação do Windows.

Quando possível, use a autenticação do Windows.
0 Autenticação SQL Server.
subscriber_type 0 SQL Server Subscriber
1 Servidor fonte de dados ODBC
3 fornecedor de OLE DB
subscriptionstreams 2 Denota o número de ligações permitidas por Distribution Agent para aplicar lotes de alterações em paralelo a um Assinante.

1 Válido apenas para assinantes do SQL Server que não sejam válidos.

2 Não é suportado para subscritores do SQL Server, editores Oracle ou subscrições peer-to-peer.

Note

Após alterar o login ou a palavra-passe do agente, deve parar e reiniciar o agente antes que a alteração entre em vigor.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

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

Pode usar sp_changesubscription num Publisher para alterar as propriedades de um trabalho Merge Agent que sincroniza uma subscrição push que corre no Distribuidor.

Permissions

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