From b569a6649199b78144dada3e1d475e2aeb2ce9a3 Mon Sep 17 00:00:00 2001 From: JuPing Date: Wed, 26 Aug 2015 08:38:21 +0000 Subject: [PATCH] Fix description for "Inapt spelling of 'MongoDB'" There is an inapt spelling in the file called ceilometer/doc/source/webapi/v2.rst. line194:...different meaning in Mongo DB and... line198:...the Mongo DB will return every.... line199:See more in the Mongod DB doc. I think "Mongo DB" and "Mongod DB" are supposed to spelled as "MongoDB". Change-Id: Icb72e5e5eb099a839c4ef5aba292a42976144428 Closes-Bug: #1488775 --- doc/source/webapi/v2.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/source/webapi/v2.rst b/doc/source/webapi/v2.rst index 671fbbca83..8dc72ceaf1 100644 --- a/doc/source/webapi/v2.rst +++ b/doc/source/webapi/v2.rst @@ -191,12 +191,12 @@ supported: *=*, *!=*, *<*, *<=*, *>*, *>=* and *in*; and the following logical operators can be used: *and* *or* and *not*. The field names are validated against the database models. See :ref:`api-queries` for how to query the API. -.. note:: The *not* operator has different meaning in Mongo DB and in SQL DB engine. +.. note:: The *not* operator has different meaning in MongoDB and in SQL DB engine. If the *not* operator is applied on a non existent metadata field then the result depends on the DB engine. For example if {"not": {"metadata.nonexistent_field" : "some value"}} filter is used in a query - the Mongo DB will return every Sample object as *not* operator evaluated true - for every Sample where the given field does not exists. See more in the Mongod DB doc. + the MongoDB will return every Sample object as *not* operator evaluated true + for every Sample where the given field does not exists. See more in the MongoDB doc. On the other hand SQL based DB engine will return empty result as the join operation on the metadata table will return zero rows as the on clause of the join which tries to match on the metadata field name is never fulfilled.