Skip to main content

Configuration

EHRbase comes with some options to customize how the AQL engine behaves.

Pagination parameters conflict

Configure how EHRbase reacts when there is a conflict of AQL query LIMIT/OFFSET clauses and fetch/offset query parameters during an AQL query execute request by choosing one of the following strategies:

  1. REJECT - EHRbase rejects the query execution if the AQL query contains a LIMIT or OFFSET and the fetch or offset query parameters are also present on the request
  2. MIN_FETCH - EHRbase will take the minimum value of LIMIT and fetch and use that one during the query execution; If the query AQL also contains the OFFSET clause, then the request is rejected.

Strategy the execute AQL query requests use when LIMIT/OFFSET are used in combination with fetch/offset query params

PropertyENVDefault valueSupported values
ehrbase.rest.aql.fetch-precedenceEHRBASE_REST_AQL_FETCHPRECEDENCEREJECTREJECT, MIN_FETCH

Limit query results by default

To set up data query safeguards EHRbase can be configured with the following limits:

  • ehrbase.rest.aql.default-limit - when the AQL query or the request don't specify a LIMIT and fetch the system will use the configured default limit
  • ehrbase.rest.aql.max-limit - a hard constraint for the LIMIT clause in any AQL query ran in the system; in case a query exceeds it, an error is reported
  • ehrbase.rest.aql.max-limit - a hard constraint for the fetch query parameter in any AQL execute query requests; in case a request exceeds it, an error is reported
PropertyENVDefault valueSupported values
ehrbase.rest.aql.default-limitEHRBASE_REST_AQL_DEFAULTLIMITnoneany positive number
ehrbase.rest.aql.max-limitEHRBASE_REST_AQL_MAXLIMITnoneany positive number
ehrbase.rest.aql.max-fetchEHRBASE_REST_AQL_MAXFETCHnoneany positive number