Configuring Supervisor database properties
- Right-click your database name under in the Nav tree, and click .The Property Sheet opens.
Above is an example using the MySQLDatabase Property Sheet.
The Components chapter in this guide documents all properties. The following table indicates which properties are available based on the rdb database device.
RdbmsNetwork database properties
Property HsqlDb (controller only) MySQL Oracle SqlServer Status (Information) - - - - Enabled √ √ √ √ Fault Cause (Information) - - - - Health (Information) - - - Alarm Source Info √ √ √ √ Host Address - √ √ √ User Name √ √ √ √ Password - √ √ √ Worker √ √ √ √ Export Mode √ √ √ √ Use Unicode Encoding Scheme √ √ √ √ Timestamp Storage √ - √ √ Points √ √ √ √ Sql Scheme Enabled √ √ √ √ Tls Min Protocol - √ √ √ Verify Subject in Certificate - √ √ √ Base Directory √ - - - Database Name √ √ - - Instance Name - - - √ Service Name - - √ - Port - √ √ √ Histories - √ √ √ Extra Connection Properties - √ - √ Version - - - √ - Configure at least these properties:
User NameandPassword(database credentials)Database NameHost Address
- To configure full UTF-8 Unicode support (NVARCHAR columns instead of VARCHAR columns), set
Use Unicode Encoding Schemetotrue.To preserve compatibility with legacy systems, this property defaults tofalseand must be changed before you connect to your database for the first time.Most databases (except MySQL) have a property called
Timestamp Storage. This property can configure the driver to update and export history timestamps using Coordinated Universal Time (UTC). - As a best practice, set
Export ModetoBy History Typeas most database administrators would rather manage a few tables instead of thousands of individual tables.When exporting byBy History Type, the driver exports histories of the same data type (Boolean, Numeric, Enum, String) to the same table. For example, all numeric type histories export to a table named HISTORYNUMERICTRENDRECORD. This table contains an additional column named HISTORY_ID, which stores the history ID reference (ORD) from the station for each record in the table. - To configure UTC timestamps, change
Timestamp Storagefrom the default (Dialect Default) to one of the UTC options.WithDialect Default, you must set bothUse Last TimestampandUse History Config Time Zonetotrue. This exports histories using theHistory Config Timezone. If you set the two properties tofalse, the driver exports histories using the station timezone.Selecting the
Utc Timestamptakes precedence over theUse Last TimestampandUse History Config Time Zoneproperties in the history device extension, rendering them effectively irrelevant.Switching back and forth between
Dialect DefaultandUtc Timestamppollutes the database with inconsistent timestamps, which can negatively affect any query you run to determine whether or not to export newer records. - Select the minimum TLS protocol, which can be negotiated when establishing encrypted communications with the database server.
- Enable
Verify Subject in Certificatefor the Rdbms driver to verify that the existing Subject in the server’s certificate matches the expected value. - Select the server certificate for the database from the
My Sql Server Certdrop–down list at the bottom of the Property Sheet.This certificate must have been signed by the root CA certificate of a third-party CA (Certificate Authority) or by your company’s own root CA certificate (if your company serves as its own CA). If your company serves as its own CA, its root CA certificate must be in the platform/station’s User Trust Store. For certificate management, refer to the Niagara Station Security Guide - To complete the configuration, click Save.