sp_replicationdboption (Transact-SQL)
Aplica-se a: Instância Gerenciada de SQL do Azure do SQL Server
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.
Convenções de sintaxe de 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 ser um desses valores.
Valor | Descrição |
---|---|
mesclar publicar | O banco de dados pode ser usado para publicações de mesclagem. |
publicar | O banco de dados pode ser usado para outros tipos de publicação. |
inscreva-se | O banco de dados é um banco de dados de assinatura. |
Sincronizar com backup | O banco de dados está habilitado para backup coordenado. Para obter mais informações, consulte Habilitar backups coordenados para replicação transacional (Programação Transact-SQL de replicação). |
[ @value = ] 'value'
É se deve habilitar ou desabilitar a opção de banco de dados de replicação fornecida. value é sysname e pode ser true ou false. Quando esse valor é false e optname é merge publish, as assinaturas do banco de dados publicado de mesclagem também são descartadas.
[ @ignore_distributor = ] ignore_distributor
Indica se esse procedimento armazenado é executado sem se conectar ao Distribuidor. ignore_distributor é bit, com um padrão de 0, o que significa que o Distribuidor deve ser conectado e atualizado com o novo status do banco de dados de publicação. O valor 1 deve ser especificado somente 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. Não há suporte. A compatibilidade futura não está garantida.
Valores do código de retorno
0 (sucesso) ou 1 (falha)
Comentários
sp_replicationdboption é usado na 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 os is_published correspondentes (replicação transacional ou de instantâneo), is_merge_published (replicação de mesclagem) ou is_distributor bits na tabela de sistema master.databases e cria as tabelas de 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, confira Instantâneos de banco de dados (SQL Server).
Permissões
Somente membros da função de servidor fixa sysadmin podem executar sp_replicationdboption.
Confira também
Configurar a publicação e a distribuição
Criar uma publicação
Excluir uma publicação
Desabilitar a publicação e a distribuição
sys.databases (Transact-SQL)
Procedimentos armazenados de replicação (Transact-SQL)