From a7d2fac4f192adfae4d24342a08b2f6db73a5e35 Mon Sep 17 00:00:00 2001 From: Jordan Smith Date: Tue, 3 Oct 2023 09:55:17 -0700 Subject: [PATCH 1/3] Add paragraph from server docs --- source/fundamentals/crud/read-operations/change-streams.txt | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/source/fundamentals/crud/read-operations/change-streams.txt b/source/fundamentals/crud/read-operations/change-streams.txt index 7f455de99..96d5a3fa7 100644 --- a/source/fundamentals/crud/read-operations/change-streams.txt +++ b/source/fundamentals/crud/read-operations/change-streams.txt @@ -142,6 +142,11 @@ Split Large Change Stream Events Starting in MongoDB 7.0, you can use the ``$changeStreamSplitLargeEvent`` aggregation stage to split events that exceed 16 MB into smaller fragments. + +You should use ``$changeStreamSplitLargeEvent`` only when strictly necessary. For +example, use ``$changeStreamSplitLargeEvent`` if your application requires full +document pre- or post-images, and generates large events that exceed 16 MB. + The $changeStreamSplitLargeEvent stage returns the fragments sequentially. You can access the fragments by using a change stream cursor. Each fragment includes a ``SplitEvent`` object containing the following fields: From f7423c2f7ed611b01997d57fc28b1ffa2f05dd09 Mon Sep 17 00:00:00 2001 From: Jordan Smith Date: Tue, 3 Oct 2023 10:00:45 -0700 Subject: [PATCH 2/3] Removed 'should' --- source/fundamentals/crud/read-operations/change-streams.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/fundamentals/crud/read-operations/change-streams.txt b/source/fundamentals/crud/read-operations/change-streams.txt index 96d5a3fa7..9d814892d 100644 --- a/source/fundamentals/crud/read-operations/change-streams.txt +++ b/source/fundamentals/crud/read-operations/change-streams.txt @@ -143,7 +143,7 @@ Split Large Change Stream Events Starting in MongoDB 7.0, you can use the ``$changeStreamSplitLargeEvent`` aggregation stage to split events that exceed 16 MB into smaller fragments. -You should use ``$changeStreamSplitLargeEvent`` only when strictly necessary. For +Use ``$changeStreamSplitLargeEvent`` only when strictly necessary. For example, use ``$changeStreamSplitLargeEvent`` if your application requires full document pre- or post-images, and generates large events that exceed 16 MB. From 650d2c3765d0c0b2262a0f2ab859b6a2b8d28f16 Mon Sep 17 00:00:00 2001 From: Jordan Smith Date: Tue, 3 Oct 2023 10:47:55 -0700 Subject: [PATCH 3/3] wording update --- source/fundamentals/crud/read-operations/change-streams.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/fundamentals/crud/read-operations/change-streams.txt b/source/fundamentals/crud/read-operations/change-streams.txt index 9d814892d..f6220b937 100644 --- a/source/fundamentals/crud/read-operations/change-streams.txt +++ b/source/fundamentals/crud/read-operations/change-streams.txt @@ -145,7 +145,7 @@ aggregation stage to split events that exceed 16 MB into smaller fragments. Use ``$changeStreamSplitLargeEvent`` only when strictly necessary. For example, use ``$changeStreamSplitLargeEvent`` if your application requires full -document pre- or post-images, and generates large events that exceed 16 MB. +document pre- or post-images, and generates events that exceed 16 MB. The $changeStreamSplitLargeEvent stage returns the fragments sequentially. You can access the fragments by using a change stream cursor. Each fragment