Update PPL parse command doc with limitation (#3274)

* Update PPL parse command doc with limitation Signed-off-by: Chen Dai <[email protected]> * Address comments Signed-off-by: Chen Dai <[email protected]> * Fixed example Signed-off-by: Chen Dai <[email protected]> --------- Signed-off-by: Chen Dai <[email protected]>
opensearch-project · Feb 4, 2025 · bb732e8 · bb732e8
1 parent a2cb2a3
commit bb732e8
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/docs/user/ppl/cmd/parse.rst b/docs/user/ppl/cmd/parse.rst
@@ -108,3 +108,9 @@ There are a few limitations with parse command:
   ``where`` in the following command will not work::
 
     source=accounts | parse email '.+@(?<host>.+)' | stats avg(age) by host | where host=pyrami.com ;
+
+- Fields defined by parse will not appear in the final result unless the original source field is included in the ``fields`` command.
+
+  For example, the following query will not display the parsed fields ``host`` unless the source field ``email`` is also explicitly included::
+
+    source=accounts | parse email '.+@(?<host>.+)' | fields email, host ;