$match（集計）

定義

$match: 指定されたクエリ述語に基づいてドキュメントをフィルタリングします。一致したドキュメントは、次のパイプラインステージに渡されます。

互換性

次の環境でホストされる配置には $match を使用できます。

MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージドサービスです

MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

構文

{ $match: { <query predicate> } }

クエリ述語の構文は、$match コマンドのクエリ find()引数で使用される構文と同じです。

動作

パイプラインの最適化

$matchを集計パイプラインのできるだけ早く配置します。 $matchは集計パイプライン内のドキュメントの合計数を制限するため、以前の$match操作はパイプを下降する処理量を最小限に抑えます。
パイプラインの先頭に $match を配置すると、クエリは他の db.collection.find() や db.collection.findOne() と同様にインデックスを利用できます。

クエリ述語の式

クエリ述語に式を含めるには、 $expr演算子を使用します。

0 、NULL、false、または欠損値

次のいずれかの条件に当てはまる場合、$match ステージはパイプラインの結果からドキュメントをフィルタリングで除外します。

$match クエリ述語は、そのドキュメントの 0 、 null 、または false の値を返します。
$matchクエリ述語は、そのドキュメントには欠落しているフィールドを使用します。

制限事項

$matchステージでは$whereは使用できません。
$matchステージでは$nearまたは$nearSphereは使用できません。あるいは、次のいずれかを実行できます。
- $geoNearステージではなく$match ステージを使用します。
- $matchステージで$centerまたは$centerSphereとともに$geoWithinクエリ述語演算子を使用します。
$text$matchステージでを使用するには、$match ステージがパイプラインの最初のステージである必要があります。
ビューは$textをサポートしていません。
注意
$text は、自己管理型（Atlas 以外）配置に対するテキストクエリ機能を提供します。MongoDB Atlas でホストされているデータに対して、MongoDB は改良された全文クエリソリューションである Atlas Search を提供します。

Atlas Search を使用した Atlas のデータのフィルタリング

MongoDB Atlasに保存されているデータでは、Atlas Search 複合演算子演算子filter $searchオプションを使用して、クエリを実行中中にドキュメントを一致またはフィルタリングできます。の後に$match $searchを実行する方法は、$search 複合演算子演算子filter オプションを使用してを実行中方法よりパフォーマンスが低くなります。

オプションの詳細については、Atlas filterドキュメントの「複合演算子」を参照してください。

例

例では、次のドキュメントを含む articles という名前のコレクションを使用します。

{ "_id" : ObjectId("512bc95fe835e68f199c8686"), "author" : "dave", "score" : 80, "views" : 100 }
{ "_id" : ObjectId("512bc962e835e68f199c8687"), "author" : "dave", "score" : 85, "views" : 521 }
{ "_id" : ObjectId("55f5a192d4bede9ac365b257"), "author" : "ahn", "score" : 60, "views" : 1000 }
{ "_id" : ObjectId("55f5a192d4bede9ac365b258"), "author" : "li", "score" : 55, "views" : 5000 }
{ "_id" : ObjectId("55f5a1d3d4bede9ac365b259"), "author" : "annT", "score" : 60, "views" : 50 }
{ "_id" : ObjectId("55f5a1d3d4bede9ac365b25a"), "author" : "li", "score" : 94, "views" : 999 }
{ "_id" : ObjectId("55f5a1d3d4bede9ac365b25b"), "author" : "ty", "score" : 95, "views" : 1000 }

等価一致

次の操作では、 $matchを使用して等価一致を実行します。

db.articles.aggregate(
    [ { $match : { author : "dave" } } ]
);

$matchは、 authorフィールドがdaveと等しいドキュメントを選択し、集計は次の結果を返します。

{ "_id" : ObjectId("512bc95fe835e68f199c8686"), "author" : "dave", "score" : 80, "views" : 100 }
{ "_id" : ObjectId("512bc962e835e68f199c8687"), "author" : "dave", "score" : 85, "views" : 521 }

カウントの実行

次の例では、 $matchパイプライン演算子を使用して処理するドキュメントを選択し、その結果を$groupパイプライン演算子にパイプしてドキュメントの数を計算します。

db.articles.aggregate( [
  { $match: { $or: [ { score: { $gt: 70, $lt: 90 } }, { views: { $gte: 1000 } } ] } },
  { $group: { _id: null, count: { $sum: 1 } } }
] );

集計パイプラインで、$match は、score が 70 より大きく 90 より小さいか、views が 1000以上のドキュメントを選択します。これらのドキュメントは、カウントを実行するために$groupにつなげられます。集計により次の結果が返されます。

{ "_id" : null, "count" : 5 }

このページのC#の例では、Atlasサンプルデータセットの sample_mflixデータベースを使用します。MongoDB Atlasクラスターを無料で作成して、サンプルデータセットをロードする方法については、 MongoDB .NET/ C#ドライバーのドキュメントの「開始」を参照してください。

次の Movie クラスは、sample_mflix.movies コレクション内のドキュメントをモデル化します。

public class Movie
{
    public ObjectId Id { get; set; }
    public int Runtime { get; set; }
    
    public string Title { get; set; }
    public string Rated { get; set; }
    public List<string> Genres { get; set; }
    public string Plot { get; set; }
    
    public ImdbData Imdb { get; set; }
    public int Year { get; set; }
    public int Index { get; set; }
    
    public string[] Comments { get; set; }
   
    [BsonElement("lastupdated")]
    public DateTime LastUpdated { get; set; }
}

注意

パスカルケース用の ConventionPack

前のクラスのプロパティはパスカルケースで名前付けされていますが、 MongoDBコレクション内のフィールド名はキャメルケースを使用します。この違いを考慮するには、アプリケーションの起動時に次のコードを使用して ConventionPack を登録します。

var camelCaseConvention = new ConventionPack { new CamelCaseElementNameConvention() };
ConventionRegistry.Register("CamelCase", camelCaseConvention, type => true);

MongoDB .NET/ C#ドライバーを使用して$match ステージを集計パイプラインに追加するには、 PipelineDefinitionオブジェクトで Match() メソッドを呼び出します。

次の例では、Titleフィールドが "The Shawshank Redemption" に等しいすべての Movie ドキュメントに一致するパイプラインステージを作成します。

var pipeline = new EmptyPipelineDefinition<Movie>()
    .Match(m => m.Title == "The Shawshank Redemption");

詳細情報

集計に関する詳細とユースケースについては、「完全な集計パイプラインチュートリアル」を参照してください。

戻る

$lookup

$merge

定義

互換性

構文

動作