ARRAY_CONTAINS_ANY - Bahasa kueri di Cosmos DB (di Azure dan Fabric)

Fungsi ARRAY_CONTAINS_ANY mengembalikan boolean yang menunjukkan apakah array berisi salah satu nilai yang ditentukan.

Syntax

ARRAY_CONTAINS_ANY(<array_expr>, <expr> [, exprN])

Arguments

	Description
array_expr	Ekspresi array.
expr	Ekspresi untuk dicari dalam array.
exprN	Satu atau beberapa ekspresi tambahan untuk dicari dalam array.

Tipe pengembalian

Mengembalikan nilai boolean.

Examples

Bagian ini berisi contoh cara menggunakan konstruksi bahasa kueri ini.

Array berisi contoh apa pun

Dalam contoh ini, ARRAY_CONTAINS_ANY fungsi digunakan untuk memeriksa nilai atau objek tertentu dalam array.

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

[
  {
    "emptyArray": false,
    "matchSingleValue": true,
    "matchesEntireArray": true,
    "matchesSomeValues": true,
    "noMatches": false
  }
]

Nota

Dalam contoh di atas, undefined digunakan sebagai nilai pencarian. Ketika undefined diteruskan sebagai argumen, itu tidak cocok dengan nilai apa pun dalam array. Hanya nilai yang ditentukan secara eksplisit yang dibandingkan.

Komentar

• Fungsi ini tidak menggunakan indeks.