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

La COUNT funzione restituisce il conteggio dei valori nell'espressione.

Sintassi

COUNT(<scalar_expr>)

Arguments

	Description
scalar_expr	Espressione scalare da contare.

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

Conteggio usando un valore scalare e un'espressione

In questo esempio, COUNT viene usato con un valore scalare e un'espressione. Entrambi restituiscono 1.

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

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

Conteggio delle occorrenze di un campo

In questo esempio, la funzione conta il numero di volte in cui si verifica il name campo nei dati filtrati.

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

[
  10
]

Conteggia tutti gli elementi

In questo esempio, la funzione viene usata per contare ogni elemento all'interno di un contenitore che corrisponde al filtro.

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

[
  10
]

Osservazioni:

• Questa funzione trae vantaggio dall'uso di un indice di intervallo per qualsiasi proprietà nel filtro della query. Per altre informazioni, vedere Indici di intervallo.