From fc43e1690cd0e942ecb7680b52a0918341a48043 Mon Sep 17 00:00:00 2001 From: Louisa Berger Date: Mon, 8 Apr 2013 13:33:26 -0300 Subject: [PATCH 1/3] Update object-id.txt --- source/reference/object-id.txt | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/source/reference/object-id.txt b/source/reference/object-id.txt index 53294f7ac27..05ebde19a14 100644 --- a/source/reference/object-id.txt +++ b/source/reference/object-id.txt @@ -30,9 +30,16 @@ additional benefits: ` method. - sorting on an ``_id`` field that stores ``ObjectId`` values is - roughly equivalent to sorting by creation time, although this - relationship is not strict with ``ObjectId`` values generated on - multiple systems within a single second. + roughly equivalent to sorting by creation time. + + .. important:: + + This relationship is not strict with ``ObjectId`` values + generated within a single second. This can happen if the + values are generated by multiple systems within a second, + or as a result of clock skew on the client side, which + would result in non-strict behavior even for entries that + are multiple seconds apart. Also consider the :doc:`/core/document/` section for related information on MongoDB's document orientation. From 89a0ea236b68febaa0d4dc8985a0ab0c3c3e73a5 Mon Sep 17 00:00:00 2001 From: Louisa Berger Date: Mon, 8 Apr 2013 15:48:44 -0300 Subject: [PATCH 2/3] Update object-id.txt --- source/reference/object-id.txt | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/reference/object-id.txt b/source/reference/object-id.txt index 05ebde19a14..c80e884410b 100644 --- a/source/reference/object-id.txt +++ b/source/reference/object-id.txt @@ -39,7 +39,9 @@ additional benefits: values are generated by multiple systems within a second, or as a result of clock skew on the client side, which would result in non-strict behavior even for entries that - are multiple seconds apart. + are multiple seconds apart. This is because the ObjectId + is generated by the client driver rather than the mongod + process upon insert. Also consider the :doc:`/core/document/` section for related information on MongoDB's document orientation. From 8eec81b395118c57043166103471fc67f3847f1d Mon Sep 17 00:00:00 2001 From: Louisa Berger Date: Mon, 8 Apr 2013 16:17:59 -0300 Subject: [PATCH 3/3] Update object-id.txt --- source/reference/object-id.txt | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/reference/object-id.txt b/source/reference/object-id.txt index c80e884410b..2b2fe6c340c 100644 --- a/source/reference/object-id.txt +++ b/source/reference/object-id.txt @@ -36,7 +36,8 @@ additional benefits: This relationship is not strict with ``ObjectId`` values generated within a single second. This can happen if the - values are generated by multiple systems within a second, + values are generated by multiple systems (or by multiple + processes or threads on a single system) within a second, or as a result of clock skew on the client side, which would result in non-strict behavior even for entries that are multiple seconds apart. This is because the ObjectId