sys.sp_cdc_help_change_data_capture (Transact-SQL)sys.sp_cdc_help_change_data_capture (Transact-SQL)

S’APPLIQUE À : ouiSQL Server nonAzure SQL Database nonAzure Synapse Analytics (SQL DW) nonParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

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.Returns the change data capture configuration for each table enabled for change data capture in the current database. Jusqu'à deux lignes peuvent être retournées pour chaque table source, une ligne pour chaque instance de capture.Up to two rows can be returned for each source table, one row for each capture instance. La capture des modifications de données n’est pas disponible dans toutes les éditions de MicrosoftMicrosoftSQL ServerSQL Server.Change data capture is not available in every edition of MicrosoftMicrosoftSQL ServerSQL Server. Pour obtenir la liste des fonctionnalités prises en charge par les éditions de SQL ServerSQL Server, consultez Fonctionnalités prise en charge par les éditions de SQL Server 2016.For a list of features that are supported by the editions of SQL ServerSQL Server, see Features Supported by the Editions of SQL Server 2016.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

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

ArgumentsArguments

[ @source_schema =] 'source_schema'[ @source_schema = ] 'source_schema'
Est le nom du schéma auquel appartient la table source.Is the name of the schema in which the source table belongs. source_schema est sysname, avec NULL comme valeur par défaut.source_schema is sysname, with a default of NULL. Lorsque source_schema est spécifié, source_name doit également être spécifié.When source_schema is specified, source_name must also be specified.

Si non NULL, source_schema doit exister dans la base de données actuelle.If non-NULL, source_schema must exist in the current database.

Si source_schema n’est pas NULL, source_name doit également être non NULL.If source_schema is non-NULL, source_name must also be non-NULL.

[ @source_name =] 'source_name'[ @source_name = ] 'source_name'
Est le nom de la table source.Is the name of the source table. source_name est sysname, avec NULL comme valeur par défaut.source_name is sysname, with a default of NULL. Lorsque source_name est spécifié, source_schema doit également être spécifié.When source_name is specified, source_schema must also be specified.

Si non NULL, source_name doit exister dans la base de données actuelle.If non-NULL, source_name must exist in the current database.

Si source_name n’est pas NULL, source_schema doit également être non NULL.If source_name is non-NULL, source_schema must also be non-NULL.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

Jeux de résultatsResult Sets

Nom de la colonneColumn name Type de donnéesData type DescriptionDescription
source_schemasource_schema sysnamesysname Nom du schéma de table source.Name of the source table schema.
source_tablesource_table sysnamesysname Nom de la table source.Name of the source table.
capture_instancecapture_instance sysnamesysname Nom de l'instance de capture.Name of the capture instance.
object_idobject_id intint ID de la table de modifications associée à la table source.ID of the change table associated with the source table.
source_object_idsource_object_id intint ID de la table source.ID of the source table.
start_lsnstart_lsn binary(10)binary(10) Numéro séquentiel dans le journal qui représente le point de terminaison inférieur pour interroger la table de modifications.Log sequence number (LSN) representing the low endpoint for querying the change table.

NULL = le point de terminaison inférieur n'a pas été établi.NULL = the low endpoint has not been established.
end_lsnend_lsn binary(10)binary(10) Numéro séquentiel dans le journal qui représente le point de terminaison supérieur pour interroger la table de modifications.LSN representing the high endpoint for querying the change table. Dans SQL Server 2012 (11.x)SQL Server 2012 (11.x), cette colonne a toujours pour valeur NULL.In SQL Server 2012 (11.x)SQL Server 2012 (11.x), this column is always NULL.
supports_net_changessupports_net_changes bitbit La prise en charge des modifications nettes est activée.Net change support is enabled.
has_drop_pendinghas_drop_pending bitbit Inutilisé dans SQL Server 2012 (11.x)SQL Server 2012 (11.x).Not used in SQL Server 2012 (11.x)SQL Server 2012 (11.x).
role_namerole_name sysnamesysname Nom du rôle de base de données utilisé pour contrôler l'accès aux données modifiées.Name of the database role used to control access to the change data.

NULL = aucun rôle n'est utilisé.NULL = a role is not used.
index_nameindex_name sysnamesysname Nom de l'index utilisé pour identifier de façon unique des lignes dans la table source.Name of the index used to uniquely identify rows in the source table.
filegroup_namefilegroup_name sysnamesysname Nom du groupe de fichiers qui contient la table de modifications.Name of the filegroup in which the change table resides.

NULL = la table de modifications se trouve dans le groupe de fichiers par défaut de la base de données.NULL = change table is in the default filegroup of the database.
create_datecreate_date datetimedatetime Date d'activation de l'instance de capture.Date that the capture instance was enabled.
index_column_listindex_column_list nvarchar(max)nvarchar(max) Liste des colonnes d'index utilisées pour identifier de façon unique des lignes dans la table source.List of index columns used to uniquely identify rows in the source table.
captured_column_listcaptured_column_list nvarchar(max)nvarchar(max) Liste des colonnes sources capturées.List of captured source columns.

NotesRemarks

Lorsque les deux source_schema et source_name par défaut avec la valeur NULL ou sont explicitement la valeur NULL, cette procédure stockée retourne des informations pour l’ensemble de la base de données des instances de capture que l’appelant a sélectionnez l’accès à.When both source_schema and source_name default to NULL, or are explicitly set the NULL, this stored procedure returns information for all of the database capture instances that the caller has SELECT access to. Lorsque source_schema et source_name sont non NULL, seules les informations sur la table activée nommée spécifique sont retournées.When source_schema and source_name are non-NULL, only information on the specific named enabled table is returned.

AutorisationsPermissions

Lorsque source_schema et source_name ont la valeur NULL, l’autorisation de l’appelant détermine les tables activées qui sont inclus dans le jeu de résultats.When source_schema and source_name are NULL, the caller's authorization determines which enabled tables are included in the result set. 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.Callers must have SELECT permission on all of the captured columns of the capture instance and also membership in any defined gating roles for the table information to be included. Les membres du rôle de base de données db_owner peuvent afficher des informations concernant toutes les instances de capture définies.Members of the db_owner database role can view information about all defined capture instances. 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.When information for a specific enabled table is requested, the same SELECT and membership criteria are applied for the named table.

ExemplesExamples

R.A. Retour d'informations de configuration de capture des données modifiées pour une table spécifiéeReturning change data capture configuration information for a specified table

L'exemple suivant retourne la configuration de capture des données modifiées pour la table HumanResources.Employee.The following example returns the change data capture configuration for the HumanResources.Employee table.

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

B.B. Retour d'informations de configuration de capture des données modifiées pour toutes les tablesReturning change data capture configuration information for all 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.The following example returns configuration information for all enabled tables in the database that contain change data that the caller is authorized to access.

USE AdventureWorks2012;  
GO  
EXECUTE sys.sp_cdc_help_change_data_capture;  
GO