/ /

fleDisableSubstringPreviewParameterLimits

Queryable Encryption equality and range queries are fully supported in production. Prefix, suffix, and substring queries are only available in public preview in MongoDB 8.2. Do not enable these query types in production. GA functionality of prefix, suffix and substring query types will be incompatible with the preview feature.

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