COUNT – Frågespråk i Cosmos DB (i Azure och Fabric)

Funktionen COUNT returnerar antalet värden i uttrycket.

Syntax

COUNT(<scalar_expr>)

Arguments

	Description
scalar_expr	Ett skalärt uttryck att räkna.

Returtyper

Returnerar ett numeriskt skalärt värde.

Examples

Det här avsnittet innehåller exempel på hur du använder den här frågespråkkonstruktionen.

Överväg den här exempeluppsättningen med dokument i Products samlingen för dessa exempel.

[
  {
    "name": "Kameni Adult Bike Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Rockmak Full Face Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Barea Skateboard Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Cranix Full Face Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Furano Adult Bike Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Prigla Adult Bike Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Menitos Skateboard Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Knimer Adult Bike Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Cranix Bike Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Jeropa Adult Bike Helmet",
    "detailCategory": "gear-cycle-helmets"
  }
]

Räkna med ett skalärt värde och ett uttryck

I det här exemplet används COUNT med en skalär och ett uttryck. Båda returnerar 1.

SELECT VALUE {
  countScalar: COUNT(1),
  countExpression: COUNT(2 + 3)
}

[
  {
    "countScalar": 1,
    "countExpression": 1
  }
]

Antal förekomster av ett fält

I det här exemplet räknar funktionen antalet gånger fältet name inträffar i filtrerade data.

SELECT VALUE
  COUNT(p.name)
FROM
  products p
WHERE
  p.detailCategory = "gear-cycle-helmets"

[
  10
]

Räkna alla objekt

I det här exemplet används funktionen för att räkna varje objekt i en container som matchar filtret.

SELECT VALUE
  COUNT(1)
FROM
  products p
WHERE
  p.detailCategory = "gear-cycle-helmets"

[
  10
]

Anmärkningar

• Den här funktionen drar nytta av användningen av ett intervallindex för alla egenskaper i frågans filter. Mer information finns i intervallindex.