Partager via


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 rubrique 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 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 À propos de la capture de 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.

Voir aussi

Référence

cdc.<capture_instance>_CT (Transact-SQL)

cdc.captured_columns (Transact-SQL)