sys.fn_cdc_has_column_changed (Transact-SQL)

S’applique à :SQL Server

Identifie si le masque de mise à jour spécifié indique que la colonne spécifiée a été mise à jour dans la ligne de modification associée.

Conventions de la syntaxe Transact-SQL

Syntaxe

  
sys.fn_cdc_has_column_changed ( 'capture_instance','column_name' , update_mask )  

Arguments

'capture_instance'
Nom de l’instance de capture. capture_instance est sysname.

'column_name'
Colonne capturée de l’instance de capture spécifiée sur laquelle créer un rapport. column_name est sysname.

update_mask
Masque qui identifie les colonnes mises à jour dans toute ligne de modification associée. update_mask est varbinary(128).

Type de retour

bit

Remarques

Vous pouvez utiliser cette fonction pour extraire les informations d'un masque de mise à jour retournées dans une requête pour les données de modifications. Elle est particulièrement utile lors du post-traitement du masque de mise à jour lorsque vous devez savoir si une colonne particulière dans la ligne de modification associée a été modifiée. Pour plus d’informations, consultez À propos de la capture de données modifiées (SQL Server).

Lorsque ces informations sont retournées dans le cadre d’une requête de données modifiées, nous vous recommandons d’utiliser les fonctions sys.fn_cdc_get_column_ordinal et sys.fn_cdc_is_bit_set à la place de cette fonction. Utilisez la fonction fn_cdc_get_column_ordinal avant d'interroger la modification de données de sorte que l'ordinal de colonne souhaité ne soit calculé qu'une seule fois. Utilisez fn_cdc_is_bit_set dans la requête afin d'extraire les informations du masque de mise à jour pour chaque ligne retournée.

Autorisations

Requiert l'appartenance au rôle serveur fixe sysadmin ou au rôle de base de données fixe db_owner. Pour tous les autres utilisateurs, requiert l'autorisation SELECT sur toutes les colonnes capturées dans la table source et, si un rôle de régulation pour l'instance de capture a été défini, l'appartenance à ce rôle de base de données.

Voir aussi

Cdc.<>capture_instance_CT (Transact-SQL)
cdc.captured_columns (Transact-SQL)