Data File Format

This topic provides the format of the content in a text file that contains tag data extracted by the Historian ETL Extract tool. Each line in the text file contains the following parameters, separated by commas:
Parameter Description Valid Values
Time The time at which the data is captured. It is displayed in the following format: <epoch format>:<nanoseconds, human-readable>
For example, if the value is 1601890328:76000000, then:
  • 1601890328 indicates the time in the epoch format.
  • 76000000 indicates the time in nanoseconds, human-readable.
The value after the colon is greater than 0 only if the time resolution of the tag is milliseconds or microseconds.
N/A
Tag name The name of the tag for which the data is captured. Any tag that exists in the destination Historian server
Note: If the AddTagAutomatically parameter is set to True, when you add a tag that does not exist in the Historian server, it will be created.
Data value The value of the data that is captured. N/A
Data type The data type for the value that is captured.
  • short
  • int
  • float
  • Double
  • Single Byte String
Quality The quality of the data that is captured.
  • GOOD
  • BAD
Note:
  • The BLOB data type is not supported.
  • Comments are not captured.
  • Data quality other than GOOD and BAD is not supported.