[JAVA-4958] Remove "Public Technical Preview" from Queryable Encryption Equality API Created: 08/May/23  Updated: 06/Jun/23  Resolved: 06/Jun/23

Status: Closed
Project: Java Driver
Component/s: Client Side Encryption
Affects Version/s: None
Fix Version/s: 4.10.0

Type: Task Priority: Major - P3
Reporter: PM Bot Assignee: Slav Babanin
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Issue split
Upstream Changes Summary:

DRIVERS-2614:
Upgrade libmongocrypt dependency to stable 1.8.0. Binaries for libmongocrypt 1.8.0 are available here: https://spruce.mongodb.com/task/libmongocrypt_release_publish_upload_all_85bc65d56fa1c7b8ca499d8523ac269815704076_23_05_09_12_39_18/files?execution=0

Remove "Public Technical Preview" from Queryable Encryption (QE) API related to the algorithms "Indexed" and "Unindexed" as stable. That consists of the following API:

  • AutoEncryptionOpts.encryptedFieldsMap
  • AutoEncryptionOpts.bypassQueryAnalysis
  • EncryptOpts.contentionFactor
  • EncryptOpts.queryType
  • The "equality" value for EncryptOpts.queryType
  • The "Indexed" and "Unindexed" values for EncryptOpts.algorithm
  • ClientEncryption.CreateEncryptedCollection

If there is any documentation referencing the minimum server version to use Queryable Encryption, update the documentation to note MongoDB Server 7.0 is required. (libmongocrypt 1.8.0 and MongoDB server 7.0 support the QEv2 protocol. The QEv2 protocol is backwards breaking. Using QE with libmongocrypt<1.8.0 on a Server>=7.0, or using libmongocrypt>=1.8.0 on a Server<6.0 will result in a server error when using the incompatible payloads).

The QE "rangePreview" algorithm and related API as part of DRIVERS-2286 is still expected to be marked as "experimental only" (DRIVERS-2286). "rangePreview" is not expected to be marked stable for MongoDB 7.0.

Changelog:
2023-05-12: Do not document Queryable Encryption Equality API as stable. The announcement is expected for NYC.local. Only remove the "Public Technical Preview" from the API.

Documentation Changes Summary:

1. What would you like to communicate to the user about this feature?
2. Would you like the user to see examples of the syntax and/or executable code and its output?
3. Which versions of the driver/connector does this apply to?


 Description   

This ticket was split from DRIVERS-2614, please see that ticket for a detailed description.



 Comments   
Comment by Githook User [ 06/Jun/23 ]

Author:

{'name': 'slav.babanin', 'email': 'slav.babanin@mongodb.com', 'username': ''}

Message: Remove "Public Technical Preview" from Queryable Encryption Equality API (#1132)

JAVA-4958
Branch: master
https://github.com/mongodb/mongo-java-driver/commit/50a01d4539c42e81193525d08b85016a59fcf2d4

Comment by Jeffrey Yemin [ 22/May/23 ]

In Java driver we used the Beta annotation, e.g. @Beta(Beta.Reason.SERVER) on AutoEncryptionSettings.Builder#encryptedFieldsMap

Generated at Thu Feb 08 09:03:23 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.