Smile CDR v2023.08.PRE
On this page:
   41.22    Cluster Level Security 41.24    Credentials   

41.23CQL

 

The CQL configuration category includes the following configurable options:

  • Data Analysis

  • Collapse Data Analysis

  • Version

  • Default Model Info

  • Disable List Demotion

  • Disable List Promotion

  • Disable List Traversal

  • Disable Method Invocation

  • Annotations

  • Date Range Optimization

  • Detailed Errors

  • Enable Interval Demotion

  • Enable Interval Promotion

  • Locators

  • Results Type

  • Error Level

  • Keyword

  • Signature Level

  • Format

  • Validate units

  • Semantic Analysis

  • Debug Logging

  • Enable Expression Caching

  • Enable Validation

  • Use Embedded Libraries

41.23.1Property: Data Analysis

 
Property Name Data Analysis
Property Key
Property Type BOOLEAN
Description Determines whether the CQL compiler should do detailed data-requirements analysis when compiling CQL.
Applies to Modules
  • CQL
Default Value false
Example Property
module.[MODULE_ID].config.compiler.analyze_data_requirements = false

41.23.2Property: Collapse Data Analysis

 
Property Name Collapse Data Analysis
Property Key
Property Type BOOLEAN
Description Determines whether the CQL compiler should "collapse" (i.e. optimize) data-requirements when they are generated.
Applies to Modules
  • CQL
Default Value false
Example Property
module.[MODULE_ID].config.compiler.collapse_data_requirements = false

41.23.3Property: Version

 
Property Name Version
Property Key
Property Type STRING
Description This setting controls the language-level that the CQL compiler should run in. Most DSTU3 content in the wild uses CQL version 1.3, while newer content uses CQL version 1.5. If you experience compilation errors please verify the SQL language level being used in the expressions.
Applies to Modules
  • CQL
Default Value 1.5
Example Property
module.[MODULE_ID].config.compiler.compatibility_level = 1.5

41.23.4Property: Default Model Info

 
Property Name Default Model Info
Property Key
Property Type BOOLEAN
Description Indicates to include default model information.
Applies to Modules
  • CQL
Default Value false
Example Property
module.[MODULE_ID].config.compiler.disable_default_model_info_load = false

41.23.5Property: Disable List Demotion

 
Property Name Disable List Demotion
Property Key
Property Type BOOLEAN
Description Disables demotion of list-valued expressions to singletons.
Applies to Modules
  • CQL
Default Value false
Example Property
module.[MODULE_ID].config.compiler.disable_list_demotion = false

41.23.6Property: Disable List Promotion

 
Property Name Disable List Promotion
Property Key
Property Type BOOLEAN
Description Disables promotion of singletons to list-valued expressions.
Applies to Modules
  • CQL
Default Value false
Example Property
module.[MODULE_ID].config.compiler.disable_list_promotion = false

41.23.7Property: Disable List Traversal

 
Property Name Disable List Traversal
Property Key
Property Type BOOLEAN
Description Disables traversal of paths on list-valued expressions.
Applies to Modules
  • CQL
Default Value false
Example Property
module.[MODULE_ID].config.compiler.disable_list_traversal = false

41.23.8Property: Disable Method Invocation

 
Property Name Disable Method Invocation
Property Key
Property Type BOOLEAN
Description Disables method-style invocation support.
Applies to Modules
  • CQL
Default Value false
Example Property
module.[MODULE_ID].config.compiler.disable_method_invocation = false

41.23.9Property: Annotations

 
Property Name Annotations
Property Key
Property Type BOOLEAN
Description Indicates that the translator should produce source code annotations as part of the output.
Applies to Modules
  • CQL
Default Value false
Example Property
module.[MODULE_ID].config.compiler.enable_annotations = false

41.23.10Property: Date Range Optimization

 
Property Name Date Range Optimization
Property Key
Property Type BOOLEAN
Description Indicates that the translator should perform date range optimization of retrieves where possible.
Applies to Modules
  • CQL
Default Value false
Example Property
module.[MODULE_ID].config.compiler.enable_date_range_optimization = false

41.23.11Property: Detailed Errors

 
Property Name Detailed Errors
Property Key
Property Type BOOLEAN
Description Indicates that the translator should produce detailed errors.
Applies to Modules
  • CQL
Default Value false
Example Property
module.[MODULE_ID].config.compiler.enable_detailed_errors = false

41.23.12Property: Enable Interval Demotion

 
Property Name Enable Interval Demotion
Property Key
Property Type BOOLEAN
Description Enables demotion of interval-valued expressions to points.
Applies to Modules
  • CQL
Default Value false
Example Property
module.[MODULE_ID].config.compiler.enable_interval_demotion = false

41.23.13Property: Enable Interval Promotion

 
Property Name Enable Interval Promotion
Property Key
Property Type BOOLEAN
Description Enables promotion of point-valued expressions to intervals.
Applies to Modules
  • CQL
Default Value false
Example Property
module.[MODULE_ID].config.compiler.enable_interval_promotion = false

41.23.14Property: Locators

 
Property Name Locators
Property Key
Property Type BOOLEAN
Description Indicates that the translator should include source code locators within output ELM.
Applies to Modules
  • CQL
Default Value false
Example Property
module.[MODULE_ID].config.compiler.enable_locators = false

41.23.15Property: Results Type

 
Property Name Results Type
Property Key
Property Type BOOLEAN
Description Indicates that the translator should include result types in the output ELM.
Applies to Modules
  • CQL
Default Value false
Example Property
module.[MODULE_ID].config.compiler.enable_results_type = false

41.23.16Property: Error Level

 
Property Name Error Level
Property Key
Property Type ENUM
Values
  • Info
  • Warning
  • Error
Description Determines the level of severity required for the CQL compiler to report an issue. Info enables all messages, while Error enables only Error messages
Applies to Modules
  • CQL
Default Value Info
Example Property
module.[MODULE_ID].config.compiler.error_level = Info

41.23.17Property: Keyword

 
Property Name Keyword
Property Key
Property Type BOOLEAN
Description Indicates that all queries will be required to start with a from keyword.
Applies to Modules
  • CQL
Default Value false
Example Property
module.[MODULE_ID].config.compiler.require_from_keyword = false

41.23.18Property: Signature Level

 
Property Name Signature Level
Property Key
Property Type ENUM
Values
  • None
  • Differing
  • Overloads
  • All
Description Determines the level of detail to output to compiled CQL for signature resolution. This should generally not be changed.
Applies to Modules
  • CQL
Default Value None
Example Property
module.[MODULE_ID].config.compiler.signature_level = None

41.23.19Property: Format

 
Property Name Format
Property Key
Property Type ENUM
Values
  • XML
  • JSON
  • COFFEE
Description The target format for the output
Applies to Modules
  • CQL
Default Value JSON
Example Property
module.[MODULE_ID].config.compiler.translator_format = JSON

41.23.20Property: Validate units

 
Property Name Validate units
Property Key
Property Type BOOLEAN
Description This flag controls whether the CQL compiler validates unit quantities for conversion
Applies to Modules
  • CQL
Default Value true
Example Property
module.[MODULE_ID].config.compiler.validate_units = true

41.23.21Property: Semantic Analysis

 
Property Name Semantic Analysis
Property Key
Property Type BOOLEAN
Description This flag controls whether the CQL compiler should emit compiled CQL or simply run semantic analysis.
Applies to Modules
  • CQL
Default Value false
Example Property
module.[MODULE_ID].config.compiler.verify_only = false

41.23.22Property: Debug Logging

 
Property Name Debug Logging
Property Key
Property Type BOOLEAN
Description Enabling debug logging will cause the SmileCDR server to output detailed evaluation logs for CQL. This can be useful for debug purposes. Debug logging has a significant performance impact.
Applies to Modules
  • CQL
Default Value false
Example Property
module.[MODULE_ID].config.runtime.debug_logging_enabled = false

41.23.23Property: Enable Expression Caching

 
Property Name Enable Expression Caching
Property Key
Property Type BOOLEAN
Description Enable expression caching allows to CQL engine to optimize expression reuse during evaluation, improving performance.
Applies to Modules
  • CQL
Default Value false
Example Property
module.[MODULE_ID].config.runtime.enable_expression_caching = false

41.23.24Property: Enable Validation

 
Property Name Enable Validation
Property Key
Property Type BOOLEAN
Description Enable validation checks compiled CQL prior to execution.
Applies to Modules
  • CQL
Default Value false
Example Property
module.[MODULE_ID].config.runtime.enable_validation = false

41.23.25Property: Use Embedded Libraries

 
Property Name Use Embedded Libraries
Property Key
Property Type BOOLEAN
Description SmileCDR ships with embedded versions of some commonly used CQL libraries, specifically FHIRHelpers. This switch determines whether or not the cql engine will use those embedded libraries.In the case you want to supply your our version of FHIRHelpers, you should set this to false
Applies to Modules
  • CQL
Default Value true
Example Property
module.[MODULE_ID].config.use_embedded_libraries = true
   41.22    Cluster Level Security 41.24    Credentials