CONTAINS – Frågespråk i Cosmos DB (i Azure och Fabric)

Funktionen CONTAINS returnerar ett booleskt värde som anger om det första stränguttrycket innehåller det andra stränguttrycket.

Syntax

CONTAINS(<string_expr_1>, <string_expr_2> [, <bool_expr>])

Arguments

Description
string_expr_1 Den första strängen som ska sökas.
string_expr_2 Den andra strängen att hitta.
bool_expr Valfritt booleskt värde för att ignorera skiftläge. När värdet är inställt trueCONTAINS på utför en skiftlägeskänslig sökning. När unspecifiedär det här värdet som standard false.

Returtyper

Returnerar ett booleskt uttryck.

Examples

Det här avsnittet innehåller exempel på hur du använder den här frågespråkkonstruktionen.

Innehåller strängexempel

I det här exemplet CONTAINS används funktionen för att söka efter delsträngar i en sträng.

SELECT VALUE {
  containsPrefix: CONTAINS("AdventureWorks", "Adventure"), 
  containsSuffix: CONTAINS("AdventureWorks", "Works"),
  containsWrongCase: CONTAINS("AdventureWorks", "adventure"), 
  containsWrongCaseValidateCase: CONTAINS("AdventureWorks", "adventure", false), 
  containsWrongCaseIgnoreCase: CONTAINS("AdventureWorks", "works", true),
  containsMismatch: CONTAINS("AdventureWorks", "Contoso")
}
[
  {
    "containsPrefix": true,
    "containsSuffix": true,
    "containsWrongCase": false,
    "containsWrongCaseValidateCase": false,
    "containsWrongCaseIgnoreCase": true,
    "containsMismatch": false
  }
]

Anmärkningar

  • Den här funktionen utför en fullständig genomsökning.