Merge pull request #283731 from seesharprun/cosmos-new-nosql-query-functions

Cosmos DB | New NoSQL query functions

Author: Jill Grant

articles/cosmos-db/nosql/query/TOC.yml

@@ -65,6 +65,11 @@
     - name: Bitwise operators
       displayName: bitwise, binary, operators
       href: bitwise-operators.md
+- name: Vector functions
+  items:
+    - name: VectorDistance
+      displayName: vector, distance, AI
+      href: vectordistance.md
 - name: Aggregate functions
   items:
     - name: AVG
@@ -73,10 +78,10 @@
     - name: COUNT
       displayName: functions, aggregate, count
       href: count.md
-    - name: MAX
+    - name: Maximum
       displayName: functions, aggregate, max, maximum
       href: max.md
-    - name: MIN
+    - name: Minimum
       displayName: functions, aggregate, min, minimum
       href: min.md
     - name: SUM
@@ -90,16 +95,22 @@
     - name: Array functions
       items:
         - name: ARRAY_CONCAT
-          displayName: ARRAY_CONCAT, array concat, array functions
+          displayName: ARRAY_CONCAT, concat, array concat, array functions
           href: array-concat.md
         - name: ARRAY_CONTAINS
-          displayName: ARRAY_CONTAINS, array contains, array functions
+          displayName: ARRAY_CONTAINS, contains, array contains, array functions
           href: array-contains.md
+        - name: ARRAY_CONTAINS_ANY
+          displayName: ARRAY_CONTAINS_ANY, contains, array contains, array contains any, any, array functions
+          href: array-contains-any.md
+        - name: ARRAY_CONTAINS_ALL
+          displayName: ARRAY_CONTAINS_ALL, contains, array contains, array contains all, all, array functions
+          href: array-contains-all.md
         - name: ARRAY_LENGTH
-          displayName: ARRAY_LENGTH, array length, array functions
+          displayName: ARRAY_LENGTH, length, array length, array functions
           href: array-length.md
         - name: ARRAY_SLICE
-          displayName: ARRAY_SLICE, array slice, array functions
+          displayName: ARRAY_SLICE, slice, array slice, array functions
           href: array-slice.md
         - name: CHOOSE
           displayName: CHOOSE, choose, choose index, select item, array functions
@@ -115,7 +126,7 @@
           href: setunion.md
     - name: Conditional functions
       items:
-        - name: IIF
+        - name: Ternary conditional
           displayName: IIF, ternary, ternary conditional operator
           href: iif.md
     - name: Date and time functions
@@ -365,6 +376,12 @@
         - name: StringToObject
           displayName: StringToObject, string to object, built-in functions
           href: stringtoobject.md
+        - name: StringJoin
+          displayName: StringJoin, string join, built-in functions
+          href: stringjoin.md
+        - name: StringSplit
+          displayName: StringSplit, string split, built-in functions
+          href: stringsplit.md
         - name: SUBSTRING
           displayName: SUBSTRING, built-in functions
           href: substring.md
@@ -421,6 +438,6 @@
 - name: Pagination
   displayName: continuation tokens, paging, pagination
   href: pagination.md
-- name: LINQ to NoSQL
+- name: Linq to NoSQL
   displayName: linq, .NET
   href: linq-to-sql.md

articles/cosmos-db/nosql/query/array-contains-all.md

@@ -0,0 +1,74 @@
+---
+title: ARRAY_CONTAINS_ALL
+titleSuffix: Azure Cosmos DB for NoSQL
+description: An Azure Cosmos DB for NoSQL system function that returns a boolean indicating whether the array contains all of the specified values.
+author: seesharprun
+ms.author: sidandrews
+ms.reviewer: jacodel
+ms.service: azure-cosmos-db
+ms.subservice: nosql
+ms.topic: reference
+ms.devlang: nosql
+ms.date: 08/06/2024
+ms.custom: query-reference
+---
+
+# ARRAY_CONTAINS_ALL (NoSQL query)
+
+[!INCLUDE[NoSQL](../../includes/appliesto-nosql.md)]
+
+Returns a boolean value indicates if the first array contains all the following elements.
+
+## Syntax
+
+```nosql
+ARRAY_CONTAINS_ALL(<array_expr>, <expr> [, exprN])
+```
+
+## Arguments
+
+| | Description |
+| --- | --- |
+| **`array_expr`** | An array expression. |
+| **`expr`** | Expression to search for within the array. |
+| **`exprN`** (Optional) | One or more extra expressions to to search for within the array. |
+
+## Return types
+  
+Returns a boolean value.
+
+## Examples
+  
+The following example illustrates how to check for specific values or objects in an array using this function.  
+
+```nosql
+SELECT VALUE {
+  matchesEntireArray: ARRAY_CONTAINS_ALL([1, true, "3", [1,2,3]], 1, true, "3", [1,2,3]),
+  matchesSomeValues: ARRAY_CONTAINS_ALL([1, 2, 3, 4], 2, 3, 4, 5),
+  matchSingleValue: ARRAY_CONTAINS_ALL([1, 2, 3, 4], 1, undefined),
+  noMatches: ARRAY_CONTAINS_ALL([1, 2, 3, 4], 5, 6, 7, 8),
+  emptyArray: ARRAY_CONTAINS_ALL([], 1, 2, 3),
+  noMatchesUndefined: ARRAY_CONTAINS_ALL([1, 2, 3, 4], 5, undefined)
+}
+```
+
+```json
+[
+  {
+    "matchesEntireArray": true,
+    "matchesSomeValues": false,
+    "noMatches": false,
+    "emptyArray": false,
+    "noMatchesUndefined": false
+  }
+]
+```
+
+## Remarks
+
+- This system function doesn't utilize the index.
+
+## Related content
+
+- [`ARRAY_CONTAINS`](array-contains.md)
+- [`ARRAY_CONTAINS_ANY`](array-contains-any.md)

articles/cosmos-db/nosql/query/array-contains-any.md

@@ -0,0 +1,74 @@
+---
+title: ARRAY_CONTAINS_ANY
+titleSuffix: Azure Cosmos DB for NoSQL
+description: An Azure Cosmos DB for NoSQL system function that returns a boolean indicating whether the array contains any of the specified values.
+author: seesharprun
+ms.author: sidandrews
+ms.reviewer: jacodel
+ms.service: azure-cosmos-db
+ms.subservice: nosql
+ms.topic: reference
+ms.devlang: nosql
+ms.date: 08/06/2024
+ms.custom: query-reference
+---
+
+# ARRAY_CONTAINS_ANY (NoSQL query)
+
+[!INCLUDE[NoSQL](../../includes/appliesto-nosql.md)]
+
+Returns a boolean value indicates if the first array contains any of the following elements.
+
+## Syntax
+
+```nosql
+ARRAY_CONTAINS_ANY(<array_expr>, <expr> [, exprN])
+```
+
+## Arguments
+
+| | Description |
+| --- | --- |
+| **`array_expr`** | An array expression. |
+| **`expr`** | Expression to search for within the array. |
+| **`exprN`** (Optional) | One or more extra expressions to to search for within the array. |
+
+## Return types
+  
+Returns a boolean value.
+
+## Examples
+  
+The following example illustrates how to check for specific values or objects in an array using this function.  
+
+```nosql
+SELECT VALUE {
+  matchesEntireArray: ARRAY_CONTAINS_ANY([1, true, "3", [1,2,3]], 1, true, "3", [1,2,3]),
+  matchesSomeValues: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 2, 3, 4, 5),
+  matchSingleValue: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 1, undefined),
+  noMatches: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 5, 6, 7, 8),
+  emptyArray: ARRAY_CONTAINS_ANY([], 1, 2, 3),
+  noMatchesUndefined: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 5, undefined)
+}
+```
+
+```json
+[
+  {
+    "matchesEntireArray": true,
+    "matchesSomeValues": true,
+    "matchSingleValue": true,
+    "noMatches": false,
+    "emptyArray": false
+  }
+]
+```
+
+## Remarks
+
+- This system function doesn't utilize the index.
+
+## Related content
+
+- [`ARRAY_CONTAINS`](array-contains.md)
+- [`ARRAY_CONTAINS_ALL`](array-contains-all.md)

articles/cosmos-db/nosql/query/array-contains.md

@@ -1,7 +1,7 @@
 ---
 title: ARRAY_CONTAINS
 titleSuffix: Azure Cosmos DB for NoSQL
-description: An Azure Cosmos DB for NoSQL system function that returns a boolean indicating whether the array contains the specified value
+description: An Azure Cosmos DB for NoSQL system function that returns a boolean indicating whether the array contains the specified value.
 author: jcodella
 ms.author: jacodel
 ms.reviewer: sidandrews
@@ -26,13 +26,13 @@ ARRAY_CONTAINS(<array_expr>, <expr> [, <bool_expr>])
 ```  
 
 ## Arguments
-  
+
 | | Description |
 | --- | --- |
 | **`arr_expr`** | An array expression. |
 | **`expr`** | Expression to search for within the array. |
 | **`bool_expr`** | A boolean expression indicating whether the search should check for a partial match (`true`) or a full match (`false`). If not specified, the default value is `false`. |
-  
+
 ## Return types
 
 Returns a boolean value.  

articles/cosmos-db/nosql/query/index.yml

@@ -1,12 +1,12 @@
 ### YamlMime:Landing
 
 title: Queries in Azure Cosmos DB for NoSQL
-summary: Azure Cosmos DB for NoSQL provides the ability to query data by writing queries using the Structured Query Language (SQL) as a JSON query language.
+summary: Azure Cosmos DB for NoSQL has the ability to query data by writing queries using the Structured Query Language (SQL) as a JSON query language.
 
 metadata:
   title: NoSQL queries
   titleSuffix: Azure Cosmos DB for NoSQL
-  description: Azure Cosmos DB for NoSQL provides the ability to query data by writing queries using the Structured Query Language (SQL) as a JSON query language.
+  description: Azure Cosmos DB for NoSQL has the ability to query data by writing queries using the Structured Query Language (SQL) as a JSON query language.
   author: jcodella
   ms.author: jacodel
   ms.reviewer: sidandrews
@@ -30,6 +30,12 @@ landingContent:
             url: keywords.md
           - text: Constants
             url: constants.md
+  - title: Vector functions
+    linkLists:
+      - linkListType: reference
+        links:
+          - text: VectorDistance
+            url: vectordistance.md
   - title: Aggregate functions
     linkLists:
       - linkListType: reference
@@ -38,9 +44,9 @@ landingContent:
             url: average.md
           - text: COUNT
             url: count.md
-          - text: MAX
+          - text: Maximum
             url: max.md
-          - text: MIN
+          - text: Minimum
             url: min.md
           - text: SUM
             url: sum.md
@@ -52,6 +58,10 @@ landingContent:
             url: array-concat.md
           - text: ARRAY_CONTAINS
             url: array-contains.md
+          - text: ARRAY_CONTAINS_ANY
+            url: array-contains-any.md
+          - text: ARRAY_CONTAINS_ALL
+            url: array-contains-all.md
           - text: ARRAY_LENGTH
             url: array-length.md
           - text: ARRAY_SLICE
@@ -65,7 +75,7 @@ landingContent:
           - text: GetCurrentTicks
             url: getcurrentticks.md
           - text: GetCurrentTimestamp
-            url: getcurrenttimestamp.md  
+            url: getcurrenttimestamp.md
   - title: Mathematical functions
     linkLists:
       - linkListType: reference
@@ -75,4 +85,4 @@ landingContent:
           - text: EXP
             url: exp.md
           - text: SIN
-            url: sin.md
+            url: sin.md

articles/cosmos-db/nosql/query/stringequals.md

@@ -9,7 +9,7 @@ ms.service: azure-cosmos-db
 ms.subservice: nosql
 ms.topic: reference
 ms.devlang: nosql
-ms.date: 02/27/2024
+ms.date: 08/06/2024
 ms.custom: query-reference
 ---
 
@@ -22,7 +22,7 @@ Returns a boolean indicating whether the first string expression matches the sec
 ## Syntax
 
 ```nosql
-STRINGEQUALS(<string_expr_1>, <string_expr_2> [, <boolean_expr>])  
+StringEquals(<string_expr_1>, <string_expr_2> [, <boolean_expr>])  
 ```
 
 ## Arguments
@@ -39,7 +39,7 @@ Returns a boolean expression.
 
 ## Examples
 
-The following example checks if "abc" matches "abc" and if "abc" matches "ABC."
+The following example checks if `abc` matches `abc` and if `abc` matches `ABC`.
 
 :::code language="nosql" source="~/cosmos-db-nosql-query-samples/scripts/stringequals/query.sql" highlight="2-4":::