sp_replicationdboption (Transact-SQL)

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

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 para habilitar ou desabilitar. optname é sysname e pode ser um desses valores.

Valor Descrição
mesclar publicação 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 deseja 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 (fracasso)

Comentários

sp_replicationdboption é usado na replicação de snapshot, 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 transacational ou snapshot), is_merge_published (replicação de mesclagem) ou is_distributor bits na tabela do 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)