MongoDB\GridFS\Bucket::find()

定義

MongoDB\GridFS\Bucket::find()

GridFS バケットのファイル コレクションからクエリに一致するドキュメントを検索します。

function find(
    array|object $filter = [],
    array $options = []
): MongoDB\Driver\Cursor

パラメーター

$filter : array|object

クエリするドキュメントを指定するフィルター条件。

$options : 配列

必要なオプションを指定する配列。

名前	タイプ	説明
allowDiskUse	ブール値	一時ファイルへの書込みを有効にします。 trueに設定すると、クエリはdbPathディレクトリの_tmpサブディレクトリにデータを書込むことができます。
allowPartialResults	ブール値	シャーディングされたコレクションに対するクエリでは、エラーがスローされる代わりにシャードが利用できない場合に、 mongosから部分的な結果を返します。
batchSize	integer	最初のバッチで返すドキュメントの数。 デフォルトは101です。 BatchSize が0の場合、カーソルは作成されますが、最初のバッチではドキュメントは返されません。 以前のワイヤプロトコル バージョンとは異なり、find コマンドの BatchSize が 1 の場合、カーソルは閉じられません。
コーデック	MongoDB\Codec\DocumentCodec	ドキュメントのエンコードまたはデコードに使用する は、タイプ コーデックでデータをエンコードします。このオプションは typeMap オプションと相互に排他的です。 デフォルトはバケットのコーデック。 デフォルトのcodecオプションの継承は、 typeMapオプションの継承よりも優先されます。 バージョン 1.17 の新機能。
collation	array|object	照合順序を指定すると、大文字や小文字、アクセント記号など、string を比較するための言語独自のルールを指定できます。 照合を指定する場合、 localeフィールドは必須です。その他の照合フィールドはすべてオプションです。 フィールドの説明については、 「照合ドキュメント」 を参照してください。
comment	混合	データベースプロファイラ、 currentOp出力、およびログから操作を追跡するのに役立つ任意のコメントを指定できるようにします。 コメントには、 MongoDB 4.4 以降の有効なBSONタイプであればどれでもかまいません。以前のサーバーバージョンでは string 値のみがサポートされていました。
cursorType	integer	使用するカーソルのタイプを示します。 cursorTypeは次の値をサポートしています。 MongoDB\Operation\Find::NON_TAILABLE （デフォルト） MongoDB\Operation\Find::TAILABLE
hint	string|array|object	使用するインデックス。 インデックス名を string またはインデックス キー パターンをドキュメントとして指定します。 指定すると、クエリ システムはヒント指定したインデックスを使用するプランのみを考慮します。 バージョン 1.2 の新機能.
let	array|object	パラメーター名と値のマップ。 値は、ドキュメント フィールドを参照しない定数または閉じた式である必要があります。 その後、パラメーターには 集計式コンテキスト で変数としてアクセスできます（例: $$var ）。 これは 5.0 より前のサーバー バージョンではサポートされていないため、使用された場合は実行時に例外が発生します。 バージョン 1.13 の新機能。
limit	integer	返されるドキュメントの最大数。 指定しない場合、デフォルトは制限なしになります。 0の制限は、制限を設定しない場合と同じです。 負の制限は正の制限と似ていますが、1 バッチ の結果が返された後にカーソルを閉じます。 そのため、負の制限では、制限された結果セットが 1 つのバッチに収まらない場合、受信されるドキュメントの数は指定された制限よりも少なくなります。 負の制限を渡すことにより、クライアントからサーバーに、 getMore 経由で後続のバッチ要求が実行されないことが伝えられます。
最大	array|object	特定のインデックスの排他的上限。 バージョン 1.2 の新機能.
maxAwaitTimeMS	integer	データが利用できない場合にサーバーが getMore 操作をブロックする時間の制限をミリ秒単位で示す正の整数。 このオプションは、 cursorType が TAILABLE_WAIT の場合にのみ使用する必要があります。 バージョン 1.2 の新機能.
maxTimeMS	integer	カーソルに対する情報処理操作の累積時間制限（ミリ秒単位）。 MongoDB は、次の割り込みポイントが最も近い時点で操作を中止します。
min	array|object	特定のインデックスの包括的下限。 バージョン 1.2 の新機能.
noCursorTimeout	ブール値	非アクティブ期間（10 分）後にサーバーがアイドル カーソルをタイムアウトしないようにします。
プロジェクション	array|object	返される文書に含めるフィールドを決定するためのプロジェクション仕様。 MongoDB マニュアルの「 クエリ 演算子および プロジェクション 演算子 から返されるプロジェクト フィールド 」を 参照してください。
ReadConcern	MongoDB\Driver\ReadConcern	操作に使用する読み取り保証。 デフォルトはバケットの読み取り保証 (read concern) です。 トランザクションの一部である個々の操作に対して読み取り保証 (read concern)を指定することはできません。代わりに、トランザクションを開始するときにreadConcern オプションを設定します。
readPreference	MongoDB\Driver\ReadPreference	Read preference to use for the operation. デフォルトでは、バケットの読み込み設定（read preference）に設定されます。
returnKey	ブール値	trueの場合、結果のドキュメントに含まれるインデックス キーのみを返します。 バージョン 1.2 の新機能.
セッション	MongoDB\Driver\Session	操作に関連付けるクライアント セッション。 バージョン 1.3 で追加。
showRecordId	ブール値	各ドキュメントのレコード識別子を返すかどうかを決定します。 true の場合、返されるドキュメントにフィールド$recordIdが追加されます。 バージョン 1.2 の新機能.
スキップ	integer	スキップするドキュメントの数。デフォルトは 0 です。
sort	array|object	結果の順序の並び替え指定。
typeMap	配列	カーソルに適用するタイプ マップ。BSON ドキュメントをPHP値に変換する方法を決定します。デフォルトはバケットのタイプマップです。

Return Values

MongoDB$Driver\Cursorオブジェクト。

エラーと例外

MongoDB\Exception\UnsupportedExceptionオプションが使用され、選択したサーバーでサポートされていない場合（例: collation 、 readConcern 、 writeConcern ）。

MongoDB\Exception\InvalidArgumentException は、パラメータまたはオプションの解析に関連するエラーの場合は です。

拡張レベルのその他のエラー（例: 接続エラー）の場合は、 MongoDB\Driver\Exception\RuntimeException 。

動作

クエリ条件を評価する際、 MongoDB はBSON types の独自の比較ルールに従ってタイプと値を比較します。これは PHP の比較および型調整ルールとは異なります。特別なBSON type を照合する場合、クエリ条件は拡張機能内でそれぞれのBSONクラスを使用する必要があります（たとえば、 ObjectId と一致させるためにMongoDB\ BSON\ObjectId を使用するなど）。

例

<?php
$bucket = (new MongoDB\Client)->test->selectGridFSBucket();
$stream = fopen('php://temp', 'w+b');
fwrite($stream, "foobar");
rewind($stream);
$bucket->uploadFromStream('b', $stream);
$cursor = $bucket->find(
    ['length' => ['$lte' => 6]],
    [
        'projection' => [
            'filename' => 1,
            'length' => 1,
            '_id' => 0,
         ],
         'sort' => ['length' => -1],
     ]
);
var_dump($cursor->toArray());

出力は次のようになります。

array(1) {
  [0]=>
  object(MongoDB\Model\BSONDocument)#3015 (1) {
    ["storage":"ArrayObject":private]=>
    array(2) {
      ["filename"]=>
      string(1) "b"
      ["length"]=>
      int(6)
    }
  }
}

その他の参照

• MongoDB\Collection::find()

• MongoDB\GridFS\Bucket::findOne()