SUM - Linguaggio di query in Cosmos DB (in Azure e Fabric)

La SUM funzione calcola la somma dei valori nell'espressione.

Sintassi

SUM(<numeric_expr>)

Arguments

	Description
numeric_expr	Espressione numerica da sommare.

Tipi restituiti

Restituisce un valore scalare numerico.

Esempi

Questa sezione contiene esempi di come usare questo costrutto di linguaggio di query.

Si consideri questo set di documenti di esempio all'interno della Products raccolta per questi esempi.

[
  {
    "name": "Sathem Backpack",
    "quantity": 0,
    "detailCategory": "gear-hike-backpacks"
  },
  {
    "name": "Ventrin Backpack",
    "quantity": 230,
    "detailCategory": "gear-hike-backpacks"
  },
  {
    "name": "Martox Backpack",
    "quantity": 14,
    "detailCategory": "gear-hike-backpacks"
  },
  {
    "name": "Rangeo Backpack",
    "quantity": 232,
    "detailCategory": "gear-hike-backpacks"
  },
  {
    "name": "Moonroq Backpack",
    "quantity": 141,
    "detailCategory": "gear-hike-backpacks"
  }
]

Somma dei valori per una singola proprietà

In questo esempio, la SUM funzione viene usata per sommare i valori della quantity proprietà in un singolo valore aggregato.

SELECT VALUE
  SUM(p.quantity)
FROM
  products p
WHERE
  p.detailCategory = "gear-hike-backpacks"

[
  617
]

Osservazioni:

• Questa funzione trae vantaggio dall'uso di un indice di intervallo. Per altre informazioni, vedere Indici di intervallo.
• Se gli argomenti in SUM sono stringa, booleano o null; l'intera funzione di sistema di aggregazione restituisce undefined.
• Se un singolo argomento ha un undefined valore, tale valore non viene incluso nel SUM calcolo.