company logo

DataSource :: schemaVersion - SCHEMA_VERSION option

This variable allows defining a database version for opening the dictionary (schema version). When opening an older version of a database one may run with the appropriate dictionary version valid for this database. Usually the system tries to detect the proper schema version.

When being set, this value is set typically in the configuration or ini-file in the SCHEMA_VERSION option for the data source definition.

Default: Current schema version of the dictionary

SCHEMA_VERSION=3

Return value:  Major version number ( int32  )

Major versions are defined on database level. database versions are numbered consecutively beginning with 0, when consistent versioning has been enabled.

Implementation overview

Implementation details

  1. Get schema version
    int32 DataSource  :: schemaVersion (  )

    The function returns the schema version value set in the data source. When being set after opening the database, this might differ from the database schema version used for the database currently opened.

  2. to list
  3. Change schema version
    int32 DataSource  :: schemaVersion ( int32 iVersion )

    The function changes the value of the database schema version currently set in the data source, but not the schema version for the database handle currently opened.

    The value must be set before opening the data source or the database handle. Setting the value afterwards will not have any effect until reopening the database.

    • iVersion - Major version number

      Major versions are defined on database level. database versions are numbered consecutively beginning with 0, when consistent versioning has been enabled.

  4. to list