BETWEEN - Langage de requête dans Cosmos DB (dans Azure et Fabric)

Le BETWEEN mot clé prend la valeur booléenne indiquant si la valeur cible est comprise entre deux valeurs spécifiées, inclusives.

Vous pouvez utiliser le mot clé BETWEEN avec une clause WHERE pour exprimer des requêtes qui filtrent les résultats par rapport aux plages de chaînes ou de valeurs numériques.

Syntaxe

<numeric_expr> BETWEEN <numeric_expr_lower_bound> AND <numeric_expr_upper_bound>

Arguments

	Descriptif
numeric_expr	Expression numérique à évaluer.
numeric_expr_lower_bound	Expression numérique qui définit la limite inférieure inclusive de la plage.
numeric_expr_upper_bound	Expression numérique qui définit la limite supérieure inclusive de la plage.

Types de retour

Retourne une valeur booléenne.

Examples

Cette section contient des exemples d’utilisation de cette construction de langage de requête.

Considérez cet exemple de jeu de documents dans la Products collection pour ces exemples.

[
  {
    "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"
  }
]

Filtrer dans une plage de valeurs

Dans cet exemple, le BETWEEN mot clé est utilisé pour filtrer les produits dans une plage de prix spécifique. La plage est inclusive des limites inférieures et supérieures.

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

[
  "Benki Hat",
  "Jontra Hat"
]

Évaluer la plage de prix pour chaque produit

Dans cet exemple, le BETWEEN mot clé est utilisé pour évaluer si le prix de chaque produit se situe dans une plage spécifique à l’aide du mot clé dans la SELECT clause. Le résultat inclut le nom du produit et une valeur booléenne indiquant si le prix se trouve dans la plage.

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