Manually Create a PI Unit Batch

Document created by kduffy on Oct 30, 2018Last modified by jkim on Nov 8, 2018
Version 4Show Document
  • View in full screen mode

In this course, we make use of PI Unit Batches in a query, but the query won't return anything if batches don't exist. Rather than set up a batch interface for this example, you can manually add a PI Unit Batch to your Data Archive for a quick test.


In PI System Management Tools, we'll first make the module that will represent the unit, add a temperature alias, then make the unit batch.


Make the module:

  1. Connect to the correct data archive
  2. Navigate to Operation > Module Database
  3. Right click on Modules and select New
  4. Name the module
  5. Select that it's a "PIUnit" so that it becomes eligible for unit batches
  6. Click OK


Confirm that the icon for the module is a tank and not a block M


Create the temperature alias:

  1. Right click on the newly created module and select New > Alias
  2. Fill in the alias name, tag name, and server name


Expand the module and confirm that alias is added (you may need to right click on any white space and select Show > Alias and Property Values


Create the Unit Batch:

  1. Connect to the PI Data Archive that you will be querying
  2. Navigate to Batch > Batch Database
  3. Expand the Modules list; right click on the module you would like to attach the unit batch to and select "New PIUnitBatch"
  4. Enter Batch ID, Product, and Recipe information
  5. Enter a start and end time
  6. Click ok


Confirm that the unit batch appears in the batch search immediately


The batch should appear in SMT's batch search immediately, but to confirm that the permissions are correct from PI SQL Commander, let's query for the batch at this point.


Navigate to the pibatch catalog and right click on the piunitbatch table. Select "Execute Predefined Query" and set the batchid to what was entered in the previous step. Execute the query and confirm that the output contains the unit batch that was just created.