sys.sp_changemergesubscription (Transact-SQL)

Aplica-se a: SQL Server

Altera propriedades selecionadas de uma subscrição de merge push. Este procedimento armazenado é executado no Publisher no banco de dados de publicação.

Important

Ao configurar um Publisher com um Distribuidor remoto, os valores fornecidos para todos os parâmetros, incluindo @job_login e @job_password, são enviados ao Distribuidor em texto simples. Deve encriptar a ligação entre o Publisher e o seu Distribuidor remoto antes de executar este procedimento armazenado. Para obter mais informações, consulte Configurar o Mecanismo de Banco de Dados do SQL Server para criptografar conexões.

Syntax

sys.sp_changemergesubscription
    [ [ @publication = ] N'publication' ]
    [ , [ @subscriber = ] N'subscriber' ]
    [ , [ @subscriber_db = ] N'subscriber_db' ]
    [ , [ @property = ] N'property' ]
    [ , [ @value = ] N'value' ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
[ ; ]

Arguments

[ @publication = ] N'publicação'

O nome da publicação deve mudar. @publication é sysname, com um padrão de NULL. A publicação deve já existir e cumprir as regras para identificadores.

[ @subscriber = ] N'assinante'

O nome do Assinante. @subscriber é sysname, com um padrão de NULL.

[ @subscriber_db = ] N'subscriber_db'

O nome da base de dados de subscrição. @subscriber_db é sysname, e pode ser um dos valores na tabela seguinte.

@property [ = ] N'propriedade'

A propriedade a alterar para a publicação em questão. @property é sysname, e pode ser um dos valores na tabela seguinte.

@value [ = ] N'valor'

O novo valor para o @property especificado. @value é nvarchar(255), com um padrão de NULL.

Property Value Description
description Descrição desta subscrição de fusão.
priority A prioridade da subscrição. A prioridade é usada pelo resolver padrão para escolher um vencedor quando são detetados conflitos.
merge_job_login Inicie sessão na conta Windows com a qual o agente funciona.
merge_job_password Palavra-passe para a conta Windows sob a qual o agente corre.
publisher_security_mode 1 Use a Autenticação do Windows ao se conectar ao Editor.
0 Use a Autenticação do SQL Server ao se conectar ao Editor.
publisher_login Nome de login no Publisher.
publisher_password Palavra-passe forte para o login do Publisher fornecido.
subscriber_security_mode 1 Use a Autenticação Windows ao ligar-se ao assinante.
0 Use Autenticação SQL Server ao ligar-se ao assinante.
subscriber_login Nome de login no Assinante.
subscriber_password Palavra-passe forte para o login do assinante fornecido.
sync_type automatic O esquema e os dados iniciais das tabelas publicadas são transferidos primeiro para o Assinante.
none O subscritor já tem o esquema e os dados iniciais para tabelas publicadas; As tabelas e dados do sistema são sempre transferidos.
use_interactive_resolver true Permite resolver conflitos de forma interativa para todos os artigos que permitem a resolução interativa.
false Os conflitos são resolvidos automaticamente usando um resolvedor padrão ou um resolvedor personalizado.
NULL (padrão) NULL (padrão)

@force_reinit_subscription [ = ] force_reinit_subscription

Reconhece que a ação tomada por este procedimento armazenado pode exigir a reinicialização das subscrições existentes. @force_reinit_subscription é bit, com um padrão de 0.

  • 0 especifica que alterações ao artigo de fusão não causam a reinicialização da subscrição. Se o procedimento armazenado detetar que a alteração exigiria a reinicialização das subscrições, ocorre um erro e não são feitas alterações.

  • 1 especifica que alterações ao artigo de fusão reiniciam as subscrições existentes e dá permissão para que ocorra a reinicialização da subscrição.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

sp_changemergesubscription é usado na replicação por fusão.

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.

Permissions

Apenas os membros do papel fixo de servidor administrador do sistema ou db_owner papel fixo de base de dados podem executar sp_changemergesubscription.