Overview
このガイドでは、コレクション内のドキュメント数の正確な推定値を取得する方法を学習できます。
正確なカウントの取得
コレクション内のドキュメントの数をカウントするには、 count_documents()メソッドを使用します。 特定の検索条件に一致するドキュメントの数をカウントするには、クエリフィルターを含む辞書をcount_documents()メソッドに渡します。
クエリの指定の詳細については、「 クエリの指定 」を参照してください。
すべてのドキュメントをカウントする
コレクション内のすべてのドキュメントの数を返すには、次の例に示すように、count_documents() メソッドに空の辞書を渡します。対応するコードを表示するには、Synchronous タブまたは Asynchronousタブを選択します。
collection.count_documents({})
await collection.count_documents({})
特定のドキュメントのカウント
特定の検索条件に一致するドキュメントの数を返すには、次の例に示すように、count_documents() メソッドでクエリを指定します。対応するコードを表示するには、Synchronous タブまたは Asynchronousタブを選択します。
collection.count_documents({ "author": "Mike" })
await collection.count_documents({ "author": "Mike" })
カウント動作をカスタマイズする
count_documents()メソッドは、カウント操作を構成するために使用できるオプションを表す任意のパラメーターを受け入れます。 オプションを指定しない場合、ドライバーはカウント操作をカスタマイズしません。
次の表では、 count_documents()をカスタマイズするために設定できるオプションについて説明しています。
プロパティ | 説明 |
|---|---|
| 操作に添付するコメント。 |
|
|
| 結果を返す前にスキップするドキュメントの数。 |
| カウントするドキュメントの最大数。 正の整数である必要があります。 |
| 操作の実行を許可する最大時間（ミリ秒単位）。 |
|
|
| ドキュメントをスキャンするインデックスを取得または設定します。 |
推定カウントの取得
estimated_document_count()メソッドを呼び出すと、コレクション内のドキュメント数の推定値を取得できます。 メソッドはコレクション メタデータに基づいてドキュメントの量を推定します。これは正確なカウントを実行するよりも高速です。
次の例では、コレクション内のドキュメントの数を見積ります。対応するコードを表示するには、Synchronous タブまたは Asynchronousタブを選択します。
collection.estimated_document_count()
await collection.estimated_document_count()
推定カウント動作をカスタマイズ
estimated_document_count()メソッドは、カウント操作を構成するために使用できるオプションを表す任意のパラメーターを受け入れます。 オプションを指定しない場合、ドライバーはカウント操作をカスタマイズしません。
次の表では、 estimated_document_count()をカスタマイズするために設定できるオプションについて説明しています。
プロパティ | 説明 |
|---|---|
| 操作に添付するコメント。 |
| 操作の実行を許可する最大時間（ミリ秒単位）。 |
トラブルシューティング
非推奨警告: カウントは非推奨
PyMongo はcount()メソッドのサポートを終了しました。 代わりに、 Collectionクラスのcount_documents()メソッドを使用します。
重要
count_documents()メソッドはCollectionクラスに属します。 Cursor.count_documents()を呼び出しようとすると、PyMongo は次のエラーを発生させます。
Traceback (most recent call last): File "<stdin>", line 1, in <module> AttributeError: 'Cursor' object has no attribute 'count'
API ドキュメント
このガイドで説明したメソッドや型の詳細については、次の API ドキュメントを参照してください。