sp_repldropcolumn (Transact-SQL)

Se aplica a:SQL ServerAzure SQL Managed Instance

Quita una columna de un artículo de tabla existente publicado. Este procedimiento almacenado se ejecuta en el publicador de la base de datos de publicación.

Importante

Este procedimiento almacenado ha quedado desusado y se admite fundamentalmente por cuestiones de compatibilidad con las versiones anteriores. Solo se debe usar con publicadores de SQL Server 2000 (8.x) y suscriptores de republicación de SQL Server 2000 (8.x). Este procedimiento no se debe usar en columnas con tipos de datos que se introdujeron en SQL Server 2005 (9.x) y versiones posteriores.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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 ]
[ ; ]

Argumentos

[ @source_object = ] N'source_object'

Nombre del artículo de tabla que contiene la columna que se va a quitar. @source_object es nvarchar(270), sin ningún valor predeterminado.

[ @column = ] N'column'

Nombre de la columna de la tabla que se va a quitar. @column es sysname, sin ningún valor predeterminado.

[ @from_agent = ] from_agent

Especifica si un agente de replicación ejecuta el procedimiento almacenado. @from_agent es int, con un valor predeterminado de 0.

Use 1 cuando un agente de replicación ejecute este procedimiento almacenado; de lo contrario, use el valor predeterminado de 0.

[ @schema_change_script = ] N'schema_change_script'

Especifica el nombre y la ruta de acceso de un script de SQL Server que se usa para modificar los procedimientos almacenados personalizados generados por el sistema. @schema_change_script es nvarchar(4000), con un valor predeterminado de NULL.

La replicación permite que los procedimientos almacenados personalizados definidos por el usuario sustituyan a uno o más de los procedimientos predeterminados utilizados en la replicación transaccional. @schema_change_script se ejecuta después de realizar un cambio de esquema en un artículo de tabla replicada mediante sp_repldropcolumny se puede usar para una de las siguientes opciones:

  • Si los procedimientos almacenados personalizados se vuelven a generar automáticamente, se puede usar @schema_change_script para quitar estos procedimientos almacenados personalizados personalizados y reemplazarlos por procedimientos almacenados personalizados definidos por el usuario que admiten el nuevo esquema.

  • Si los procedimientos almacenados personalizados no se vuelven a generar automáticamente, se puede usar @schema_change_scriptpara volver a generar estos procedimientos almacenados o para crear procedimientos almacenados personalizados definidos por el usuario.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

Habilita o deshabilita la capacidad de que se invalide una instantánea. @force_invalidate_snapshot es bit, con un valor predeterminado de 1.

  • 1 especifica que los cambios realizados en el artículo pueden hacer que la instantánea no sea válida y, si es así, se concede permiso 1 para que se produzca la nueva instantánea.

  • 0 especifica que los cambios realizados en el artículo no hacen que la instantánea no sea válida.

[ @force_reinit_subscription = ] force_reinit_subscription

Habilita o deshabilita la capacidad de reinicializar la suscripción. @force_reinit_subscription es bit, con un valor predeterminado de 0.

  • 0 especifica que los cambios realizados en el artículo no hacen que se reinicialice la suscripción.

  • 1 especifica que los cambios realizados en el artículo pueden hacer que se reinicialice la suscripción y, si es así, se concede permiso para que se produzca la reinicialización de 1 la suscripción.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Permisos

Solo los miembros del rol fijo de servidor sysadmin en el publicador o los miembros del db_owner o db_ddladmin roles fijos de base de datos en la base de datos de publicación pueden ejecutar sp_repldropcolumn.