Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

DOCSP-23996 Add enableUtf8Validation Connectionstring Option #576

Merged
merged 38 commits into from
Jan 19, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
38 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 30 additions & 0 deletions source/includes/fact-non-utf8-data.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
If you attempt to query or export data with invalid UTF8 characters
the following error message displays:

.. code-block:: none
:copyable: false

Invalid UTF-8 string in BSON document.

To query or export this data, disable UTF8 validation by setting
the ``enableUtf8Validation`` URI option to ``false``.

.. warning::

**Editing data** with ``enableUtf8Validation=false`` can result in
loss of data. This approach is a temporary workaround to
query or export data only.
sarah-olson-mongodb marked this conversation as resolved.
Show resolved Hide resolved

The following URI disables UTF8 validation:
ianf-mongodb marked this conversation as resolved.
Show resolved Hide resolved

.. code-block:: javascript

mongodb://localhost:27017/?enableUtf8Validation=false


.. note::

You can also disable this option in the
:ref:`Advanced Connection Options <advanced-connection-tab>` by
selecting :guilabel:`enableUtf8Validation` and entering
``false``.
7 changes: 7 additions & 0 deletions source/query/filter.txt
Original file line number Diff line number Diff line change
Expand Up @@ -374,6 +374,13 @@ Clear the Query

.. include:: /includes/clear-query.rst

.. _compass-query-invalid-utf8-data:

Query Collections with Invalid UTF8 Data
----------------------------------------

.. include:: /includes/fact-non-utf8-data.rst

How Does the Compass Query Compare to MongoDB and SQL Queries?
--------------------------------------------------------------

Expand Down
Loading