diff --git a/docs/source/json-api/search-query-language.rst b/docs/source/json-api/search-query-language.rst index 71b8578f24..48f41c9d16 100644 --- a/docs/source/json-api/search-query-language.rst +++ b/docs/source/json-api/search-query-language.rst @@ -126,3 +126,14 @@ value equality query for C. The above "Typecheck failure" happens because there is no LF type to which both ``"Bob"`` and ``["Bob", "Sue"]`` conform; this would be caught when interpreting the query, before considering any contracts. + +Appendix: Known issues +********************** + +When using Oracle, queries fail if a token is too large +======================================================= + +This limitation is exclusive to users of the HTTP JSON API using the Enterprise Edition support for Oracle. Due to a known limitation in Oracle, the full-test JSON search index on the contract payloads rejects query tokens larger than 256 bytes. This limitations shouldn't impact most workloads, but if this needs to be worked around, the HTTP JSON API server can be started passing the additional ``disableContractPayloadIndexing=true`` (after wiping an existing query store database, if necessary). + +`Issue on GitHub `__ +