Overview

The Archive Locations menu offers a flexible way to define and manage where historical data is stored. You can define a default Tag Historian Database and add external options if necessary.


On this page:

Understanding Archive Location

The Archive Location defines where Tag data will be archived considering the Historian Tables configuration, establishing a clear linkage between tags and the storage infrastructure. When configuring the Archive Location, you can use:

  • SQL databases
  • Script Classes
  • Connections with a Third-Party Historian

When you set the Archive Location, you specify the storage medium for Tag data.

By default, the platform uses a SQLite database. You can change the default database or add additional databases if you need to use different ones.

Configuring the Default Database

You have several options to choose from when defining the default database. If you would like to change the default database to be something other then the initial SQLite built-in database, follow the steps below:

  1. Access Historian → Archive Locations.
  2. Click on the gear icon to open the Dialog.
  3. Define the default database configuration, defining Provider, Database, and Server IP.
  4. Test the database connection. Provide the necessary authentication information and click Test.
  5. Click OK to update the default database.

Available Databases

The following table provides a list of accepted providers and databases for configuring the default options.

ProviderDatabases
SQLiteSQLite
Odbc
  • Firebird
  • MSAccess2003
  • MSExcel2003
  • MySql
  • ODBC_DSN
  • ODBC_FileDsn
  • Oracle
  • SQLServer
  • SQLServer_WA
OleDb
  • CSVFile
  • MSAccess2003
  • MSAccess2007
  • MSExcel2003
  • MSExcel2007
  • Oracle
  • SQLServer
  • SQLServer_WA
OracleClientOracle
SqlClient
  • SQLServer
  • SQLServer_WA
PostgreSQLPostgreSQL


Add a new Archive Location

If you would like to add additional databases, follow the steps below to add and configure them.

  1. Access Historian→ Archive Location.
  2. Click on the plus icon.
  3. On the Dialog, configure the new database. You find the description of each option available in the next section of this documentation page.
  4. Click Ok.

Archive Location Properties

The table below describes the configuration options available when adding a new Archive Location.

Property

Description

Name

A unique name to identify the new Archive Location.

Description

Optional description to provide more context or information.

Store and Forward

If you check this option, the platform will store data locally in case of connection failure with the external database. The data is transferred when the connection is established.

Archive System

Types available to configure the Archive Location. Currently, two options are available:

  • Tag Provider: Enables you to use external solutions to archive Tag's data.

  • Script Class: For this option, you need to create a script class or point to existing classes to define how the data will be handled and stored. For help creating classes, see the Script, Classes, and Tasks documentation.

Protocol (Only available if using Tag Provider)

Defines the protocol used by the External Tag Provider. Currently, you can use the following options:

  • CanaryLabs
  • InfluxDB
  • GEProficy

Station Editor  (Only available if using Tag Provider)

Configure the connection string to the selected provider and run a test to ensure the setup is correct.


In this section: