fleDisableSubstringPreviewParameterLimits

Queryable Encryption prefix, suffix, and substring queries are available in public preview in MongoDB 8.2. Do not enable these query types in production. Public preview functionality will be incompatible with the GA feature, and you will have to drop any collections that enable these queries.

Definition

fleDisableSubstringPreviewParameterLimits

New in version 8.2.

Available for both mongod and mongos.

Overrides the string length limitations for substring queries on Queryable Encryption enabled collections.

You can only set fleDisableSubstringPreviewParameterLimits on mongos or a replica set primary. The value is set cluster-wide.

Syntax

To set fleDisableSubstringPreviewParameterLimits for your deployment, run the following command on the admin database:

db.adminCommand(
   {
      setClusterParameter: {
         fleDisableSubstringPreviewParameterLimits: { shouldOverride: true }
      }
   }
)

To view the current value, run the following command on the admin database:

db.adminCommand( { getClusterParameter: "fleDisableSubstringPreviewParameterLimits" } )

Behavior

By default, MongoDB enforces soft limits for Queryable Encryption encrypted string fields with substring queries enabled:

strMaxLength is limited to 60 characters
strMaxQueryLength is limited to 10 characters
strMinQueryLength must be 2 or higher

This parameter overrides these restrictions.

Important

Querying long encrypted strings strongly impacts performance. Limit string length and query length whenever possible.

Back

defaultMaxTimeMS

Workload Isolation