ドキュメントをカウント

サンプル データ

このガイドの例では、 Atlasサンプルデータセット の sample_trainingデータベースの companiesコレクションを使用します。Rubyアプリケーションからこのコレクションにアクセスするには、Atlas クラスターに接続する Mongo::Clientオブジェクトを作成し、次の値を database 変数と collection 変数に割り当てます。

database = client.use('sample_training')
collection = database['companies']

MongoDB Atlasクラスターを無料で作成して、サンプルデータセットをロードする方法については、 「Atlas を使い始める」ガイドを参照してください。

すべてのドキュメントをカウントする

コレクション内のすべてのドキュメントの数を返すには、次の例に示すように、クエリフィルターを渡せずに count_documents メソッドを呼び出します。

result = collection.count_documents
puts "Number of documents: #{result}"

Number of documents: 9500

特定のドキュメントのカウント

特定の検索条件に一致するドキュメントの数を返すには、クエリフィルターをcount_documentsメソッドに渡します。

次の例では、 founded_yearフィールドの値が2010であるドキュメントの数をカウントします。

result = collection.count_documents(founded_year: 2010)
puts "Number of companies founded in 2010: #{result}"

Number of companies founded in 2010: 33

カウント動作をカスタマイズする

オプション値を指定する 2 つ目のパラメーターを渡すことで、count_documents メソッドの動作を変更できます。次の表では、カウント操作をカスタマイズするために設定できるオプションについて説明しています。

次の例では、 count_documentsメソッドを使用して、 number_of_employeesフィールドの値が50であるドキュメントの数をカウントし、最大100の結果をカウントするように操作に指示します。

result = collection.count_documents({ number_of_employees: 50 }, limit: 100)
puts "Number of companies with 50 employees: #{result}"

Number of companies with 50 employees: 100

推定カウント動作をカスタマイズ

オプション値を指定するパラメーターを渡すことで、estimated_document_count メソッドの動作を変更できます。次の表では、操作をカスタマイズするために設定できるオプションについて説明します。

次の例では、 estimated_document_countメソッドを使用してコレクション内のドキュメント数の推定値を返し、操作のタイムアウトを1000ミリ秒に設定します。

result = collection.estimated_document_count(max_time_ms: 1000)
puts "Estimated number of documents: #{result}"

Estimated number of documents: 9500