ECSQLOPTIONS or OPTIONS clause

ECSQLOPTIONS (or OPTIONS for short) are used to specify flags thats will effect processing of the ECSQL statement.

Syntax: <select-stmt> OPTIONS option[=val] [,...]

Here is list of supported options

  1. USE_JS_PROP_NAMES returns json from instance accessor, compilable with iTwin.js typescript.
  2. DO_NOT_TRUNCATE_BLOB return full blob instead of truncating it when using instance accessor.
  3. ENABLE_EXPERIMENTAL_FEATURES enable experimental features.

Get instance as json which is compatible with itwin.js.

SELECT $ FROM [BisCore].[Element] OPTIONS USE_JS_PROP_NAMES
/*
$
--------------------
{
   "id":"0x1",
   "className":"BisCore.Subject",
   "model":{
      "id":"0x1",
      "relClassName":"BisCore.ModelContainsElements"
   },
   "lastMod":"2023-12-06T15:24:45.785Z",
   "codeSpec":{
      "id":"0x1f",
      "relClassName":"BisCore.CodeSpecSpecifiesCode"
   },
   "codeScope":{
      "id":"0x1",
      "relClassName":"BisCore.ElementScopesCode"
   },
   "codeValue":"Subject of this imodel",
   "description":""
}
*/

ECSql Syntax

Last Updated: 13 May, 2024