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

Kata BETWEEN kunci mengevaluasi ke boolean yang menunjukkan apakah nilai target berada di antara dua nilai yang ditentukan, inklusif.

Anda dapat menggunakan kata kunci BETWEEN dengan klausa WHERE untuk mengekspresikan kueri yang memfilter hasil terhadap rentang string atau nilai numerik.

Syntax

<numeric_expr> BETWEEN <numeric_expr_lower_bound> AND <numeric_expr_upper_bound>

Arguments

	Description
numeric_expr	Ekspresi numerik untuk dievaluasi.
numeric_expr_lower_bound	Ekspresi numerik yang menentukan batas bawah rentang yang inklusif.
numeric_expr_upper_bound	Ekspresi numerik yang menentukan batas atas rentang inklusif.

Tipe pengembalian

Mengembalikan nilai boolean.

Examples

Bagian ini berisi contoh cara menggunakan konstruksi bahasa kueri ini.

Pertimbangkan kumpulan sampel dokumen ini dalam Products koleksi untuk contoh-contoh ini.

[
  {
    "name": "Minet Hat",
    "price": 50,
    "detailCategory": "apparel-accessories-beanies"
  },
  {
    "name": "Klinto Hat",
    "price": 65,
    "detailCategory": "apparel-accessories-beanies"
  },
  {
    "name": "Benki Hat",
    "price": 25,
    "detailCategory": "apparel-accessories-beanies"
  },
  {
    "name": "Jontra Hat",
    "price": 40,
    "detailCategory": "apparel-accessories-beanies"
  }
]

Memfilter dalam rentang nilai

Dalam contoh ini, BETWEEN kata kunci digunakan untuk memfilter produk dalam rentang harga tertentu. Rentang ini termasuk batas bawah dan atas.

SELECT VALUE
  p.name
FROM
  products p
WHERE
  (p.price BETWEEN 0 AND 40) AND
  p.detailCategory = "apparel-accessories-beanies"

[
  "Benki Hat",
  "Jontra Hat"
]

Mengevaluasi rentang harga untuk setiap produk

Dalam contoh ini, BETWEEN kata kunci digunakan untuk mengevaluasi apakah harga setiap produk termasuk dalam rentang tertentu dengan menggunakan kata kunci dalam SELECT klausa. Hasilnya mencakup nama produk dan boolean yang menunjukkan apakah harga berada dalam rentang.

SELECT
  p.name,
  (p.price BETWEEN 10 AND 20) AS lowPrice
FROM
  products p
WHERE
  p.detailCategory = "apparel-accessories-beanies"

[
  {
    "name": "Minet Hat",
    "lowPrice": false
  },
  {
    "name": "Klinto Hat",
    "lowPrice": false
  },
  {
    "name": "Benki Hat",
    "lowPrice": false
  },
  {
    "name": "Jontra Hat",
    "lowPrice": false
  }
]