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 sintáticas

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 predefiniçã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 predefinição.

[ @destination_db = ] N'destination_db'

O nome da base de dados de subscrição. @destination_db é sysname, sem predefiniçã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 5 Use autenticação de identidade gerida Microsoft Entra com a identidade gerida predefinida do Distribuidor ao ligar-se ao Subscritor push. Aplicável apenas na replicação transacional quando o Distribuidor é um recurso Azure SQL Managed Instance e o Assinante é o recurso Azure SQL Managed Instance ou Base de Dados SQL do Azure.
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 is bit, onde 1 is true (a subscrição suporta tabelas otimizadas para memória).

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

@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 SQL Server Publisher.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

sp_changesubscription é usado em replicação snapshot e transaccional.

sp_changesubscription Só pode ser usado para modificar as propriedades das subscrições push ou subscrições pull envolvidas 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.

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.