Partilhar via


sp_replicationdboption (Transact-SQL)

Aplica-se a: SQL Server Instâ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 = ] N'dbname'
    , [ @optname = ] N'optname'
    , [ @value = ] { N'true' | N 'false' }
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @from_scripting = ] from_scripting ]
[ ; ]

Argumentos

@dbname [ = ] N'dbname'

O banco de dados para o qual a opção de banco de dados de replicação está sendo definida. @dbname é sysname, sem padrão.

@optname [ = ] N'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
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 Habilitar backups coordenados para replicação transacional.

@value [ = ] { N'verdadeiro' | N 'falso' }

Se a opção de banco de dados de replicação fornecida deve ser ativada ou desabilitada. @value é sysname, sem padrão. 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 será executado sem se conectar ao Distribuidor. @ignore_distributor é bit, com um padrão de 0.

  • Se 0, o Distribuidor deve ser conectado e atualizado com o novo status do banco de dados de publicação.

  • 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 bits correspondentes is_published (replicação transacional ou de instantâneo), is_merge_published (replicação de mesclagem) ou is_distributor bits na tabela do master.databases sistema 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. Um instantâneo de 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).

Permissões

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