Learn about rec how to record PI Point database changes for PI Interface for RDBMS
- Last UpdatedAug 19, 2025
- 2 minute read
- PI System
- Interfaces
The interface can record changes made to the PI Point Database. The managing tag is triggered by modification of a point attribute. The managing point is configured by setting Location4 to either -1or -2.
Note: AVEVA recommends using the PI System auditing features to audit changes to points, rather than this interface.
Short form configuration - recording current and previous PI point attribute values
When a point with Location4 set to -1 is recognized , the interface expects a subset of the AT.* placeholders in its ExDesc. The INSERT query is executed whenever there was a point attribute change. The keyword
(in the ExDesc of the managing point) specifies for which subset of points the changes will be recorded.
The pattern syntax follows the one PI SDK's GetPoints () method recohnizes. For example:
/GETPOINTS="pointsource='RDBMS*' AND location1='1'"
or
/GETPOINTS="pointsource='P' OR tag='P2P*'"
By default, the interface checks for attribute changes every two minutes. If an attribute is changed twice within two minutes ending with its original value, the interface will NOT record any change. Since RDBMSPI 3.11, the two-minute interval can be modified by specifying the startup parameter /UPDATEINTERVAL.
Short form example:
INSERT INTO pi_attributes_modified (tagname,
attribute,
changedate,
changer,
newValue,
oldValue)
VALUES (?,?,?,?,?,?);
Configure the target PI point with the following settings:
|
Point attribute |
Description |
Setting |
|---|---|---|
|
ExDesc |
Placeholders and options |
P1=AT.TAG P2=AT.ATTRIBUTE P3=AT.CHANGEDATE P4=AT.CHANGER P5=AT.NEWVALUE P6=AT.OLDVALUE /GETPOINTS="tag='ABC*'" |
|
Location4 |
Recording PIPoint changes |
-1 (Short form) |
|
InstrumentTag |
Name of the SQL file |
AttributeChanges.SQL |
|
PointType |
Data type of PI point |
Float32 |
In the RDBMS, create a table formatted as follows.
|
Column name |
Column data type |
|---|---|
|
SQL Server data type |
|
|
tagname |
Varchar(1024) |
|
attribute |
Varchar(1024) |
|
changedate |
DateTime |
|
changer |
Varchar(1024) |
|
newValue |
Varchar(1024) |
|
oldValue |
Varchar(1024) |
Long form configuration
Location4= -2 indicates that all AT.* placeholders can be employed. In this mode, the interface does not remember what the previous attribute value was and forwards only the current PI point attributes state to the corresponding RDB table. The overall principles are the same as with the short form.