COUNT - Abfragesprache in Cosmos DB (in Azure und Fabric)

Die COUNT Funktion gibt die Anzahl der Werte im Ausdruck zurück.

Syntax

COUNT(<scalar_expr>)

Arguments

Rückgabetypen

Gibt einen numerischen Skalarwert zurück.

Examples

Dieser Abschnitt enthält Beispiele für die Verwendung dieses Abfragesprachenkonstrukts.

Betrachten Sie diesen Beispielsatz von Dokumenten in der Products Sammlung für diese Beispiele.

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

Zählen mithilfe eines skalaren Werts und eines Ausdrucks

In diesem Beispiel wird COUNT mit einem Skalar und einem Ausdruck verwendet. Beide rückgaben 1.

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

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

Zählen von Vorkommen eines Felds

In diesem Beispiel zählt die Funktion, wie oft das name Feld in gefilterten Daten auftritt.

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

[
  10
]

Alle Elemente zählen

In diesem Beispiel wird die Funktion verwendet, um jedes Element in einem Container zu zählen, der dem Filter entspricht.

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

[
  10
]

Bemerkungen

• Diese Funktion profitiert von der Verwendung eines Bereichsindex für alle Eigenschaften im Filter der Abfrage. Weitere Informationen finden Sie unter Bereichsindizes.