sys.sp_cdc_help_change_data_capture (Transact-SQL)

Retourne la configuration de capture de données modifiées pour chaque table activée pour la capture de données modifiées dans la base de données actuelle. Jusqu'à deux lignes peuvent être retournées pour chaque table source, une ligne pour chaque instance de capture. La capture de données modifiées n'est pas disponible dans toutes les éditions de Microsoft SQL Server. Pour obtenir une liste des fonctionnalités prises en charge par les éditions de SQL Server, consultez Fonctionnalités prises en charge par les éditions de SQL Server 2012.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

• [ @source\_schema = ] 'source_schema'
  Nom du schéma auquel appartient la table source. source_schema est de type sysname, avec NULL comme valeur par défaut. Lorsque l'argument source_schema est spécifié, la valeur de source_name doit également être spécifiée.

  S'il est non NULL, source_schema doit exister dans la base de données actuelle.

  Si source_schema est non NULL, source_name doit également être non NULL.

• [ @source\_name = ] 'source_name'
  Nom de la table source. source_name est de type sysname, avec NULL comme valeur par défaut. Lorsque l'argument source_name est spécifié, la valeur de source_schema doit également être spécifiée.

  S'il est non NULL, source_name doit exister dans la base de données actuelle.

  Si source_schema est non NULL, source_name doit également être non NULL.

Valeurs des codes de retour

0 (réussite) ou 1 (échec)

Jeux de résultats

Nom de la colonne	Type de données	Description
source_schema	sysname	Nom du schéma de table source.
source_table	sysname	Nom de la table source.
capture_instance	sysname	Nom de l'instance de capture.
object_id	int	ID de la table de modifications associée à la table source.
source_object_id	int	ID de la table source.
start_lsn	binary(10)	Numéro séquentiel dans le journal qui représente le point de terminaison inférieur pour interroger la table de modifications. NULL = le point de terminaison inférieur n'a pas été établi.
end_lsn	binary(10)	Numéro séquentiel dans le journal qui représente le point de terminaison supérieur pour interroger la table de modifications. Dans SQL Server 2012, cette colonne a toujours pour valeur NULL.
supports_net_changes	bit	La prise en charge des modifications nettes est activée.
has_drop_pending	bit	Inutilisé dans SQL Server 2012.
role_name	sysname	Nom du rôle de base de données utilisé pour contrôler l'accès aux données modifiées. NULL = aucun rôle n'est utilisé.
index_name	sysname	Nom de l'index utilisé pour identifier de façon unique des lignes dans la table source.
filegroup_name	sysname	Nom du groupe de fichiers qui contient la table de modifications. NULL = la table de modifications se trouve dans le groupe de fichiers par défaut de la base de données.
create_date	datetime	Date d'activation de l'instance de capture.
index_column_list	nvarchar(max)	Liste des colonnes d'index utilisées pour identifier de façon unique des lignes dans la table source.
captured_column_list	nvarchar(max)	Liste des colonnes sources capturées.

Notes

Lorsque source_schema et source_name ont de manière explicite ou par défaut la valeur NULL, cette procédure stockée retourne des informations pour toutes les instances de capture de base de données pour lesquelles l'appelant dispose d'un accès SELECT. Lorsque source_schema et source_name sont non NULL, seules les informations sur la table activée nommée spécifique sont retournées.

Autorisations

Lorsque source_schema et source_name sont NULL, l'autorisation de l'appelant détermine les tables activées qui sont incluses dans le jeu de résultats. Les appelants doivent avoir l'autorisation SELECT sur toutes les colonnes capturées de l'instance de capture et être membres d'un rôle de régulation défini pour les informations de table à inclure. Les membres du rôle de base de données db_owner peuvent afficher des informations concernant toutes les instances de capture définies. Lorsque des informations pour une table activée spécifique sont demandées, les mêmes critères SELECT et d'appartenance sont appliqués pour la table nommée.

Exemples

A.Retour d'informations de configuration de capture des données modifiées pour une table spécifiée

L'exemple suivant retourne la configuration de capture des données modifiées pour la table HumanResources.Employee.

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

B.Retour d'informations de configuration de capture des données modifiées pour toutes les tables

L'exemple suivant retourne des informations de configuration pour toutes les tables activées dans la base de données qui contient des données modifiées auxquelles l'appelant est autorisé à accéder.

USE AdventureWorks2012;
GO
EXECUTE sys.sp_cdc_help_change_data_capture;
GO