sys.fn_cdc_has_column_changed (Transact-SQL)

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.

Icône Lien de rubriqueConventions de 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 de type sysname.

  • 'column_name'
    Colonne capturée de l'instance de capture spécifiée sur laquelle des rapports doivent être effectués. column_name est de type sysname.

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

Type de retour

bit

Notes

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 Récupération et présentation des données modifiées.

Lorsque ces informations sont retournées dans le cadre d'une requête de modification de données, nous vous recommandons d'utiliser les fonctions sys.fn_cdc_get_column_ordinal et sys.fn_cdc_is_bit_set au lieu 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.