Search



Page tree

  

ECL Query Procedure

The eclQuery lists the conceptId and preferred term for each concept that conforms to a specified SNOMED CT expression constraint.

Notes

  1. The expression constraints supported do not cover the full ECL specification but are restricted as described below.
  2. This procedure will only run in MySQL version 8.0 or later. It uses some function which are not available in earlier versions (including the widely used MySQL version 5.7).

Example 4.9.5-1: Example Use of eclQuery Procedure

SQL Call to Procedure

call snap_eclQuery(p_ecl);

ParameterDescriptionData typeExamples

p_ecl

The ECL query texttext

(< 19829001 |disorder of lung|) OR (< 301867009 |edema of trunk|)

'(< 19829001 |disorder of lung|) MINUS (< 301867009 |edema of trunk|)'

'>> 40541001 |Acute pulmonary edema|'

'>39057004 |pulmonary valve|'

'>!39057004 |pulmonary valve|'

Example Procedure Call
call snap_eclQuery('< 19829001 |disorder of lung|:116676008 |Associated morphology| = 40829002 |Acute edema|');

Result

conceptIdterm
10519008Acute pulmonary oedema due to fumes AND/OR vapours
40541001Acute pulmonary oedema
61233003Silo-fillers' disease
233706004Drug-induced acute pulmonary oedema
233709006Toxic pulmonary oedema
233710001Chemical-induced pulmonary oedema
233711002Oxygen-induced pulmonary oedema
360371003Acute cardiac pulmonary oedema
10674871000119105Pulmonary oedema caused by chemical fumes

Expression Constraint Feature Support and Limitations

The following notes provide a brief summary of the extent to which this procedure supports evaluation of expression constraints. For a full and detailed understanding of SNOMED CT expression constraints see the specification of the SNOMED CT Expression Constraint Language.

ECL Operators and Examples

ECL Operator

Summary

Example

Symbol

Name

<

Descendant of

The set of all subtypes of the given concept

< 404684003 |Clinical finding|

<<

Descendant or self of

The set of all subtypes of the given concept plus the concept itself

<< 73211009 |Diabetes mellitus|

>

Ancestor of

The set of all supertypes of the given concept

> 40541001 |Acute pulmonary edema|

>>

Ancestor or self of

The set of all supertypes of the given concept plus the concept itself

>> 40541001 |Acute pulmonary edema|

<!

Child of

The set of all children of the given concept

<! 195967001 |Asthma|

>!Parent ofThe set of all parents of the given concept>! 195967001 |Asthma|

^

Member of

The set of referenced components in the given reference set

^ 733990004 |Nursing activities reference set|

*

Any

Any concept in the given SNOMED CT edition

*

:

Refinement

Only those concepts whose defining relationships match the given attribute value pairs

< 404684003 |clinical finding|: 116676008 |associated morphology| = *

AND

Conjunction

Only those concepts in both sets

(< 19829001 |disorder of lung|) AND (< 301867009 |edema of trunk|)

OR

Disjunction

Any concept that belongs to either set

(< 19829001 |disorder of lung|) OR (< 301867009 |edema of trunk|)

MINUS

Exclusion

Concepts in the first set that do not belong to the second set

(< 19829001 |disorder of lung|) MINUS (< 301867009 |edema of trunk|)

Additional Notes on Limitations of the ECL Query Procedure

The following notes outline the extent to which this procedure supports the SNOMED CT expression constraints and highlights some of the most significant limitations of this procedure.

One or more constraints can be specified.

  • Each constraint must start with a focus concept constraint expressed as one of the following:

    • A single conceptId specifying that concept as the focus concept.

    • A single conceptId preceded by <  (specifying subtypes only) or << (specifying self or subtypes)

    • A conceptId that identifies a reference set preceded by a ^ indicating members of that reference set.

    • An asterisk * (indicating any concept)

  • In all cases a concept Id may be followed by a term surrounded by pipe characters.

    • The term between pipes will be ignored for processing.

  • Spaces between any elements in the expression will be ignored

  • The focus constraint may optionally be followed by a refinement constraint separated from the focus constraint by a colon : 

If present the refinement constraint must consist of one or more attribute-value-constraint pairs.

  • The pair consists of an attribute-constraint and a value-constraint:
    • The attribute-constraint must be separated from the value constraint by an (equals) sign 
    • Both the constraints may be specified using any of the forms permitted for the focus concept constraint (see 1)
  • Attribute attribute-value-constraint pairs must be separated by a comma from any following attribute-value-constraint pair
  • NOTE: The procedure does not support:
    • Nested refinement constraints
    • Role grouping constraints
    • Cardinality constraints

If more than one constraint is specified:

  • Each constraint must be enclosed in brackets
  • One of the following logical operators must be present between adjacent constraints
    • OR       The resulting set is the set of concepts that conform to either the constraint to the left or the constraint to the right (or both constraint).
    • AND     The resulting set is the set of concepts that conform to both the constraint to the left and the constraint on the right.
    • MINUS The resulting set is the set of concepts that both conform to the constraint to the left and do not conform to the constraint on the right.
  • NOTE: The procedure does not support the use of brackets to alter the order of evaluation of constraints in a set. 
    The set of constraints is evaluated from left to right and, as illustrated below, this is likely to affect the results.
      1. (A) OR (B) AND (C) MINUS (D)
        1. Concepts in either (A) or (B) form temporary set (aT1) 
        2. Concepts in (aT1) and also in (C) form temporary set (aT2)
        3. Concepts in (aT2) that are NOT in (D) form the final result set (aR)
        4. One outcome of this order is that concepts in (B) that are not in (C) or are in (D) will not appear in the result set.
      2. (A) MINUS (D) AND (C) OR (B)
        1. Concepts in (A) and NOT in (D) form temporary set (bT1) 
        2. Concepts in (bT1) and also in (C) form temporary set (bT2)
        3. Concepts in either (bT2) or (B) for the final result set (bR)
        4. In this order all concepts that are in (B) with me in the result set.

Summary of Limitations of ECL Support for this Procedure

The Procedure does not support:

  • Nested constraints
  • Dotted attributes
  • Nested refinement constraints
  • Attribute group constraints
  • Cardinality constraints

The Procedure also requires that:

  • Even simple expression constraints must be enclosed by brackets when multiple constraints are combined.



Feedback
  • No labels