Update PPL parse command doc with limitation (opensearch-project#3274) (

opensearch-project#3297) (cherry picked from commit bb732e8) Signed-off-by: Chen Dai <[email protected]> Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Bit-Quill · Feb 5, 2025 · 6fd731b · 6fd731b
1 parent c7b623a
commit 6fd731b
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 ;