sys.sp_changesubscription (Transact-SQL)

Aplica-se a: SQL ServerAzure SQL Managed Instance

Altera as propriedades de uma subscrição snapshot ou push transacional ou de uma subscrição pull envolvida na replicação transacional de atualização em fila. Para alterar as propriedades de todos os outros tipos de subscrições de pull, use sp_change_subscription_properties. sp_changesubscriptioné executado no Publisher na base de dados de publicações.

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.

Transact-SQL convenções de sintaxe

Syntax

sys.sp_changesubscription
    [ @publication = ] N'publication'
    , [ @article = ] N'article'
    , [ @subscriber = ] N'subscriber'
    , [ @destination_db = ] N'destination_db'
    , [ @property = ] N'property'
    , [ @value = ] N'value'
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Arguments

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

O nome da publicação deve mudar. @publication é sysname, sem padrão.

[ @article = ] N'artigo'

O nome do artigo vai mudar. @article é sysname, sem padrão.

[ @subscriber = ] N'assinante'

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

[ @destination_db = ] N'destination_db'

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

@property [ = ] N'propriedade'

A propriedade a alterar para a assinatura dada. @property é nvarchar(30), e pode ser um dos valores na tabela.

@value [ = ] N'valor'

O novo valor para o @property especificado. @value é nvarchar(4000), e pode ser um dos valores na tabela.

Property Value Description
distrib_job_login Inicie sessão na conta Windows com a qual o agente funciona.
distrib_job_password Palavra-passe para a conta Windows sob a qual o agente corre.
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 Nome de login no Assinante.
subscriber_password Senha forte para o login 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_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.
subscriptionstreams O número de ligações permitido por Distribution Agent aplicar lotes de alterações em paralelo a um Assinante. É suportado um intervalo de valores de 1 até 64 para editores SQL Server. Esta propriedade deve ser 0 para subscritores do SQL Server, editores Oracle ou subscrições peer-to-peer.
subscriber_type 1 Servidor fonte de dados ODBC
3 fornecedor de OLE DB
memory_optimized bit Indica que a subscrição suporta tabelas otimizadas para memória. memory_optimized é bit, onde 1 é true (a subscrição suporta tabelas otimizadas para memória).

1 Esta propriedade é válida apenas para Assinantes do SQL Server que não pertencem.

@publisher [ = ] N'editor'

Especifica um Editor de Server que não seja SQL. @publisher é sysname, com um padrão de NULL.

@publisher não deve ser especificado para um editor SQL Server.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

sp_changesubscription é usado em replicação instantânea e transacional.

sp_changesubscription só pode ser usado para modificar as propriedades das subscrições push ou pull de subscrições envolvidas na replicação transacional atualizada em fila. Para alterar as propriedades de todos os outros tipos de subscrições de pull, use sp_change_subscription_properties.

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_changesubscription.

Conteúdo relacionado

  • Last updated on