Solutions
...
Litmus Production Record Datab...
Interacting with Litmus Produc...

Purging of a tag definition

7min

Use Cases

It might be necessary for users to remove an individual tag definition from the database, if they for example discontinue to use it or other circumstance make it obsolete.

To purge a tag definition, first all of the related tag and meta data have to be purged. Otherwise data without a context would exist in the database.

For how to purge all tag and meta data for a data model, please follow the instructions here:

User can purge individual tag definitions, which will include all the ID's.

User can do this either by using applications such as:

  • Microsoft SQL Server Management Studio
  • MSSQL CLI

This can also be used for building custom solutions based on applications which allow for an ODBC connection such as:

  • Excel
  • C#
  • .Net
  • Python

Method

Execute Stored Procedure PROREC_Misc_Tag_Hierarchy_Purge

Input Variables

Variable name

Datatype

Description

Example

@Tag

VARCHAR(50)

The name of the Tag. Mandatory!

Can not be NULL or Empty

SerialNo









@Device

VARCHAR(50)

The name of a specific device.



Devices in Litmus Production Record Database are acting the same way as they do in Litmus Edge in grouping tags logically together.



It is recommended to use the same device name as used in Litmus Edge.



Mandatory!

Can not be NULL or Empty

PLC_RC1_CCS

How to use

To purge a specific tag definition, call the stored procedure PROREC_Misc_Tag_Hierarchy_Purge using the T-SQL EXEC or EXECUTE keyword and provide the Input variables. Below is an example using T-SQL in SQL Server Management Studio:

EXECUTE [LE_ProductionRecord].[dbo].[PROREC_Misc_Tag_Hierarchy_Purge] @Tag = N'SerialNo', @Device = N'PLC_RC1_CCS';

Note: The system will always create a backup first before purging. This way, the data model can always be restored.

If an output window does exist, the progress can be observed.

tag definition purge
tag definition purge


Result

The stored procedure will verify that the provided values are correct and all tag data are purged and then create the backup before purging the tag definition.

The result can be read back from the log table PROREC_Misc_Log.

Below is an example using T-SQL in SQL Server Management Studio:

SELECT TOP (100) [LogID] ,[LogType] ,[LogProcedure] ,[LogEntry] ,[LogTime] FROM [LE_ProductionRecord].[dbo].[PROREC_Misc_Log] WHERE [LogProcedure] = 'PROREC_Misc_Tag_Hierarchy_Purge' Order by LogID Desc;

With the result returned

log entry for tag definition purge
log entry for tag definition purge