JARO_WINKLER

Author: soyeric128

docs/en/sql-reference/10-sql-commands/00-ddl/04-stream/create-stream.md

@@ -26,7 +26,7 @@ CREATE [ OR REPLACE ] STREAM [ IF NOT EXISTS ] [ <database_name>. ]<stream_name>
 |---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | `< database_name >` | A stream is treated as an object belonging to a specific database, similar to a table or a view. CREATE STREAM allows for different databases between the stream and the associated table. If a database is not explicitly specified, the current database is applied as the database for the stream you create.               |
 | AT                  | When using `AT` followed by `TIMESTAMP =>`or `SNAPSHOT =>` , you can create a stream containing data changes after a specific historical point by the timestamp or snapshot ID; When `AT` is followed by `STREAM =>` , it allows for the creation of a new stream identical to an existing one, preserving the same captured data changes. |
-| APPEND_ONLY         | When set to `true`, the stream operates in `Append-Only` mode; when set to `false`, it operates in `Standard` mode. Defaults to `false`. For additional details on stream operation modes, see [How Stream Works](/guides/load-data/continuous-data-pipelines/stream#how-stream-works).                                        |
+| APPEND_ONLY         | When set to `true`, the stream operates in `Append-Only` mode; when set to `false`, it operates in `Standard` mode. Defaults to `true`. For additional details on stream operation modes, see [How Stream Works](/guides/load-data/continuous-data-pipelines/stream#how-stream-works).                                        |
 
 ## Examples
 

docs/en/sql-reference/20-sql-functions/06-string-functions/index.md

@@ -39,6 +39,7 @@ This section provides reference information for the string-related functions in
 - [ORD](ord.md)
 - [POSITION](position.md)
 - [STRCMP](strcmp.md)
+- [JARO_WINKLER](jaro-winkler.md)
 
 ## Case Conversion:
 - [LCASE](lcase.md)

docs/en/sql-reference/20-sql-functions/06-string-functions/jaro-winkler.md

@@ -0,0 +1,73 @@
+---
+title: JARO_WINKLER
+---
+
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="Introduced or updated: v1.2.675"/>
+
+Calculates the [Jaro-Winkler distance](https://en.wikipedia.org/wiki/Jaro%E2%80%93Winkler_distance) between two strings. It is commonly used for measuring the similarity between strings, with values ranging from 0.0 (completely dissimilar) to 1.0 (identical strings). 
+
+## Syntax
+
+```sql
+JARO_WINKLER(<string1>, <string2>)
+```
+
+## Return Type
+
+The JARO_WINKLER function returns a FLOAT64 value representing the similarity between the two input strings. The return value follows these rules:
+
+- Similarity Range: The result ranges from 0.0 (completely dissimilar) to 1.0 (identical).
+
+    ```sql title='Examples:'
+    SELECT JARO_WINKLER('databend', 'Databend') AS similarity;
+
+    ┌────────────────────┐
+    │     similarity     │
+    ├────────────────────┤
+    │ 0.9166666666666666 │
+    └────────────────────┘
+
+    SELECT JARO_WINKLER('databend', 'database') AS similarity;
+
+    ┌────────────┐
+    │ similarity │
+    ├────────────┤
+    │        0.9 │
+    └────────────┘
+    ```
+- NULL Handling: If either string1 or string2 is NULL, the result is NULL.
+
+    ```sql title='Examples:'
+    SELECT JARO_WINKLER('databend', NULL) AS similarity;
+
+    ┌────────────┐
+    │ similarity │
+    ├────────────┤
+    │ NULL       │
+    └────────────┘
+    ```
+- Empty Strings:
+    - Comparing two empty strings returns 1.0.
+
+    ```sql title='Examples:'
+    SELECT JARO_WINKLER('', '') AS similarity;
+
+    ┌────────────┐
+    │ similarity │
+    ├────────────┤
+    │          1 │
+    └────────────┘
+    ```
+    - Comparing an empty string with a non-empty string returns 0.0.
+
+    ```sql title='Examples:'
+    SELECT JARO_WINKLER('databend', '') AS similarity;
+
+    ┌────────────┐
+    │ similarity │
+    ├────────────┤
+    │          0 │
+    └────────────┘
+    ```