Skip to content

change-tracking-is-column-in-mask-transact-sql.md

Latest commit

 

History

History
80 lines (64 loc) · 3.37 KB

change-tracking-is-column-in-mask-transact-sql.md

File metadata and controls

80 lines (64 loc) · 3.37 KB

title: "CHANGE_TRACKING_IS_COLUMN_IN_MASK (Transact-SQL) | Microsoft Docs" ms.custom: "" ms.date: "08/08/2016" ms.prod: "sql" ms.prod_service: "database-engine, sql-database" ms.service: "" ms.component: "system-functions" ms.reviewer: "" ms.suite: "sql" ms.technology:

  • "database-engine" ms.tgt_pltfrm: "" ms.topic: "language-reference" f1_keywords:
  • "CHANGE_TRACKING_IS_COLUMN_IN_MASK_TSQL"
  • "CHANGE_TRACKING_IS_COLUMN_IN_MASK" dev_langs:
  • "TSQL" helpviewer_keywords:
  • "change tracking [SQL Server], CHANGE_TRACKING_IS_COLUMN_IN_MASK"
  • "CHANGE_TRACKING_IS_COLUMN_IN_MASK" ms.assetid: 649b370b-da54-4915-919d-1b597a39d505 caps.latest.revision: 15 author: "rothja" ms.author: "jroth" manager: "craigg" ms.workload: "Inactive" monikerRange: "= azuresqldb-current || >= sql-server-2016 || = sqlallproducts-allversions"

CHANGE_TRACKING_IS_COLUMN_IN_MASK (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-asdb-xxxx-xxx-md]

Interprets the SYS_CHANGE_COLUMNS value that is returned by the CHANGETABLE(CHANGES …) function. This enables an application to determine whether the specified column is included in the values that are returned for SYS_CHANGE_COLUMNS.

Topic link icon Transact-SQL Syntax Conventions

Syntax

  
CHANGE_TRACKING_IS_COLUMN_IN_MASK ( column_id , change_columns )

Arguments

column_id
Is the ID of the column that is being checked. The column ID can be obtained by using the COLUMNPROPERTY function.

change_columns
Is the binary data from the SYS_CHANGE_COLUMNS column of the CHANGETABLE data.

Return Type

bit

Return Values

CHANGE_TRACKING_IS_COLUMN_IN_MASK returns the following values.

Return value Description
0 The specified column is not in the change_columns list.
1 The specified column is in the change_columns list.

Remarks

CHANGE_TRACKING_IS_COLUMN_IN_MASK does not perform any checks to validate the column_id value or that the change_columns parameter was obtained from the table from which the column_id was obtained.

Examples

The following example determines whether the Salary column of the Employees table was updated. The COLUMNPROPERTY function returns the column ID of the Salary column. The @change_columns local variable must be set to the results of a query by using CHANGETABLE as a data source.

SET @SalaryChanged = CHANGE_TRACKING_IS_COLUMN_IN_MASK  
    (COLUMNPROPERTY(OBJECT_ID('Employees'), 'Salary', 'ColumnId')  
    ,@change_columns);

See Also

Change Tracking Functions (Transact-SQL)
CHANGETABLE (Transact-SQL)
Track Data Changes (SQL Server)