Added a not in the docs on how to handle non-keyword fields

Fixes #59
elastic · Jan 29, 2015 · cbd1376 · cbd1376
1 parent c4691f1
commit cbd1376
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/docs/search_dsl.rst b/docs/search_dsl.rst
@@ -58,6 +58,13 @@ statement:
 
     s = Search().using(client).query("match", title="python")
 
+.. note::
+
+    In some cases this approach is not possible due to python's restriction on
+    identifiers - for example if your field is called ``@timestamp``. In that
+    case you have to fall back to unpacking a dictionary: ``s.query('range', **
+    {'@timestamp': {'lt': 'now'}})``
+
 To send the request to Elasticsearch:
 
 .. code:: python