sys.sp_cdc_help_change_data_capture (Transact-SQL)

Devuelve la configuración de captura de datos del cambio para cada tabla habilitada para la captura de datos del cambio en la base de datos actual. Se pueden devolver hasta dos filas para cada tabla de origen, una fila para cada instancia de captura. La captura de datos modificados no está disponible en todas las ediciones de Microsoft SQL Server. Para obtener una lista de características admitidas por las ediciones de SQL Server, vea Características compatibles con las ediciones de SQL Server 2012.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sys.sp_cdc_help_change_data_capture 
  [ [ @source_schema = ] 'source_schema' ]
  [, [ @source_name = ] 'source_name' ]

Argumentos

• [ @source\_schema = ] 'source_schema'
  Es el nombre del esquema al que pertenece la tabla de origen. source_schema es de tipo sysname y su valor predeterminado es NULL. Si se especifica source_schema, se debe especificar también source_name.

  Si es distinto de NULL, source_schema debe existir en la base de datos actual.

  Si source_schema es distinto de NULL, source_name también debe ser distinto de NULL.

• [ @source\_name = ] 'source_name'
  Es el nombre de la tabla de origen. source_name es de tipo sysname y su valor predeterminado es NULL. Si se especifica source_name, se debe especificar también source_schema.

  Si es distinto de NULL, source_name debe existir en la base de datos actual.

  Si source_name es distinto de NULL, source_schema también debe ser distinto de NULL.

Valores de código de retorno

0 (correcto) ó 1 (error)

Conjuntos de resultados

Nombre de columna	Tipo de datos	Descripción
source_schema	sysname	Nombre del esquema de la tabla de origen.
source_table	sysname	Nombre de la tabla de origen.
capture_instance	sysname	Nombre de la instancia de captura.
object_id	int	Id. de la tabla de cambios asociada a la tabla de origen.
source_object_id	int	Id. de la tabla de origen.
start_lsn	binary(10)	Número de flujo de registro (LSN) que representa el extremo bajo para consultar la tabla de cambio. NULL = no se ha establecido el extremo bajo.
end_lsn	binary(10)	LSN que representa el extremo alto para consultar la tabla de cambio. En SQL Server 2012, esta columna siempre es NULL.
supports_net_changes	bit	Se habilita la compatibilidad del cambio de red.
has_drop_pending	bit	No se usa en SQL Server 2012.
role_name	sysname	Nombre del rol de base de datos utilizado para controlar el acceso a los datos de cambio. NULL = no se utiliza un rol.
index_name	sysname	Nombre del índice utilizado para identificar de forma exclusiva las filas en la tabla de origen.
filegroup_name	sysname	Nombre del grupo de archivos en que reside la tabla de cambio. NULL = la tabla de cambio está en el grupo de archivos predeterminado de la base de datos.
create_date	datetime	Fecha en que se habilitó la instancia de captura.
index_column_list	nvarchar(max)	Lista de las columnas de índice utilizada para identificar de forma exclusiva las filas en la tabla de origen.
captured_column_list	nvarchar(max)	Lista de las columnas de origen capturadas.

Comentarios

Cuando source_schema y source_name tienen como valor predeterminado NULL, o se establecen explícitamente en NULL, este procedimiento almacenado devuelve información para todas las instancias de captura de la base de datos a las que el autor de las llamadas tiene acceso SELECT. Cuando source_schema y source_name son distintos de NULL, solo se devuelve información de la tabla habilitada con nombre concreta.

Permisos

Cuando source_schema y source_name son NULL, la autorización del autor de las llamadas determina qué tablas habilitadas se incluyen en el conjunto de resultados. Los autores de las llamadas deben tener el permiso SELECT en todas las columnas capturadas de la instancia de captura y también ser miembros de cualquier rol de acceso definido para la información de la tabla que se va a incluir. Los miembros del rol de la base de datos db_owner pueden ver información sobre todas las instancias de captura definidas. Cuando se solicita información para una tabla habilitada concreta, para la tabla con nombre se aplican los mismos criterios de pertenencia y SELECT.

Ejemplos

A.Devolver la información de configuración de captura de datos de cambio para una tabla especificada

El siguiente ejemplo devuelve la configuración de captura de datos del cambio para la tabla HumanResources.Employee.

USE AdventureWorks2012;
GO
EXECUTE sys.sp_cdc_help_change_data_capture 
    @source_schema = N'HumanResources', 
    @source_name = N'Employee';
GO

B.Devolver la información de configuración de captura de datos de cambio para todas las tablas

En el ejemplo siguiente se devuelve información de configuración para todas las tablas habilitadas en la base de datos que contiene los datos de cambios a los que el autor de las llamadas tiene autorizado el acceso.

USE AdventureWorks2012;
GO
EXECUTE sys.sp_cdc_help_change_data_capture;
GO