CONTAINS - Abfragesprache in Cosmos DB (in Azure und Fabric)

Die CONTAINS Funktion gibt einen booleschen Wert zurück, der angibt, ob der erste Zeichenfolgenausdruck den zweiten Zeichenfolgenausdruck enthält.

Syntax

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

Arguments

	Description
string_expr_1	Die erste zu durchsuchende Zeichenfolge.
string_expr_2	Die zweite zu suchende Zeichenfolge.
bool_expr	Optionaler boolescher Wert für das Ignorieren von Groß-/Kleinschreibung. Bei Festlegung auf true, CONTAINS führt eine Suche ohne Groß-/Kleinschreibung durch. When unspecified, this value defaults to false.

Rückgabetypen

Gibt einen booleschen Ausdruck zurück.

Examples

Dieser Abschnitt enthält Beispiele für die Verwendung dieses Abfragesprachenkonstrukts.

Enthält Zeichenfolgenbeispiele

In diesem Beispiel wird die CONTAINS Funktion verwendet, um nach Teilzeichenfolgen in einer Zeichenfolge zu suchen.

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
  }
]

Bemerkungen

• Diese Funktion führt einen vollständigen Scan durch.