共用方式為


CONTAINS - Cosmos DB 中的查詢語言 (在 Azure 和 Fabric 中)

函式會 CONTAINS 傳回布林值,指出第一個字串運算式是否包含第二個字串運算式。

語法

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

Arguments

Description
string_expr_1 要搜尋的第一個字串。
string_expr_2 要尋找的第二個字串。
bool_expr 用於忽略大小寫的選擇性布林值。 當設定為 true時, CONTAINS 會執行不區分大小文字的搜尋。 當 unspecified時,此值預設為 false

傳回類型

傳回布林運算式。

範例

本節包含如何使用此查詢語言建構的範例。

包含字串範例

在此範例中,函數 CONTAINS 用於檢查字串中的子字串。

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

備註

  • 此功能執行完整掃描。