find

string

クエリするコレクションまたはビューの名前。

ドキュメント

任意。クエリ述語。指定しない場合は、コレクション内のすべてのドキュメントがその述語と一致します。

ドキュメント

任意。結果の順序の並び替え指定。

ドキュメント

任意。返される文書に含めるフィールドを決定するためのプロジェクション仕様。「プロジェクション」および「プロジェクション演算子」を参照してください。

ビューに対するfind()操作は次のプロジェクション演算子をサポートしていません。

• $

• $elemMatch

• $slice

• $meta

文字列またはドキュメント

任意。インデックスの仕様。インデックス名を 文字列またはインデックス キー パターンを指定します。指定すると、クエリ システムはヒント指定したインデックスを使用するプランのみを考慮します。

次の例外を除き、コマンドに min フィールドや max フィールドが含まれている場合は、hint が必要です。hint は、filter が _id フィールドの等価条件（{ _id: <value> }）である場合、min や max では必要ありません。

正の整数

任意。スキップするドキュメントの数。デフォルトは 0 です。

Non-negative integer

任意。返されるドキュメントの最大数。指定しない場合、デフォルトは制限なしになります。limit の値が 0 の場合、制限を設定しない場合と同等です。

non-negative integer

任意。最初のバッチで返すドキュメントの数。デフォルトは 101 です。BatchSize が 0 の場合、カーソルは作成されますが、最初のバッチではドキュメントは返されません。

以前のワイヤプロトコルバージョンとは異なり、1 コマンドの findBatchSize が の場合、カーソルは閉じられません。

ブール値

任意。最初のバッチするの後にカーソルを閉じるかどうかを決定します。デフォルトは false です。

any

任意。このコマンドに添付するユーザー指定のコメント。設定すると、このコメントは以下の場所にこのコマンドの記録と合わせて表示されます。

• attr.command.cursor.comment フィールド内のmongod ログ メッセージ。

• command.comment フィールドのデータベースプロファイラー出力。

• command.comment フィールドのcurrentOp出力。

コメントには、有効な BSON 型（string, integer, object, array など）を使用できます。

find コマンドに設定されたコメントは、find カーソルで実行される後続の getMore コマンドに継承されます。

non-negative integer

任意。

時間制限をミリ秒単位で指定します。maxTimeMS の値を指定しない場合、操作はタイムアウトしません。値を 0 にすると、デフォルトの無制限動作を明示的に指定します。

MongoDB は、db.killOp() と同じメカニズムを使用して、割り当てられた時間制限を超えた操作を終了します。MongoDB は、指定された割り込みポイントのいずれかでのみ操作を終了します。

linearizable read concern を指定する場合、データを保持するノードの大部分が利用できない場合に備えて、常に maxTimeMS を使用します。maxTimeMS を指定すると、操作が無期限にブロックされることはなく、読み取り保証 (read concern) が満たされない場合は、代わりにエラーが返されます。

ドキュメント

任意。読み取り保証 (read concern) を指定します。

readConcern オプションの構文は、次のとおりです。readConcern: { level: <value> }

次の読み取り保証レベルが利用できます。

• "local"。これは、プライマリとセカンダリに対する読み取り操作での、デフォルトの読み取り保証レベルです。

• "available" 。プライマリおよびセカンダリに対する読み取り操作に使用できます。"available" は、プライマリおよびシャーディングされていないセカンダリに対して "local" と同じように動作します。クエリは、インスタンスの最新データを返します。

• "majority" 。WiredTiger ストレージ エンジンを使用するレプリカセットで使用できます。

• "linearizable" 。primary の読み取り操作にのみ使用できます。

読み取り保証 (read concern) のレベルについて詳しくは、「読み取り保証 (read concern) レベル」を参照してください。

getMore コマンドは、元の find コマンドで指定された readConcern レベルを使用します。

ドキュメント

任意。特定のインデックスの排他的上限。詳細については、「cursor.max()」を参照してください。

max フィールドを使用するには、指定した filter が _id フィールドの等価条件（{ _id: <value> }）でない限り、コマンドでも hint を使用する必要があります。

ドキュメント

任意。特定のインデックスの包括的下限。詳細については、「cursor.min()」を参照してください。

min フィールドを使用するには、指定した filter が _id フィールドの等価条件（{ _id: <value> }）でない限り、コマンドでも hint を使用する必要があります。

ブール値

任意。 true の場合、結果のドキュメントに含まれるインデックスキーのみを返します。デフォルト値は false です。 returnKey が true で、find コマンドがインデックスを使用しない場合、返されるドキュメントは空になります。

ブール値

任意。各ドキュメントのレコード識別子を返すかどうかを決定します。true の場合、返されるドキュメントにフィールド $recordId が追加されます。

ブール値

任意。上限付きコレクションの追尾可能 (tailable) カーソルを返します。

ブール値

任意。 getMore追尾可能オプションと組み合わせて使用すると、データを返さずに、データの終端でカーソル上の コマンドを一時的にブロックできます。タイムアウト期間が経過すると、find は通常通りデータを返します。

ブール値

任意。サーバーが非アクティブ アイドル期間後に非セッション30 アイドル カーソルをタイムアウトしないようにします。セッションの一部であるカーソルに対しては無視されます。詳細については、「 セッション アイドル タイムアウト 」を参照してください。

ブール値

任意。シャーディングされたコレクションに対するクエリで、クエリされたシャードが 1 つ以上使用できない場合に、コマンド（または後続の getMore コマンド）がエラーではなく部分的な結果を返します。

クエリされたシャードが使用できないために、 find（または後続のgetMore コマンド）によって部分的な結果が返される場合、検索出力には partialResultsReturnedインジケーターフィールドが含まれます。クエリされたシャードが最初の コマンドで使用できるが、後続のfindgetMore コマンドで 1 つ以上のシャードが使用できなくなった場合、シャードが使用できないときに実行される コマンドのみ、その出力に が含まれます。getMore partialResultsReturned。

ドキュメント

任意。

操作に使用する照合を指定します。

照合を指定すると、大文字・小文字やアクセント記号など、文字列を比較するための言語独自のルールを指定できます。

照合オプションの構文は次のとおりです。

collation: {
   locale: <string>,
   caseLevel: <boolean>,
   caseFirst: <string>,
   strength: <int>,
   numericOrdering: <boolean>,
   alternate: <string>,
   maxVariable: <string>,
   backwards: <boolean>
}

照合を指定する場合、locale フィールドは必須ですが、その他の照合フィールドはすべて任意です。フィールドの説明については、照合ドキュメントを参照してください。

照合が指定されていなくても、コレクションにデフォルトの照合が設定されている場合（db.createCollection() を参照）には、コレクションの照合が使用されます。

コレクションにも操作にも照合が指定されていない場合、MongoDB では以前のバージョンで使用されていた単純なバイナリ比較によって文字列が比較されます。

1 つの操作に複数の照合は指定できません。たとえば、フィールドごとに異なる照合を指定できません。また、ソートと検索を一度に実行する場合、検索とソートで別の照合を使用できません。

ブール値

任意。

このオプションを使用して、特定のクエリの allowDiskUseByDefault をオーバーライドできます。このオプションは下記のいずれかに使用できます。

• デフォルトでディスクの使用が許可されているシステムで、ディスクの使用を禁止する。

• デフォルトでディスクの使用が禁止されているシステムで、ディスクの使用を許可する。

MongoDB 6.0 以降では、 allowDiskUseByDefault が true に設定されており、かつパイプライン実行ステージのために 100 MB を超えるメモリがサーバーに必要な場合、クエリで { allowDiskUse: false } が指定されていない限り、MongoDB では一時ファイルが自動的にディスクに書き込まれます。

詳細については、allowDiskUseByDefault を参照してください。

allowDiskUse MongoDBがインデックスを使用して指定された ソート を満たすことができる場合、またはブロッキングソートに必要なメモリが 100MB 未満の場合、 は効果がありません。

allowDiskUse の詳細なドキュメントについては、「cursor.allowDiskUse()」を参照してください。

大規模なブロッキングソートのメモリ制限の詳細については、「ソートとインデックスの使用」を参照してください。

ドキュメント

任意。

変数のリストを含むドキュメントを指定します。これにより、変数をクエリテキストから分離することで、コマンドの読みやすさを向上させることができます。

ドキュメントの構文は次のとおりです。

{
  <variable_name_1>: <expression_1>,
  ...,
  <variable_name_n>: <expression_n>
}

変数は式によって返された値に設定され、その後は変更できません。

コマンド内の変数の値にアクセスするには、二重ドル記号の接頭辞（$$）を $$<variable_name> 形式にした変数名とともに使用します。たとえば次のとおりです。$$targetTotal

結果のフィルタリングに変数を使用するには、$expr 演算子内の変数にアクセスする必要があります。

letと変数を使用した完全な例については、「 における変数の使用 let」を参照してください。