Partager via


sys.sp_cdc_disable_table (Transact-SQL)

S'applique à : SQL Server

Désactive la capture de données modifiées pour la table source spécifiée et l'instance de capture dans la base de données actuelle. La capture de données modifiées n’est pas disponible dans chaque édition de SQL Server. Pour obtenir la liste des fonctionnalités prises en charge par les éditions de SQL Server, consultez Éditions et fonctionnalités prises en charge de SQL Server 2022.

Conventions de la syntaxe Transact-SQL

Syntaxe

sys.sp_cdc_disable_table
    [ @source_schema = ] 'source_schema'
      , [ @source_name = ] 'source_name'
    [ , [ @capture_instance = ] { 'capture_instance' | 'all' } ]
[ ; ]

Arguments

[ @source_schema = ] 'source_schema'

Nom du schéma dans lequel la table source est contenue. @source_schema est sysname, sans valeur par défaut et ne peut pas être NULL.

@source_schema doit exister dans la base de données active.

[ @source_name = ] 'source_name'

Nom de la table source à partir de laquelle la capture de données modifiées doit être désactivée. @source_name est sysname, sans valeur par défaut et ne peut pas être NULL.

@source_name doit exister dans la base de données active.

[ @capture_instance = ] { 'capture_instance' | 'all' }

Nom de l’instance de capture à désactiver pour la table source spécifiée. @capture_instance est sysname et ne peut pas être NULL.

Quand all elle est spécifiée, toutes les instances de capture définies pour @source_name sont désactivées.

Valeurs des codes de retour

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

Jeu de résultats

Aucune.

Notes

sys.sp_cdc_disable_table supprime la table de modifications de capture de données modifiées et les fonctions système associées à la table source et à l’instance de capture spécifiées. Elle supprime toutes les lignes associées à l’instance de capture spécifiée des tables système de capture de données modifiées et définit la is_tracked_by_cdc colonne de l’entrée de table dans l’affichage 0catalogue sys.tables sur .

autorisations

Nécessite l'appartenance au rôle de base de données fixe db_owner.

Exemples

L'exemple suivant désactive la capture des données modifiées pour la table HumanResources.Employee.

USE AdventureWorks2022;
GO

EXECUTE sys.sp_cdc_disable_table
    @source_schema = N'HumanResources',
    @source_name = N'Employee',
    @capture_instance = N'HumanResources_Employee';