BETWEEN - Linguagem de consulta no Cosmos DB (no Azure e no Fabric)

A BETWEEN palavra-chave é avaliada como um booleano indicando se o valor de destino está entre dois valores especificados, inclusive.

Você pode usar a palavra-chave BETWEEN com uma cláusula WHERE para expressar consultas que filtram os resultados em relação a intervalos de cadeia de caracteres ou valores numéricos.

Sintaxe

<numeric_expr> BETWEEN <numeric_expr_lower_bound> AND <numeric_expr_upper_bound>

Arguments

	Description
numeric_expr	Uma expressão numérica para avaliar.
numeric_expr_lower_bound	Uma expressão numérica que define o limite inferior inclusivo do intervalo.
numeric_expr_upper_bound	Uma expressão numérica que define o limite superior inclusivo do intervalo.

Tipos de devolução

Retorna um valor booleano.

Examples

Esta seção contém exemplos de como usar essa construção de linguagem de consulta.

Considere este conjunto de exemplos de documentos dentro da Products coleção para esses exemplos.

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

Filtrar dentro de um intervalo de valores

Neste exemplo, a BETWEEN palavra-chave é usada para filtrar produtos dentro de uma faixa de preço específica. O intervalo inclui os limites inferior e superior.

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

[
  "Benki Hat",
  "Jontra Hat"
]

Avaliar a faixa de preço de cada produto

Neste exemplo, a BETWEEN palavra-chave é usada para avaliar se o preço de cada produto está dentro de um intervalo específico usando a palavra-chave na SELECT cláusula. O resultado inclui o nome do produto e um booleano indicando se o preço está dentro do intervalo.

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