DOCSP-43081: Change Streams #37
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
✅ Deploy Preview for docs-c ready!
To edit notification comments on pull requests, go to your Netlify site configuration. |
jordan-smith721
requested changes
Sep 16, 2024
source/read/change-streams.txt
Outdated
| -------- | ||
|
|
||
| In this guide, you can learn how to use the {+driver-short+} to monitor a **change stream**, | ||
| allowing you to view real-time changes to your database. A change stream is a {+mdb-server+} feature that |
There was a problem hiding this comment.
S: Change to data since you can open a change stream on more than just a database
Suggested change
| allowing you to view real-time changes to your database. A change stream is a {+mdb-server+} feature that | |
| allowing you to view real-time changes to your data. A change stream is a {+mdb-server+} feature that |
source/read/change-streams.txt
Outdated
| -------------------- | ||
|
|
||
| To open a change stream, call one of the following functions that corresponds to the | ||
| scope of events you want to observe. |
There was a problem hiding this comment.
Suggested change
| scope of events you want to observe. | |
| scope of events you want to observe: |
source/read/change-streams.txt
Outdated
Comment on lines
42
to
44
| - ``mongoc_client_watch()``: To monitor all changes in the MongoDB deployment | ||
| - ``mongoc_database_watch()``: To monitor changes in all collections in the database | ||
| - ``mongoc_collection_watch()``: To monitor changes in the collection |
There was a problem hiding this comment.
Suggested change
| - ``mongoc_client_watch()``: To monitor all changes in the MongoDB deployment | |
| - ``mongoc_database_watch()``: To monitor changes in all collections in the database | |
| - ``mongoc_collection_watch()``: To monitor changes in the collection | |
| - ``mongoc_client_watch()``: Monitors all changes in the MongoDB deployment | |
| - ``mongoc_database_watch()``: Monitors changes in all collections in the database | |
| - ``mongoc_collection_watch()``: Monitors changes in the collection |
source/read/change-streams.txt
Outdated
Comment on lines
101
to
102
| change events. Format the parameter as a list of objects that each represents an | ||
| aggregation stage. |
There was a problem hiding this comment.
S:
Suggested change
| change events. Format the parameter as a list of objects that each represents an | |
| aggregation stage. | |
| change events. Format the parameter as a list of objects, where each object represents an | |
| aggregation stage. |
source/read/change-streams.txt
Outdated
| - ``$set`` | ||
| - ``$unset`` | ||
|
|
||
| Match Specific events Example |
There was a problem hiding this comment.
Suggested change
| Match Specific events Example | |
| Match Specific Events Example |
source/read/change-streams.txt
Outdated
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
|
|
||
| The following example uses the ``pipeline`` parameter to include a ``$match`` stage | ||
| to open a change stream that only records update operations: |
There was a problem hiding this comment.
Suggested change
| to open a change stream that only records update operations: | |
| to open a change stream that records only update operations: |
jordan-smith721
approved these changes
Sep 17, 2024
source/read/change-streams.txt
Outdated
|
|
||
| You can pass the ``pipeline`` parameter to any watch function to modify the | ||
| change stream output. This parameter allows you to watch for only specified | ||
| change events. Format the parameter as a list of object, where each object represents an |
There was a problem hiding this comment.
Suggested change
| change events. Format the parameter as a list of object, where each object represents an | |
| change events. Format the parameter as a list of objects, where each object represents an |
kevinAlbs
approved these changes
Sep 18, 2024
| mongoc_change_stream_t *change_stream = | ||
| mongoc_collection_watch (collection, pipeline, opts); | ||
|
|
||
| while (mongoc_change_stream_next (change_stream, &doc)) { |
There was a problem hiding this comment.
mongoc_change_stream_next only returns true when a change is returned within the maxAwaitTimeMS. If no change was returned, and no error occurred, a later call to mongoc_change_stream_next can still return a change.
If the examples are intended to show the behavior of "wait (possibly forever) until there is an event or error", then I suggest looping as follows:
while (true)
{
bson_error_t error;
if (mongoc_change_stream_next(change_stream, &doc))
{
char *str = bson_as_canonical_extended_json(doc, NULL);
printf("Received change: %s\n", str);
bson_free(str);
}
else if (mongoc_change_stream_error_document(change_stream, &error, NULL))
{
printf("Got error on change stream: %s\n", error.message);
break;
}
}
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Pull Request Info
PR Reviewing Guidelines
JIRA - https://jira.mongodb.org/browse/DOCSP-43081
Staging - https://deploy-preview-37--docs-c.netlify.app/read/change-streams
Self-Review Checklist