sp_change_subscription_properties (Transact-SQL)

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure

Atualiza informações de assinaturas pull. Esse procedimento armazenado é executado no Assinante no banco de dados de assinatura.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_change_subscription_properties
    [ @publisher = ] N'publisher'
    , [ @publisher_db = ] N'publisher_db'
    , [ @publication = ] N'publication'
    , [ @property = ] N'property'
    , [ @value = ] N'value'
    [ , [ @publication_type = ] publication_type ]
[ ; ]

Argumentos

@publisher [ = ] N'editor'

O nome do Editor. @publisher é sysname, sem padrão.

@publisher_db [ = ] N'publisher_db'

O nome do banco de dados Publicador. @publisher_db é sysname, sem padrão.

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

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

@property [ = ] N'propriedade'

A propriedade a ser alterada. @property é sysname, sem padrão.

@value [ = ] N'valor'

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

@publication_type [ = ] publication_type

Especifica o tipo de replicação da publicação. @publication_type é int, com um padrão de NULL, e pode ser um destes valores:

Valor Publication type
0 Transacional
1 Instantâneo
2 Mesclar
NULL (padrão) A replicação determina o tipo da publicação. Como esse procedimento armazenado deve procurar em várias tabelas, essa opção é mais lenta do que quando o tipo de publicação exato é fornecido.

Essa tabela descreve as propriedades de artigos e os valores dessas propriedades.

Propriedade Valor Descrição
alt_snapshot_folder Especifica o local da pasta alternativa para o instantâneo. Se definido como NULL, os arquivos de instantâneo serão selecionados do local padrão especificado pelo Publicador.
distrib_job_login Logon para a conta do Windows na qual o agente é executado.
distrib_job_password Senha para a conta do Windows na qual o agente é executado.
distributor_login O logon do Distribuidor
distributor_password Senha do distribuidor.
distributor_security_mode 1 Use a Autenticação do Windows ao se conectar ao Distribuidor.
0 Use a Autenticação do SQL Server ao se conectar ao Distribuidor.
dts_package_name Especifica o nome do pacote DTS (Data Transformation Services) do SQL Server 2000. Esse valor só poderá ser especificado se a publicação for transacional ou de instantâneo.
dts_package_password Especifica a senha no pacote. dts_package_password é sysname com um padrão de , que especifica que a propriedade password deve ser deixada NULLinalterada. Esse valor só poderá ser especificado se a publicação for transacional ou de instantâneo.

Observação: Um pacote DTS deve ter uma senha.
dts_package_location Local onde o pacote DTS é armazenado. Esse valor só poderá ser especificado se a publicação for transacional ou de instantâneo.
dynamic_snapshot_location Especifica o caminho para a pasta onde os arquivos de instantâneo são salvos. Esse valor só poderá ser especificado se a publicação for uma publicação de mesclagem.
ftp_address Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts.
ftp_login Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts.
ftp_password Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts.
ftp_port Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts.
hostname Nome do host usado ao conectar ao Publicador.
internet_login Logon que o Agente de Mesclagem usa ao se conectar ao servidor da Web que está hospedando a sincronização da Web usando Autenticação Básica.
internet_password Senha que o Agente de Mesclagem usa ao se conectar ao servidor da Web que está hospedando a sincronização da Web usando Autenticação Básica.
internet_security_mode 1 Use Autenticação Integrada do Windows para sincronização da Web. Recomendamos o uso da Autenticação Básica com sincronização da Web. Para obter mais informações, consulte Configurar sincronização da Web.
0 Use Autenticação Básica para sincronização da Web.

Observação: a sincronização da Web requer uma conexão TLS com o servidor Web.
internet_timeout Período de tempo, em segundos, antes que uma solicitação de sincronização da Web expire.
internet_url URL que representa o local do Replication Listener para sincronização da Web.
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_login Logon de Publicador. A alteração publisher_login só tem suporte para assinaturas para mesclar publicações.
publisher_password Senha do Publicador. A alteração publisher_password só tem suporte para assinaturas para mesclar publicações.
publisher_security_mode 1 Use a Autenticação do Windows ao se conectar ao Publicador. A alteração publisher_security_mode só tem suporte para assinaturas para mesclar publicações.
0 Use a Autenticação do SQL Server ao se conectar ao Publicador.
use_ftp true Para recuperar instantâneos, use FTP em vez do protocolo regular.
false Use o protocolo comum para recuperar instantâneos.
use_web_sync true Habilite a sincronização da Web.
false Desabilite a sincronização da Web.
working_directory Nome do diretório de trabalho usado para armazenar dados e arquivos de esquema temporariamente para a publicação quando o FTP (File Transfer Protocol) for usado para transferir arquivos de instantâneo.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_change_subscription_properties é usado em todos os tipos de replicação.

sp_change_subscription_properties é usado para assinaturas pull.

Para Publicadores Oracle, o valor de @publisher_db é ignorado, pois a Oracle permite apenas um banco de dados por instância do servidor.

Permissões

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