Technical FAQs

Ask a Question

PME 7.2/8.x: How to execute the TrimRecords stored procedure via a scheduled task in SQL Server Agent

Issue
To manage drive space limitations, it is desirable to only keep a specified amount of historical data available for reporting.  For some customers this may be 1, 2, 3...10 years. However, it is not desirable to create archive databases that have to then be deleted themselves.

Product Line
Power Monitoring Expert 7.x
Power Monitoring Expert 8.x

Environment
SQL Server

Cause
An archive database takes up additional space on the hard drive, therefore it is desirable to only remove old data on a periodic basis.

Resolution
*Warning: Irreparable database damage can occur. This procedure should only be performed by users familiar with SQL Server Management Studio. Databases should be backed up prior to performing this procedure.*


1. Expand SQL Server Agent
2. Right click Jobs > New Job...



3. Name = ION_Data Trim Schedule
4. Click Steps > New
5. Step name = Trim Data

NOTE: If this system needs to retain 2 years in the live database, the 'DATEADD' function within 'myEndDate' variable needs to be modified to the following:
                         DATEADD(YEAR, -2, GETDATE())
          If this system needs to retain 6 months in the live database, it should be changed to:
                         DATEADD(MONTH, -6, GETDATE())
          Define a 'StartDate' as per the specified date format (yyyy-mm-dd). Example: '1900-01-1'.
           
The query below trims the DataLog2, WaveformLog2 and EventLog2 tables. Change the @TrimDataLog, @TrimWaveForm, @TrimEvent parameters to 0 (NO) or 1 (YES) as required.

6. In the Command pane type the following:

USE [ION_Data]
GO

DECLARE    @return_value int
DECLARE    @MyEndDate datetime2
select           @MyEndDate = convert(varchar(10), DATEADD(MONTH, -1, cast(getdate() as date)), 20)

EXEC    @return_value = [dbo].[TrimRecords]
             @StartDate = 'yyyy-mm-dd',
             @EndDate = @MyEndDate,
             @TrimDataLog = 1,
             @TrimWaveForm = 1,
             @TrimEvent = 1

7. Click Schedules > New
8. Name = Trim Data 
9. Set the frequency that meets this systems needs.  To just keep a rolling X (where X is the number chosen by the customer) amount of years in the database this could be set to monthly.  If it is desirable to keep a full previous X years this will need to be run yearly on January 1st.
10. Click OK, then Click OK on the Job window.
Was this helpful?
What can we do to improve the information ?