sp_replicationdboption (Transact-SQL)

Aplica-se a: Instância Gerenciada de SQL do Azure SQL Server (todas as versões com suporte)

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.

Topic link iconConvenções de sintaxe do 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
publicação de mesclagem 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.
Assinar 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 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. o valor é sysname e pode ser verdadeiro ou falso. Quando esse valor é falso e o nome ideal é a publicação de mesclagem, as assinaturas para o 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 (êxito) 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 o is_published correspondente (replicação transacional ou de instantâneo), 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.

Consulte 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)