Add more examples to the where command doc (#4457)

Co-authored-by: Manasvini B S <[email protected]>

Author: ahkcs

docs/user/ppl/cmd/where.rst

@@ -10,18 +10,21 @@ where
 
 
 Description
-============
+===========
 | The ``where`` command bool-expression to filter the search result. The ``where`` command only return the result when bool-expression evaluated to true.
 
 
 Syntax
-============
+======
 where <boolean-expression>
 
 * bool-expression: optional. any expression which could be evaluated to boolean value.
 
+Examples
+========
+
 Example 1: Filter result set with condition
-===========================================
+--------------------------------------------
 
 The example show fetch all the document from accounts index with .
 
@@ -36,3 +39,131 @@ PPL query::
     | 13             | F      |
     +----------------+--------+
 
+Example 2: Basic Field Comparison
+----------------------------------
+
+The example shows how to filter accounts with balance greater than 30000.
+
+PPL query::
+
+    os> source=accounts | where balance > 30000 | fields account_number, balance;
+    fetched rows / total rows = 2/2
+    +----------------+---------+
+    | account_number | balance |
+    |----------------+---------|
+    | 1              | 39225   |
+    | 13             | 32838   |
+    +----------------+---------+
+
+Example 3: Pattern Matching with LIKE
+--------------------------------------
+
+Pattern Matching with Underscore (_)
+
+The example demonstrates using LIKE with underscore (_) to match a single character.
+
+PPL query::
+
+    os> source=accounts | where LIKE(state, 'M_') | fields account_number, state;
+    fetched rows / total rows = 1/1
+    +----------------+-------+
+    | account_number | state |
+    |----------------+-------|
+    | 18             | MD    |
+    +----------------+-------+
+
+Pattern Matching with Percent (%)
+
+The example demonstrates using LIKE with percent (%) to match multiple characters.
+
+PPL query::
+
+    os> source=accounts | where LIKE(state, 'V%') | fields account_number, state;
+    fetched rows / total rows = 1/1
+    +----------------+-------+
+    | account_number | state |
+    |----------------+-------|
+    | 13             | VA    |
+    +----------------+-------+
+
+Example 4: Multiple Conditions
+-------------------------------
+
+The example shows how to combine multiple conditions using AND operator.
+
+PPL query::
+
+    os> source=accounts | where age > 30 AND gender = 'M' | fields account_number, age, gender;
+    fetched rows / total rows = 3/3
+    +----------------+-----+--------+
+    | account_number | age | gender |
+    |----------------+-----+--------|
+    | 1              | 32  | M      |
+    | 6              | 36  | M      |
+    | 18             | 33  | M      |
+    +----------------+-----+--------+
+
+Example 5: Using IN Operator
+-----------------------------
+
+The example demonstrates using IN operator to match multiple values.
+
+PPL query::
+
+    os> source=accounts | where state IN ('IL', 'VA') | fields account_number, state;
+    fetched rows / total rows = 2/2
+    +----------------+-------+
+    | account_number | state |
+    |----------------+-------|
+    | 1              | IL    |
+    | 13             | VA    |
+    +----------------+-------+
+
+Example 6: NULL Checks
+----------------------
+
+The example shows how to filter records with NULL values.
+
+PPL query::
+
+   os> source=accounts | where ISNULL(employer) | fields account_number, employer;
+   fetched rows / total rows = 1/1
+   +----------------+----------+
+   | account_number | employer |
+   |----------------+----------|
+   | 18             | null     |
+   +----------------+----------+
+
+Example 7: Complex Conditions
+------------------------------
+
+The example demonstrates combining multiple conditions with parentheses and logical operators.
+
+PPL query::
+
+    os> source=accounts | where (balance > 40000 OR age > 35) AND gender = 'M' | fields account_number, balance, age, gender;
+    fetched rows / total rows = 1/1
+    +----------------+---------+-----+--------+
+    | account_number | balance | age | gender |
+    |----------------+---------+-----+--------|
+    | 6              | 5686    | 36  | M      |
+    +----------------+---------+-----+--------+
+
+Example 8: NOT Conditions
+--------------------------
+
+The example shows how to use NOT operator to exclude matching records.
+
+PPL query::
+
+    os> source=accounts | where NOT state = 'CA' | fields account_number, state;
+    fetched rows / total rows = 4/4
+    +----------------+-------+
+    | account_number | state |
+    |----------------+-------|
+    | 1              | IL    |
+    | 6              | TN    |
+    | 13             | VA    |
+    | 18             | MD    |
+    +----------------+-------+
+