sp_replicationdboption (Transact-SQL)

Artigo
03/07/2014

Define uma opção de banco de dados de replicação para o banco de dados especificado. Esse procedimento armazenado é executado no Publicador ou no Assinante, em qualquer banco de dados.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

sp_replicationdboption [ @dbname= ] 'db_name'  
        , [ @optname= ] 'optname'  
        , [ @value= ] 'value' 
    [ , [ @ignore_distributor= ] ignore_distributor ]
    [ , [ @from_scripting = ] from_scripting ]

Argumentos

[@dbname=] 'dbname'
É o banco de dados para o qual a opção de banco de dados de replicação está sendo definida. db_name é sysname, sem padrão.

[@optname=] 'optname'
É a opção de banco de dados de replicação a ser habilitada ou desabilitada. optname é sysname, e pode ter um destes valores.

Valor	Descrição
publicação de mesclagem	O banco de dados pode ser usado para publicações de mesclagem.
publish	O banco de dados pode ser usado para outros tipos de publicação.
subscribe	O banco de dados é um banco de dados de assinatura.
sync with backup	O banco de dados está habilitado para backup coordenado. Para obter mais informações, consulte Habilitar backups coordenados para a replicação transacional (Programação Transact-SQL de replicação).

[ @value=] 'value'
Especifica se a opção de banco de dados de replicação deve ser habilitada ou desabilitada. value é sysname, e pode ser true ou false. Quando esse valor é false e optname é merge publish, assinaturas no banco de dados de mesclagem publicado também são descartadas.
[ @ignore_distributor=] ignore_distributor
Indica se esse procedimento armazenado será executado sem se conectar ao Distribuidor. ignore_distributor é bit, com um padrão de 0, significando que o Distribuidor deve ser conectado e atualizado com o novo status do banco de dados de publicação. O valor 1 só deve ser especificado se o Distribuidor estiver inacessível e sp_replicationdboption estiver sendo usado para desabilitar a publicação.
[ @from_scripting=] from_scripting
Identificado apenas para fins informativos. Sem suporte. A compatibilidade futura não está garantida.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_replicationdboption é usado em replicação de instantâneo, replicação transacional e replicação de mesclagem.

Esse procedimento cria ou descarta tabelas do sistema de replicação específicas, contas de segurança, e assim por diante, que depende das opções fornecidas. Define o bit da categoria correspondente na tabela do sistema master.sysdatabases e cria as tabelas do sistema necessárias.

Para desabilitar a publicação, o banco de dados de publicação deve estar online. Se um instantâneo do banco de dados existir para o banco de dados de publicação, deverá ser descartado antes de desabilitar a publicação. O instantâneo do banco de dados é uma cópia offline somente leitura de um banco de dados e não está relacionado a um instantâneo de replicação. Para obter mais informações, consulte Instantâneos de banco de dados (SQL Server).