Skip to main content Skip to complementary content

Headers

By default, headers for source tables are not replicated to the target. You can determine which, if any, headers to replicate when you define a transformation by creating an expression that includes the header.

You can create a filter using header values. Header filters are applied during change processing. See Using filters for additional information.

Information note
  • The Headers tab in the Expression builder is available for filters and transformations. It is available for Global transformations only when you select Add Columns. See Transformation type.
  • Header columns are supported by all endpoints, except where explicitly stated to the contrary.

The available headers are described below.

AR_H_CHANGE_SEQ

Value in Change Processing

A monotonically increasing change sequencer that is common to all Change tables of a task. The Change sequence has the following format (with time being the UTC time on Replicate Server):

YYYYMMDDHHmmSShhxxxxxxxxxxxxxxxxxxx

Where:

  • YYYY is the four-digit year (such as 2012)
  • MM is the two-digit month (range from 01-12)
  • HH is the hour in the day (range from 00-23)
  • mm is the minute in the hour (range from 00-59)
  • SS is the second in the minute (range from 00-59)
  • hh is the hundredth of the second (range from 00-99)
  • xxxxxxxxxxxxxxxxxxx is a 19-digit, zero prefixed change number (global per task).

The time part usually refers to the commit time of the transaction that includes the change record. Qlik Replicate contains logic that maintains the monotonicity of the sequence number so modifying or adjusting the endpoint time may result in multiple changes to seem that they are within the same timestamp but with increasing change number.

The xxx...xxx is usually the internal change number from the data record except that for BEFORE-IMAGE records it is the same as the change number of the matching UPDATE record (for example, if the change number of BEFORE-IMAGE is 1000 and that of the UPDATE is 1001, then both have 1001). This allows a simple left-outer-join between the table and itself where on the left we scan until the point in time but filter out operation=before-image, and on the right we join on the same change_seq with the change_oper being 'B' .

Value in Full Load

Empty

Data type

VARCHAR(35)

AR_H_STREAM_POSITION

Value in Change Processing

The stream position value on the source - usually the SCN or LSN - which allows Replicate tasks to resume from the last processed event.

Value in Full Load

Empty string

Data type

STRING

AR_H_TIMESTAMP

Value in Change Processing

The timestamp of the Change operation, which is represented as the local time on Replicate Server. If your database and Replicate Server are located in the same timezone, the timestamp will be approximately representative of the actual Change operation.

Value in Full Load

Current timestamp

Data type

DATETIME

AR_H_TRANSACTION_ID

Value in Change Processing

The ID of the transaction to which the Change record belongs. The actual value is a hex-string of the 128-bit transaction ID. Depending on the source endpoint type, the ID may either be similar to the transaction ID in the source database or identical to it.

Information note

The transaction ID is not guaranteed to be unique and therefore should not be used to create reports or any other operation that relies upon its uniqueness.

Value in Full Load

Empty

Data type

VARCHAR (32)

AR_H_COMMIT_TIMESTAMP

Value in Change Processing

The source database commit timestamp, according to Replicate Server time. When the source database and Replicate Server are in the same timezone, the timestamp will be the approximate time of the actual commit on the source database.

Value in Full Load

Current timestamp

Data type

DATETIME

AR_H_DB_COMMIT_TIMESTAMP

Value in Change Processing

The source database commit timestamp, according to the database server time.

Information note

Relevant for the following source endpoints only: Oracle, Microsoft SQL Server, IBM DB2 for z/OS, Microsoft Azure SQL Managed Instance, and Amazon RDS for SQL Server.

Value in Full Load

NULL

Data type

DATETIME

AR_H_OPERATION

Value in Change Processing

Can be one of the following: INSERT, UPDATE, or DELETE.

Value in Full Load

INSERT

Data type

STRING

AR_H_USER

Value in Change Processing

The user that made the change to the source database.

Information note

Relevant for the following source endpoints only:

  • Microsoft SQL Server
  • Microsoft Azure SQL Managed Instance
  • Amazon RDS for SQL Server
  • IBM Informix
  • IBM DB2 for z/OS
  • IBM DB2 for LUW
  • Oracle
  • File
  • AIS-based sources
  • SAP Sybase ASE

Value in Full Load

Empty

Data type

STRING

AR_H_JOB_NAME

Value in Change Processing

The iSeries job that made the change to the source database.

Information note

Relevant for the IBM DB2 for iSeries source endpoint only.

Value in Full Load

Empty

Data type

STRING

AR_H_PROGRAM_NAME

Value in Change Processing

The iSeries program that made the change to the source database.

Information note

Relevant for the IBM DB2 for iSeries source endpoint only.

Value in Full Load

Empty

Data type

STRING

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!