Skip to content

Commit 7795726

Browse files
committed
DOCSP-17695 update known issues 5.0.1
1 parent 3561e2c commit 7795726

File tree

3 files changed

+46
-62
lines changed

3 files changed

+46
-62
lines changed

source/core/timeseries/timeseries-granularity.txt

Lines changed: 18 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,10 @@ Set Granularity for Time Series Data
1818

1919
.. note::
2020

21-
Currently, you can only set a collection's ``granularity`` parameter
22-
when creating the collection. After creation the parameter can't be
23-
modified. See :ref:`known issues <5.0-known-issue-granularity>`.
21+
You must be running MongoDB 5.0.1 or later in order to change a
22+
time series collection's granularity after the collection has been
23+
created. See :ref:`MongoDB 5.0 known issues
24+
<5.0-known-issue-granularity>`.
2425

2526
When you create a :ref:`time series collection
2627
<manual-timeseries-collection>`, set the granularity to the value that
@@ -124,24 +125,21 @@ which contains the ``options.timeseries.granularity`` field.
124125
}
125126
}
126127

127-
.. TODO: uncomment once SERVER-58171 is fixed
128+
Change the ``granularity`` of a Time Series Collection
129+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
128130

129-
.. Change the ``granularity`` of a Time Series Collection
130-
.. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
131+
To change the ``granularity`` parameter value, issue the following
132+
:dbcommand:`collMod` command:
131133

134+
.. code-block:: javascript
132135

133-
.. To change the ``granularity`` parameter value, issue the following
134-
.. :dbcommand:`collMod` command:
135-
136-
.. .. code-block:: javascript
137-
138-
.. db.runCommand({
139-
.. collMod: "weather24h",
140-
.. timeseries: { granularity: "hours" }
141-
.. })
136+
db.runCommand({
137+
collMod: "weather24h",
138+
timeseries: { granularity: "hours" }
139+
})
142140

143-
.. Once the ``granularity`` is set it can only be increased by one level at
144-
.. a time. From ``"seconds"`` to ``"minutes"`` or from ``"minutes"`` to
145-
.. ``"hours"``. Other changes are not allowed. If you need to change the
146-
.. ``granularity`` from ``"seconds"`` to ``"hours"``, first increase the
147-
.. ``granularity`` to ``"minutes"`` and then to ``"hours"``.
141+
Once the ``granularity`` is set it can only be increased by one level at
142+
a time. From ``"seconds"`` to ``"minutes"`` or from ``"minutes"`` to
143+
``"hours"``. Other changes are not allowed. If you need to change the
144+
``granularity`` from ``"seconds"`` to ``"hours"``, first increase the
145+
``granularity`` to ``"minutes"`` and then to ``"hours"``.

source/core/timeseries/timeseries-limitations.txt

Lines changed: 5 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -94,24 +94,11 @@ can't be modified.
9494
Modification of ``granularity``
9595
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
9696

97-
Currently, you can only set a collection's ``granularity`` parameter
98-
when creating the collection. After creation the parameter can't be
99-
modified.
100-
101-
.. note::
102-
103-
See :ref:`known issues <5.0-known-issue-granularity>`.
104-
105-
.. TODO: use below copy once SERVER-58171 is fixed
106-
107-
.. Modification of ``granularity``
108-
.. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
109-
110-
.. Once the ``granularity`` is set it can only be increased by one level at
111-
.. a time. From ``"seconds"`` to ``"minutes"`` or from ``"minutes"`` to
112-
.. ``"hours"``. Other changes are not allowed. If you need to change the
113-
.. ``granularity`` from ``"seconds"`` to ``"hours"``, first increase the
114-
.. ``granularity`` to ``"minutes"`` and then to ``"hours"``.
97+
Once the ``granularity`` is set it can only be increased by one level at
98+
a time. From ``"seconds"`` to ``"minutes"`` or from ``"minutes"`` to
99+
``"hours"``. Other changes are not allowed. If you need to change the
100+
``granularity`` from ``"seconds"`` to ``"hours"``, first increase the
101+
``granularity`` to ``"minutes"`` and then to ``"hours"``.
115102

116103
Schema Validation
117104
~~~~~~~~~~~~~~~~~

source/release-notes/5.0.txt

Lines changed: 23 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -41,11 +41,11 @@ Issues fixed:
4141
Time Series Collections
4242
-----------------------
4343

44-
MongoDB 5.0 introduces :term:`time series collections <time series
45-
collection>` which efficiently store sequences of measurements over a
46-
period of time. Compared to normal collections, storing time series data
47-
in time series collections improves query efficiency and reduces disk
48-
usage for your data and indexes.
44+
MongoDB 5.0 introduces :ref:`time series collections
45+
<manual-timeseries-collection>` which efficiently store sequences of
46+
measurements over a period of time. Compared to normal collections,
47+
storing time series data in time series collections improves query
48+
efficiency and reduces disk usage for your data and indexes.
4949

5050
Aggregation
5151
-----------
@@ -760,34 +760,33 @@ To download MongoDB 5.0, go to the `MongoDB Download Center
760760
- `All Third Party License Notices <https://github.com/mongodb/mongo/blob/v4.4/distsrc/THIRD-PARTY-NOTICES>`_.
761761

762762
.. _5.0-known-issues:
763+
.. _5.0-known-issue-granularity:
764+
.. _5.0-known-issue-backup-resharding:
763765

764766
Known Issues
765767
------------
766768

767-
.. _5.0-known-issue-granularity:
769+
.. list-table::
770+
:header-rows: 1
771+
:widths: 15 70 20
772+
773+
* - In Version
774+
- Issues
775+
- Status
768776

769-
Modification of ``granularity`` for Time Series Collections
770-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
777+
* - 5.0.0
771778

772-
Currently, you can only set a collection's ``granularity`` parameter
773-
when creating the collection. After creation the parameter can't be
774-
modified. Once :issue:`SERVER-58171` is resolved, you will be able to
775-
modify the ``granularity`` of a
776-
:ref:`time series collection <manual-timeseries-collection>` after
777-
creation. :issue:`SERVER-58171` is expected to be resolved in MongoDB
778-
5.0.1.
779+
- :issue:`SERVER-58171`: A Time Series collection's ``granularity``
780+
parameter cannot be modified after the collection is created.
779781

780-
.. _5.0-known-issue-backup-resharding:
782+
- Fixed in 5.0.1
783+
784+
* - 5.0.0
781785

782-
Backup and Restore Not Supported During Resharding Operations
783-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
786+
- :issue:`SERVER-58392`: An ongoing resharding operation may
787+
prevent a backup or restore operation from succeeding.
784788

785-
Currently, a resharding operation may pin timestamps in the storage
786-
engine in a manner that prevents a restore operation from proceeding.
787-
Once :issue:`SERVER-58392` is resolved, you will be able to backup and
788-
restore your collection while a resharding operation occurs.
789-
:issue:`SERVER-58392` is expected to be resolved in a patch release of
790-
MongoDB 5.0.
789+
- Unresolved
791790

792791
Report an Issue
793792
---------------

0 commit comments

Comments
 (0)