Compartir a través de


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 del cambio sólo está disponible en las ediciones Enterprise, Developer y Evaluation de SQL Server 2008.

Icono de vínculo a temasConvenciones 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) o 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 cambio asociado con la tabla de origen.

source_object_id

int

Id. de la tabla de origen.

start_lsn

binary(10)

Número de secuencia 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 2008, 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 2008.

role_name

sysname

Nombre de la función de la base de datos utilizado para controlar el acceso a los datos del cambio.

NULL = no se utiliza una función.

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.

Notas

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, sólo 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 la pertenencia en cualquier función de acceso definida para la información de la tabla que se va a incluir. Los miembros de la función 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 del cambio para una tabla especificada

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

USE AdventureWorks;
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 del 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 AdventureWorks;
GO
EXECUTE sys.sp_cdc_help_change_data_capture;
GO