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

Restore a tag definition

6min

Use Cases

Users can restore a tag definition for example on a new server or after a factory reset.

After a tag definition has been restored, it is also possible to paly back corresponding tag data.

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_Read_Backup

Input Variables

Variable name

Datatype

Description

Example

@Backupfile

NVARCHAR(100)

The complete path and filename of the tag definition backup file







Mandatory!

Can not be NULL or Empty

Windows Example:

D:\MSSQL\DATA\LE_PROREC_Tag_Hierarchy_Backup_SerialNo_2023-03-23_16-10-17.bak



Linux Example:

/var/opt/mssql/data/LE_PROREC_Tag_Hierarchy_Backup_SerialNo_2023-03-23_16-10-17.bak

How to use

To restore a backup of a specific tag definition, call the stored procedure PROREC_Misc_Tag_Hierarchy_Read_Backupusing 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_Read_Backup] @Backupfile = N'/var/opt/mssql/data/LE_PROREC_Tag_Hierarchy_Backup_SerialNo_2023-03-23_16-10-17.bak';

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

restore tag definition
restore tag definition


Result

The stored procedure will verify that the provided values are correct and then restore 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_Read_Backup' Order by LogID Desc;

With the result returned

log entry tag definition restore
log entry tag definition restore