Merge pull request #115867 from timsander1/master

add case insensitive system functions

Author: v-albemi

articles/cosmos-db/index-overview.md

@@ -93,7 +93,11 @@ Azure Cosmos DB currently supports three kinds of indexes.
    SELECT * FROM c WHERE IS_DEFINED(c.property)
    ```
 
-- String prefix matches (CONTAINS keyword will not leverage the range index):
+- String system functions:
+
+   ```sql
+   SELECT * FROM c WHERE CONTAINS(c.property, "value")
+   ```
 
    ```sql
    SELECT * FROM c WHERE STARTSWITH(c.property, "value")

articles/cosmos-db/sql-query-contains.md

@@ -4,17 +4,18 @@ description: Learn about how the CONTAINS SQL system function in Azure Cosmos DB
 author: ginamr
 ms.service: cosmos-db
 ms.topic: conceptual
-ms.date: 03/03/2020
+ms.date: 05/20/2020
 ms.author: girobins
 ms.custom: query-reference
 ---
 # CONTAINS (Azure Cosmos DB)
+
  Returns a Boolean indicating whether the first string expression contains the second.  
 
 ## Syntax
 
 ```sql
-CONTAINS(<str_expr1>, <str_expr2>)  
+CONTAINS(<str_expr1>, <str_expr2> [, <bool_expr>])  
 ```  
 
 ## Arguments
@@ -24,6 +25,9 @@ CONTAINS(<str_expr1>, <str_expr2>)
 
 *str_expr2*  
    Is the string expression to find.  
+
+*bool_expr*
+    Optional value for ignoring case. When set to true, CONTAINS will do a case-insensitive search. When unspecified, this value is false.
 
 ## Return types
 
@@ -34,7 +38,7 @@ CONTAINS(<str_expr1>, <str_expr2>)
   The following example checks if "abc" contains "ab" and if "abc" contains "d".  
 
 ```sql
-SELECT CONTAINS("abc", "ab") AS c1, CONTAINS("abc", "d") AS c2 
+SELECT CONTAINS("abc", "ab") AS c1, CONTAINS("abc", "d") AS c2
 ```  
 
  Here is the result set.  
@@ -45,7 +49,7 @@ SELECT CONTAINS("abc", "ab") AS c1, CONTAINS("abc", "d") AS c2
 
 ## Remarks
 
-This system function will not utilize the index.
+This system function will benefit from a [range index](index-policy.md#includeexclude-strategy).
 
 ## Next steps
 

articles/cosmos-db/sql-query-endswith.md

@@ -4,17 +4,18 @@ description: Learn about the ENDSWITH SQL system function in Azure Cosmos DB to
 author: ginamr
 ms.service: cosmos-db
 ms.topic: conceptual
-ms.date: 03/03/2020
+ms.date: 05/20/2020
 ms.author: girobins
 ms.custom: query-reference
 ---
 # ENDSWITH (Azure Cosmos DB)
+
  Returns a Boolean indicating whether the first string expression ends with the second.  
 
 ## Syntax
 
 ```sql
-ENDSWITH(<str_expr1>, <str_expr2>)  
+ENDSWITH(<str_expr1>, <str_expr2> [, <bool_expr>])
 ```  
 
 ## Arguments
@@ -23,7 +24,10 @@ ENDSWITH(<str_expr1>, <str_expr2>)
    Is a string expression.  
 
 *str_expr2*  
-   Is a string expression to be compared to the end of *str_expr1*.  
+   Is a string expression to be compared to the end of *str_expr1*.
+
+*bool_expr*
+    Optional value for ignoring case. When set to true, ENDSWITH will do a case-insensitive search. When unspecified, this value is false.
 
 ## Return types
 
@@ -45,7 +49,7 @@ SELECT ENDSWITH("abc", "b") AS e1, ENDSWITH("abc", "bc") AS e2
 
 ## Remarks
 
-This system function will not utilize the index.
+This system function will benefit from a [range index](index-policy.md#includeexclude-strategy).
 
 ## Next steps
 

articles/cosmos-db/sql-query-startswith.md

@@ -4,17 +4,18 @@ description: Learn about SQL system function STARTSWITH in Azure Cosmos DB.
 author: ginamr
 ms.service: cosmos-db
 ms.topic: conceptual
-ms.date: 09/13/2019
+ms.date: 05/20/2020
 ms.author: girobins
 ms.custom: query-reference
 ---
 # STARTSWITH (Azure Cosmos DB)
+
  Returns a Boolean indicating whether the first string expression starts with the second.  
 
 ## Syntax
 
 ```sql
-STARTSWITH(<str_expr1>, <str_expr2>)  
+STARTSWITH(<str_expr1>, <str_expr2> [, <bool_expr>])  
 ```  
 
 ## Arguments
@@ -25,6 +26,9 @@ STARTSWITH(<str_expr1>, <str_expr2>)
 *str_expr2*  
    Is a string expression to be compared to the beginning of *str_expr1*.
 
+*bool_expr*
+    Optional value for ignoring case. When set to true, STARTSWITH will do a case-insensitive search. When unspecified, this value is false.
+
 ## Return types
 
   Returns a Boolean expression.  

articles/cosmos-db/troubleshoot-query-performance.md

@@ -194,15 +194,15 @@ If an expression can be translated into a range of string values, it can use the
 
 Here's the list of some common string functions that can use the index:
 
-- STARTSWITH(str_expr, str_expr)
+- STARTSWITH(str_expr1, str_expr2, bool_expr)  
+- CONTAINS(str_expr, str_expr, bool_expr)
 - LEFT(str_expr, num_expr) = str_expr
 - SUBSTRING(str_expr, num_expr, num_expr) = str_expr, but only if the first num_expr is 0
 
 Following are some common system functions that don't use the index and must load each document:
 
 | **System function**                     | **Ideas   for optimization**             |
 | --------------------------------------- |------------------------------------------------------------ |
-| CONTAINS                                | Use Azure Search for full-text search.                        |
 | UPPER/LOWER                             | Instead of using the system function to normalize data for comparisons, normalize the casing upon insertion. A query like ```SELECT * FROM c WHERE UPPER(c.name) = 'BOB'``` becomes ```SELECT * FROM c WHERE c.name = 'BOB'```. |
 | Mathematical functions (non-aggregates) | If you need to compute a value frequently in your query, consider storing the value as a property in your JSON document. |