Compartir a través de


sys.sp_cdc_disable_table (Transact-SQL)

Se aplica a: SQL Server

Deshabilita la captura de datos modificados para la tabla de origen especificada y la instancia de captura en la base de datos actual. La captura de datos modificados no está disponible en todas las ediciones de SQL Server. Para obtener una lista de las características admitidas por las ediciones de SQL Server, consulte Ediciones y características admitidas de SQL Server 2022.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sys.sp_cdc_disable_table
    [ @source_schema = ] 'source_schema'
      , [ @source_name = ] 'source_name'
    [ , [ @capture_instance = ] { 'capture_instance' | 'all' } ]
[ ; ]

Argumentos

[ @source_schema = ] 'source_schema'

Nombre del esquema en el que se encuentra la tabla de origen. @source_schema es sysname, sin ningún valor predeterminado y no puede ser NULL.

@source_schema deben existir en la base de datos actual.

[ @source_name = ] 'source_name'

Nombre de la tabla de origen desde la que se deshabilitará la captura de datos modificados. @source_name es sysname, sin valor predeterminado y no puede ser NULL.

@source_name debe existir en la base de datos actual.

[ @capture_instance = ] { 'capture_instance' | 'all' }

Nombre de la instancia de captura que se va a deshabilitar para la tabla de origen especificada. @capture_instance es sysname y no puede ser NULL.

Cuando all se especifica , se deshabilitan todas las instancias de captura definidas para @source_name .

Valores de código de retorno

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

Conjunto de resultados

Ninguno.

Comentarios

sys.sp_cdc_disable_table quita la tabla de cambios de captura de datos modificados y las funciones del sistema asociadas a la tabla de origen y la instancia de captura especificadas. Elimina las filas asociadas a la instancia de captura especificada de las tablas del sistema de captura de datos modificados y establece la is_tracked_by_cdc columna para la entrada de tabla en la vista de catálogo sys.tables en 0.

Permisos

Requiere pertenencia al rol fijo de base de datos db_owner.

Ejemplos

En el siguiente ejemplo se deshabilita la captura de datos modificados para la tabla HumanResources.Employee.

USE AdventureWorks2022;
GO

EXECUTE sys.sp_cdc_disable_table
    @source_schema = N'HumanResources',
    @source_name = N'Employee',
    @capture_instance = N'HumanResources_Employee';