added (#1171)

Author: soyeric128

docs/en/guides/55-performance/03-fulltext-index.md

@@ -62,12 +62,6 @@ REFRESH INVERTED INDEX customer_feedback_idx ON customer_feedback;
 
 Databend offers a range of full-text search functions empowering you to efficiently search through documents. For more information about their syntax and examples, see [Full-Text Search Functions](/sql/sql-functions/search-functions/).
 
-| Full-Text Search Function          | Description                                                     |
-|------------------------------------|-----------------------------------------------------------------|
-| `MATCH('<columns>', '<keywords>')` | Searches for documents containing specified keywords.           |
-| `QUERY('<query_expr>')`            | Searches for documents satisfying a specified query expression. |
-| `SCORE()`                          | Returns the relevance of the query string.                      |
-
 ## Managing Inverted Indexes
 
 Databend provides a variety of commands to manage inverted indexes. For details, see [Inverted Index](/sql/sql-commands/ddl/inverted-index/).
@@ -170,11 +164,9 @@ FROM
 WHERE
   MATCH(event_message, 'PersistentVolume');
 
-┌──────────────────────────────────────────────────┐
-│     event_id    │          event_message         │
-├─────────────────┼────────────────────────────────┤
-│               5 │ PersistentVolume claim created │
-└──────────────────────────────────────────────────┘
+-[ RECORD 1 ]-----------------------------------
+     event_id: 5
+event_message: PersistentVolume claim created
 ```
 
 To check if the full-text index will be utilized for the search, use the [EXPLAIN](/sql/sql-commands/explain-cmds/explain) command:
@@ -194,7 +186,6 @@ Filter
     ├── read size: < 1 KiB
     ├── partitions total: 5
     ├── partitions scanned: 1
-// highlight-next-line
     ├── pruning stats: [segments: <range pruning: 5 to 5>, blocks: <range pruning: 5 to 5, inverted pruning: 5 to 1>]
     ├── push downs: [filters: [k8s_logs._search_matched (#4)], limit: NONE]
     └── estimated rows: 5.00
@@ -217,9 +208,26 @@ WHERE
   SCORE() > 0.5
   AND QUERY('event_message:"PersistentVolume claim created"');
 
-┌─────────────────────────────────────────────────────────────────────────────────────┐
-│     event_id    │          event_message         │   event_timestamp   │   score()  │
-├─────────────────┼────────────────────────────────┼─────────────────────┼────────────┤
-│               5 │ PersistentVolume claim created │ 2024-04-08 12:00:00 │ 0.86304635 │
-└─────────────────────────────────────────────────────────────────────────────────────┘
-```
+-[ RECORD 1 ]-----------------------------------
+       event_id: 5
+  event_message: PersistentVolume claim created
+event_timestamp: 2024-04-08 12:00:00
+        score(): 0.86304635
+```
+
+The following query performs a fuzzy search using the `fuzziness` option:
+
+```sql
+-- 'PersistentVolume claim create' is intentionally misspelled
+SELECT
+    event_id, event_message, event_timestamp
+FROM
+    k8s_logs
+WHERE
+    match('event_message', 'PersistentVolume claim create', 'fuzziness=1');
+
+-[ RECORD 1 ]-----------------------------------
+       event_id: 5
+  event_message: PersistentVolume claim created
+event_timestamp: 2024-04-08 12:00:00
+```

docs/en/sql-reference/20-sql-functions/10-search-functions/match.md

@@ -3,7 +3,7 @@ title: MATCH
 ---
 import FunctionDescription from '@site/src/components/FunctionDescription';
 
-<FunctionDescription description="Introduced or updated: v1.2.425"/>
+<FunctionDescription description="Introduced or updated: v1.2.619"/>
 
 Searches for documents containing specified keywords. Please note that the MATCH function can only be used in a WHERE clause.
 
@@ -14,13 +14,20 @@ Databend's MATCH function is inspired by Elasticsearch's [MATCH](https://www.ela
 ## Syntax
 
 ```sql
-MATCH( '<columns>', '<keywords>' )
+MATCH( '<columns>', '<keywords>'[, '<options>'] )
 ```
 
 | Parameter    | Description                                                                                                                                                                                                                                               |
 |--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | `<columns>`  | A comma-separated list of column names in the table to search for the specified keywords, with optional weighting using the syntax (^), which allows assigning different weights to each column, influencing the importance of each column in the search. |
-| `<keywords>` | The keywords to match against the specified columns in the table.                                                                                                                                                                                         |
+| `<keywords>` | The keywords to match against the specified columns in the table. This parameter can also be used for suffix matching, where the search term followed by an asterisk (*) can match any number of characters or words.                                                                                                                                                                                       |
+| `<options>` | A set of configuration options, separated by semicolons `;`, that customize the search behavior. See the table below for details. |
+
+| Option    | Description                                                                                                                                                                                         | Example                                                                                               | Explanation                                                                                                                                                                                                          |
+|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| fuzziness | Allows matching terms within a specified Levenshtein distance. `fuzziness` can be set to 1 or 2.                                                                                                    | SELECT id, score(), content FROM t WHERE match(content, 'box', 'fuzziness=1');                       | When matching the query term "box", `fuzziness=1` allows matching terms like "fox", since "box" and "fox" have a Levenshtein distance of 1.                                                                          |
+| operator  | Specifies how multiple query terms are combined. Can be set to OR (default) or AND. OR returns results containing any of the query terms, while AND returns results containing all query terms.     | SELECT id, score(), content FROM t WHERE match(content, 'action works', 'fuzziness=1;operator=AND'); | With `operator=AND`, the query requires both "action" and "works" to be present in the results. Due to `fuzziness=1`, it matches terms like "Actions" and "words", so "Actions speak louder than words" is returned. |
+| lenient   | Controls whether errors are reported when the query text is invalid. Defaults to `false`. If set to `true`, no error is reported, and an empty result set is returned if the query text is invalid. | SELECT id, score(), content FROM t WHERE match(content, '()', 'lenient=true');                       | If the query text `()` is invalid, setting `lenient=true` prevents an error from being thrown and returns an empty result set instead.                                                                               |
 
 ## Examples
 
@@ -46,6 +53,20 @@ SELECT * FROM test WHERE MATCH('title', 'art power');
 │ The Art of Communication  │ Effective communication is crucial in everyday life.                   │
 └────────────────────────────────────────────────────────────────────────────────────────────────────┘
 
+-- Retrieve documents where the 'title' column contains values that start with 'The' followed by any characters
+SELECT * FROM test WHERE MATCH('title', 'The*')
+
+┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
+│                title                │                                      body                                      │
+│           Nullable(String)          │                                Nullable(String)                                │
+├─────────────────────────────────────┼────────────────────────────────────────────────────────────────────────────────┤
+│ The Importance of Reading           │ Reading is a crucial skill that opens up a world of knowledge and imagination. │
+│ The Benefits of Exercise            │ Exercise is essential for maintaining a healthy lifestyle.                     │
+│ The Power of Perseverance           │ Perseverance is the key to overcoming obstacles and achieving success.         │
+│ The Art of Communication            │ Effective communication is crucial in everyday life.                           │
+│ The Impact of Technology on Society │ Technology has revolutionized our society in countless ways.                   │
+└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
+
 -- Retrieve documents where either the 'title' or 'body' column matches 'knowledge technology'
 SELECT *, score() FROM test WHERE MATCH('title, body', 'knowledge technology');
 
@@ -65,4 +86,11 @@ SELECT *, score() FROM test WHERE MATCH('title^5, body^1.2', 'knowledge technolo
 │ The Importance of Reading           │ Reading is a crucial skill that opens up a world of knowledge and imagination. │ 1.3860708 │
 │ The Impact of Technology on Society │ Technology has revolutionized our society in countless ways.                   │ 7.8053584 │
 └──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
+
+-- Retrieve documents where the 'body' column contains both "knowledge" and "imagination" (allowing for minor typos).
+SELECT * FROM test WHERE MATCH('body', 'knowledg imaginatio', 'fuzziness = 1; operator = AND');
+
+-[ RECORD 1 ]-----------------------------------
+title: The Importance of Reading
+ body: Reading is a crucial skill that opens up a world of knowledge and imagination.
 ```