COUNT - Cosmos DB のクエリ言語 (Azure と Fabric)

COUNT関数は、式内の値の数を返します。

構文

COUNT(<scalar_expr>)

論争

	Description
scalar_expr	カウントするスカラー式。

戻り値の型

数値スカラー値を返します。

例示

このセクションでは、このクエリ言語コンストラクトを使用する方法の例を示します。

次の例では、 Products コレクション内のドキュメントのサンプル セットについて考えてみましょう。

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

スカラー値と式を使用してカウントする

この例では、COUNT はスカラーと式と共に使用されます。 両方とも 1を返します。

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

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

フィールドの出現回数をカウントする

この例では、フィルター処理されたデータで name フィールドが出現する回数をカウントします。

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

[
  10
]

すべてのアイテムをカウントする

この例では、この関数を使用して、フィルターに一致するコンテナー内のすべての項目をカウントします。

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

[
  10
]

注釈

• この関数は、クエリのフィルター内のプロパティに範囲インデックスを使用する利点があります。 詳細については、「 範囲インデックス」を参照してください。