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.
.gif "Icono de vínculo a temas")
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