sp_replicationdboption (Transact-SQL)

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ópicoConvenções de 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 para ativar ou desabilitar. optname é sysname e pode ser um destes valores.

    Valor

    Descrição

    merge publish

    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 Como habilitar backups coordenados para a replicação de transação (Programação Transact-SQL de replicação).

  • [ @value=] 'value'
    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 é executado sem conexão com o 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 do Banco de Dados.

Permissões

Somente membros da função de servidor fixa sysadmin podem executar sp_replicationdboption.