sys.sp_repldropcolumn (Transact-SQL)

Aplica-se a: SQL ServerAzure SQL Managed Instance

Elimina uma coluna de um artigo de tabela existente que foi publicado. Este procedimento armazenado é executado no Publisher no banco de dados de publicação.

Importante

Este procedimento armazenado foi descontinuado e está a ser suportado principalmente para compatibilidade retroativa. Ele só deve ser usado com Publicadores do SQL Server 2000 (8.x) e Assinantes de republicação do SQL Server 2000 (8.x). Este procedimento não deve ser usado em colunas com tipos de dados que foram introduzidos no SQL Server 2005 (9.x) e versões posteriores.

Transact-SQL convenções de sintaxe

Sintaxe

sys.sp_repldropcolumn
    [ @source_object = ] N'source_object'
    , [ @column = ] N'column'
    [ , [ @from_agent = ] from_agent ]
    [ , [ @schema_change_script = ] N'schema_change_script' ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
[ ; ]

Arguments

@source_object [ = ] N'source_object'

O nome do artigo da tabela que contém a coluna a eliminar. @source_object é nvarchar(270), sem padrão.

@column [ = ] N'coluna'

O nome da coluna na tabela a ser eliminado. @column é sysname, sem padrão.

@from_agent [ = ] from_agent

Especifica se o procedimento armazenado está sendo executado por um agente de replicação. @from_agent é int, com um padrão de 0.

Use 1 quando este procedimento armazenado está a ser executado por um agente de replicação, caso contrário use o valor padrão de 0.

@schema_change_script [ = ] N'schema_change_script'

Especifica o nome e o caminho de um script do SQL Server usado para modificar os procedimentos armazenados personalizados gerados pelo sistema. @schema_change_script é nvarchar(4000), com um padrão de NULL.

A replicação permite que procedimentos armazenados personalizados definidos pelo usuário substituam um ou mais dos procedimentos padrão usados na replicação transacional. @schema_change_script é executado após uma alteração de esquema ser feita a um artigo de tabela replicado usando sp_repldropcolumn, e pode ser usado para uma das seguintes opções:

  • Se os procedimentos armazenados personalizados forem automaticamente regenerados, @schema_change_script podem ser usados para eliminar esses procedimentos armazenados personalizados e substituí-los por procedimentos armazenados personalizados definidos pelo utilizador que suportam o novo esquema.

  • Se os procedimentos armazenados personalizados não forem automaticamente regenerados, @schema_change_scriptpodem ser usados para regenerar esses procedimentos armazenados ou para criar procedimentos armazenados personalizados definidos pelo utilizador.

@force_invalidate_snapshot [ = ] force_invalidate_snapshot

Habilita ou desabilita a capacidade de invalidar um snapshot. @force_invalidate_snapshot é bit, com um padrão de 1.

  • 1 especifica que as alterações no artigo podem fazer com que o instantâneo seja inválido e, se for esse o caso, um valor de 1 dá permissão para que o novo instantâneo ocorra.

  • 0 Especifica que as alterações no artigo não fazem com que o instantâneo seja inválido.

@force_reinit_subscription [ = ] force_reinit_subscription

Habilita ou desabilita a capacidade de ter a assinatura reinicializada. @force_reinit_subscription é bit, com um padrão de 0.

  • 0 Especifica que as alterações no artigo não fazem com que a assinatura seja reinicializada.

  • 1 Especifica que as alterações no artigo podem fazer com que a assinatura seja reinicializada e, se for esse o caso, um valor de Dá permissão para que a reinicialização da 1 assinatura ocorra.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Permissions

Apenas os membros do sysadmin função de servidor fixo na Publisher ou membros da db_owner ou db_ddladmin funções fixas de base de dados na base de dados de publicação podem executarsp_repldropcolumn.