sp_changemergesubscription (Transact-SQL)

  • Artigo

Aplica-se: SQL Server

Altera as propriedades selecionadas de uma assinatura push de mesclagem. Esse procedimento armazenado é executado no Publicador, no banco de dados publicador.

Importante

Ao configurar um Publicador com um Distribuidor remoto, os valores fornecidos para todos os parâmetros, incluindo @job_login e @job_password, são enviados ao Distribuidor como texto sem formatação. Você deve criptografar a conexão entre o Publicador e seu Distribuidor remoto antes de executar esse procedimento armazenado. Para obter mais informações, confira Configurar o Mecanismo de Banco de Dados do SQL Server para criptografia de conexões.

Sintaxe

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 ]
[ ; ]

Argumentos

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

O nome da publicação a ser alterada. @publication é sysname, com um padrão de NULL. A publicação já deve existir e ser adequada às 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 do banco de dados de assinatura. @subscriber_db é sysname e pode ser um dos valores na tabela a seguir.

@property [ = ] N'propriedade'

A propriedade a ser alterada para a publicação determinada. @property é sysname e pode ser um dos valores na tabela a seguir.

@value [ = ] N'valor'

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

Propriedade Valor Descrição
description Descrição da assinatura de mesclagem.
priority A prioridade de assinatura. A prioridade é usada pelo resolvedor padrão para escolher um vencedor quando são detectados conflitos.
merge_job_login Logon para a conta do Windows na qual o agente é executado.
merge_job_password Senha para a conta do Windows na qual o agente é executado.
publisher_security_mode 1 Use a Autenticação do Windows ao se conectar ao Publicador.
0 Use a Autenticação do SQL Server ao se conectar ao Publicador.
publisher_login Nome de logon no Publicador.
publisher_password Senha forte para o logon do Publicador fornecido.
subscriber_security_mode 1 Use a Autenticação do Windows ao se conectar ao Assinante.
0 Use a Autenticação do SQL Server ao se conectar ao Assinante.
subscriber_login Nome de logon no Assinante.
subscriber_password Senha forte para o logon de Assinante fornecido.
sync_type automatic Esquema e dados iniciais de tabelas publicadas são transferidos ao Assinante primeiro.
none O Assinante já tem o esquema e os dados iniciais para as tabelas publicadas; tabelas de sistema e dados são sempre transferidos.
use_interactive_resolver true Permite resolver conflitos interativamente para todos os artigos que permitem resolução interativa.
false Conflitos são resolvidos automaticamente usando um resolvedor padrão ou resolvedor personalizado.
NULL (padrão) NULL (padrão)

@force_reinit_subscription [ = ] force_reinit_subscription

Confirma que a ação executada por esse procedimento armazenado pode exigir que as assinaturas existentes sejam reinicializadas. @force_reinit_subscription é bit, com um padrão de 0.

  • 0 Especifica que as alterações no artigo de mesclagem não fazem com que a assinatura seja reinicializada. Se o procedimento armazenado detectar que a alteração exigiria que as assinaturas fossem reinicializadas, ocorrerá um erro e nenhuma alteração será feita.

  • 1 Especifica que as alterações no artigo de mesclagem reinicializam assinaturas existentes e dá permissão para que a reinicialização da assinatura ocorra.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_changemergesubscription é usado na replicação de mesclagem.

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.

Permissões

Somente membros da função de servidor fixa sysadmin ou db_owner função de banco de dados fixa podem executar sp_changemergesubscription.

Conteúdo relacionado