Skip to content

Commit b320987

Browse files
Apply suggestions from code review
Co-authored-by: Charlotte Hoblik <[email protected]>
1 parent ff1f8ec commit b320987

File tree

1 file changed

+9
-3
lines changed

1 file changed

+9
-3
lines changed

docs/reference/search-connectors/es-connectors-mongodb.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -251,15 +251,21 @@ A bug introduced in **8.12.0** causes the Connectors docker image to error out i
251251

252252
See [Known issues](/release-notes/known-issues.md) for any issues affecting all connectors.
253253

254-
#### UUIDs are not correctly deserialised causing problems with ingesting documents into Elasticsearch
254+
#### UUIDs are not correctly deserialized, causing problems with ingesting documents into Elasticsearch
255255

256256
MongoDB has special handling of UUID type: there is a legacy and a modern approach. You can read [official docs](https://pymongo.readthedocs.io/en/stable/examples/uuid.html) about the details.
257257

258258
With 8.18.3 better handling of standard UUID representation has been implemented - now MongoDB connector is able to properly deserialise them into valid UUIDs. However, for legacy UUIDs or older versions of the connector you might need to adjust the connection string to specify the UUID representation.
259259

260-
For example, if you are using modern UUID representation, adding `uuidRepresentation=standard` query parameter into the URL in the `host` Rich Configurable Field will make the connector properly handle UUIDs. With this change the full `host` Rich Configurable Field value could look like this: `mongodb+srv://my_username:[email protected]/mydb?w=majority&uuidRepresentation=standard`
260+
For example, if you are using the modern UUID representation, adding the `uuidRepresentation=standard` query parameter to the MongoDB connection URI in the `host` Rich Configurable Field will allow the connector to properly handle UUIDs. With this change, the full `host` Rich Configurable Field value could look like this:`mongodb+srv://my_username:[email protected]/mydb?w=majority&uuidRepresentation=standard`
261261

262-
If you are using, for example, legacy C# representation of UUIDs, then you should add `uuidRepresentation=csharpLegacy`, for Java it'll be `uuidRepresentation=javaLegacy` and for Python it'll be `uuidRepresentation=pythonLegacy`. Full explanation can be found in [official docs](https://pymongo.readthedocs.io/en/stable/examples/uuid.html#configuring-a-uuid-representation).
262+
If you’re using a legacy UUID representation, you should adjust the connection URI accordingly. For example:
263+
264+
- C#: `uuidRepresentation=csharpLegacy`
265+
- Java: `uuidRepresentation=javaLegacy`
266+
- Python: `uuidRepresentation=pythonLegacy`
267+
268+
You can find a full explanation in the [official docs](https://pymongo.readthedocs.io/en/stable/examples/uuid.html#configuring-a-uuid-representation).
263269

264270
### Troubleshooting [es-connectors-mongodb-client-troubleshooting]
265271

0 commit comments

Comments
 (0)