Habilitar la captura de datos modificados

Habilitar la captura de datos modificados en una base de datos

Para que pueda crearse una instancia de captura para tablas individuales, es preciso que un miembro de la función fija de servidor sysadmin habilite previamente la base de datos para la captura de datos modificados. Esto se hace ejecutando el procedimiento almacenado sys.sp_cdc_enable_db (Transact-SQL) en el contexto de la base de datos. Para determinar si una base de datos ya está habilitada, consulte la columna is_cdc_enabled en la vista de catálogo sys.databases.

Al habilitar una base de datos para la captura de datos modificados, se crean para la base de datos el esquema cdc, el usuario cdc, las tablas de metadatos y otros objetos de sistema. El esquema cdc contiene las tablas de metadatos de la captura de datos modificados y, una vez que las tablas de origen han sido habilitadas para esta captura, también contiene las tablas de cambios individuales que sirven como repositorio de los datos de cambios. Este esquema cdc también contiene las funciones de sistema asociadas que se usan para consultar los datos modificados.

La captura de datos modificados requiere el uso exclusivo del esquema cdc y del usuario cdc. Si en una base de datos existe un esquema o un usuario de base de datos denominado cdc, dicha base de datos no se puede habilitar para la captura de datos modificados hasta que el esquema y/o el usuario se quiten o se cambie su nombre.

Vea la plantilla Habilitar una base de datos para la captura de datos modificados si desea obtener un ejemplo de cómo habilitar una base de datos.

Importante

Para buscar las plantillas en SQL Server Management Studio, vaya a Ver, haga clic en Explorador de plantillas y, a continuación, seleccione Plantillas de SQL Server. Captura de datos modificados es una subcarpeta. Bajo esta carpeta, encontrará todas las plantillas a las que se hace referencia en este tema. También existe un icono Explorador de plantillas en la barra de herramientas de SQL Server Management Studio.

-- ================================

-- Plantilla Enable Database for CDC

-- ================================

USE MyDB
GO

EXEC sys.sp_cdc_enable_db
GO

Habilitar la captura de datos modificados para una tabla

Una vez se haya habilitado una base de datos para la captura de datos modificados, los miembros de la función de base de datos fija db_owner pueden crear una instancia de captura para tablas de origen individuales mediante el procedimiento almacenado sys.sp_cdc_enable_table. Para determinar si una tabla de origen se ha habilitado ya para la captura de datos modificados, examine la columna is_tracked_by_cdc en la vista de catálogo sys.tables.

Se pueden especificar las opciones siguientes al crear una instancia de captura:

Columns in the source table to be captured.

De forma predeterminada, todas las columnas de la tabla de origen se identifican como columnas capturadas. Si sólo es necesario realizar el seguimiento de un subconjunto de las columnas, por ejemplo, por motivos de privacidad o de rendimiento, utilice el parámetro @captured\_column\_list para especificar el subconjunto de columnas.

A filegroup to contain the change table.

De forma predeterminada, la tabla de cambios se encuentra en el grupo de archivos predeterminado de la base de datos. Los propietarios de base de datos que deseen controlar la ubicación de las tablas de cambios individuales pueden utilizar el parámetro @filegroup\_name para especificar un grupo de archivos determinado para la tabla de cambios asociada a la instancia de captura. El grupo de archivos con nombre debe existir previamente. Generalmente, se recomienda que las tablas de cambios se coloquen en un grupo de archivos independiente de las tablas de origen. Vea la plantilla Enable a Table Specifying Filegroup Option para obtener un ejemplo de cómo utilizar el parámetro @filegroup\_name.

===================================================

-- Plantilla Enable a Table Specifying Filegroup Option

-- ===================================================

USE MyDB
GO

EXEC sys.sp_cdc_enable_table
@source_schema = N'dbo',
@source_name   = N'MyTable',
@role_name     = N'MyRole',
@filegroup_name = N'MyDB_CT',
@supports_net_changes = 1
GO

A role for controlling access to a change table.

La finalidad de la función con nombre es controlar el acceso a los datos de cambios. La función especificada puede ser una función fija de servidor existente o una función de la base de datos. Si la función especificada aún no existe, se crea automáticamente una función de la base de datos con ese nombre. Los miembros de la función sysadmin o db_owner tienen acceso total a los datos de las tablas de cambios. Los demás usuarios deben tener el permiso SELECT en todas las columnas capturadas de la tabla de origen. Además, cuando se especifica una función, los usuarios que no sean miembros de la función sysadmin o db_owner también deben ser miembros de la función especificada.

Si no desea utilizar una función de acceso, debe establecer explícitamente el valor NULL en el parámetro @role\_name. Vea la plantilla Enable a Table Without Using a Gating Role para obtener un ejemplo de cómo habilitar una tabla sin una función de acceso.

-- ===================================================

-- Plantilla Enable a Table Without Using a Gating Role

-- ===================================================

USE MyDB
GO

EXEC sys.sp_cdc_enable_table
@source_schema = N'dbo',
@source_name   = N'MyTable>',
@role_name     = NULL,
@supports_net_changes = 1
GO

A function to query for net changes.

Una instancia de captura siempre incluirá una función con valores de tabla para devolver todas las entradas de la tabla de cambios que se produjeron dentro de un intervalo definido. Esta función se denomina anexando el nombre de la instancia de captura a "cdc.fn_cdc_get_all_changes_". Para obtener más información, vea cdc.fn_cdc_get_all_changes_<capture_instance> (Transact-SQL).

Si el parámetro @supports\_net\_changes está establecido en 1, también se genera una función net changes para la instancia de captura. Esta función devuelve sólo un cambio por cada fila distinta que haya cambiado en el intervalo especificado en la llamada. Para obtener más información, vea cdc.fn_cdc_get_net_changes_<capture_instance> (Transact-SQL).

Para poder usar las consultas net changes, la tabla de origen debe tener una clave principal o un índice único que identifique las filas de forma única. Si se utiliza un índice único, el nombre del índice se debe especificar con el parámetro @index\_name. Las columnas definidas en la clave principal o índice único deben estar incluidas en la lista de columnas de origen que se van a capturar.

Vea la plantilla Enable a Table for All and Net Changes Queries para obtener un ejemplo que muestre la creación de una instancia de captura con ambas funciones de consulta.

=======================================================

-- Plantilla Enable a Table for All and Net Changes Queries

-- =======================================================

USE MyDB
GO

EXEC sys.sp_cdc_enable_table
@source_schema = N'dbo',
@source_name   = N'MyTable',
@role_name     = N'MyRole',
@supports_net_changes = 1
GO