MongoDB\Driver\Query::__construct

Parámetros

filter (array|object)

El » atributo de la consulta. Un atributo vacío hará coincidir todos los documentos de la colección.

Nota: Al evaluar los criterios de consulta, MongoDB compara los tipos y los valores según sus propias » reglas de comparación para los tipos BSON, que difieren de las reglas de comparación y de manipulación de tipos de PHP. Al hacer coincidir un tipo BSON especial, los criterios de consulta deben utilizar la clase BSON (ej.: utilizar MongoDB\BSON\ObjectId para hacer coincidir un » ObjectId).

queryOptions

queryOptions

Option	Type	Description
allowDiskUse	bool	Autoriza a MongoDB a utilizar ficheros temporales en el disco para almacenar datos que excedan el límite de memoria del sistema de 100 megabytes al procesar una operación de clasificación bloqueante.
allowPartialResults	bool	Para las consultas en una colección fragmentada, devuelve resultados parciales del mongos si algunos fragmentos no están disponibles en lugar de generar un error. Retoma la opción deprecada "partial" si no se especifica.
awaitData	bool	Utilizar en conjunción con la opción "tailable" para bloquear temporalmente una operación getMore en el cursor si al final de los datos en lugar de no devolver datos. Después de un período de espera, la consulta termina normalmente.
batchSize	int	El número de documentos a devolver en el primer lote. Por omisión a 101. Un tamaño de lote de 0 significa que el cursor será establecido, pero ningún documento será devuelto en el primer lote. En las versiones de MongoDB anteriores a 3.2, donde las consultas utilizan el protocolo de filaire heredado OP_QUERY, un tamaño de lote de 1 cerrará el cursor independientemente del número de documentos.
collation	array|object	» Collation permite a los usuarios especificar reglas específicas del lenguaje para la comparación de cadenas, por ejemplo, reglas para mayúsculas o acentos. Al especificar una collation, el campo "locale" es obligatorio; todos los demás campos de la collation son opcionales. Para la descripción de estos campos, consúltese el » documento Collation. Si la collation no es especificada pero la colección tiene una collation por omisión, la operación utilizará la collation especificada para la colección. Si ninguna collation es especificada para la colección o para la operación, MongoDB utilizará el binario simple de comparación utilizado en versiones anteriores para las comparaciones de cadenas. Esta opción está disponible en MongoDB 3.4+ y una excepción será emitida en tiempo de ejecución si es especificada en una versión anterior.
comment	mixed	Un comentario arbitrario para ayudar a rastrear la operación a través del perfil de la base de datos, la salida currentOp y los registros. El comentario puede ser cualquier tipo BSON válido para MongoDB 4.4+. Las versiones de servidor anteriores solo admiten valores de cadena. Retoma la opción deprecada "$comment" si no se especifica.
exhaust	bool	El flujo de datos aguas abajo a plena potencia en varios paquetes "more", asumiendo que el cliente leerá completamente todos los datos consultados. Más rápido cuando se extraen muchos datos y se sabe que se quiere extraer todo. Nota: el cliente no está autorizado a no leer todos los datos a menos que cierre la conexión. Esta opción no es admitida por el comando find en MongoDB 3.2+ y forzará al controlador a utilizar la versión del protocolo de filaire heredado (es decir, OP_QUERY).
explain	bool	Si true el cursor MongoDB\Driver\Cursor devuelto contendrá un solo documento que describe el proceso y los índices utilizados para devolver la consulta. Retoma la opción deprecada "$explain" si no se especifica. Esta opción no es admitida por el comando find en MongoDB 3.2+ y solo será respetada al utilizar la versión del protocolo de filaire heredado (es decir, OP_QUERY). El comando » explain debe ser utilizado en MongoDB 3.0+.
hint	string|array|object	Especificación del índice. Especifique el nombre del índice como cadena, o el patrón de clave de índice. Si se especifica, el sistema de consulta solo considerará los planes que utilicen el índice sugerido. Retoma la opción deprecada "hint" si no se especifica.
let	array|object	Diccionario de nombres y valores de parámetros. Los valores deben ser constantes o expresiones cerradas que no hagan referencia a campos del documento. Los parámetros pueden ser accedidos luego como variables en un contexto de expresión agregada (por ejemplo $$var). Esta opción está disponible en MongoDB 5.0+ y resultará en una excepción en tiempo de ejecución si es especificada para una versión anterior del servidor.
limit	int	El número máximo de documentos a devolver. Si no se especifica, entonces por omisión a ningún límite. Un límite de 0 es equivalente a no establecer un límite.
max	array|object	El límite superior exclusivo para un índice específico. Retoma la opción deprecada "$max" si no se especifica.
maxAwaitTimeMS	int	Entero positivo que indica el límite de tiempo en milisegundos para que el servidor bloquee una operación getMore si no hay datos disponibles. Esta opción solo debe ser utilizada en conjunción con las opciones "tailable" y "awaitData".
maxTimeMS	int	El límite de tiempo acumulativo en milisegundos para el procesamiento de las operaciones en el cursor. MongoDB detiene la operación en el primer punto de interrupción más cercano. Retoma la opción deprecada "$maxTimeMS" si no se especifica.
min	array|object	El límite inferior inclusivo para un índice específico. Retoma la opción deprecada "$min" si no se especifica.
noCursorTimeout	bool	Evita que el servidor finalice los cursores inactivos después de un período de inactividad (10 minutos).
projection	array|object	Las » especificaciones de proyección para determinar qué campos incluir en los documentos devueltos. Si se utiliza la funcionalidad ODM para deserializar los documentos como su clase PHP original, asegúrese de incluir el campo __pclass en la proyección. Esto es necesario para que la deserialización funcione y sin ello, la extensión devolverá (por omisión) un objeto stdClass en su lugar.
readConcern	MongoDB\Driver\ReadConcern	Un read concern a aplicar a la operación. Por omisión, el read concern de la URI de conexión MongoDB será utilizado. Esta opción está disponible en MongoDB 3.2+ y provocará una excepción en el momento de la ejecución si se especifica para una versión de servidor más antigua.
returnKey	bool	Si true, solo devuelve las claves de índice en los documentos resultantes. El valor por omisión es false. Si true y la comando find no utiliza un índice, los documentos devueltos estarán vacíos. Retoma la opción deprecada "$returnKey" si no se especifica.
showRecordId	bool	Determina si el identificador de registro debe ser devuelto para cada documento. Si true, añade un campo "$recordId" de primer nivel a los documentos devueltos. Retoma la opción deprecada "$showDiskLoc" si no se especifica.
singleBatch	bool	Determina si el cursor debe ser cerrado después del primer lote. Por omisión a false.
skip	int	Número de documentos a saltar. Por omisión a 0.
sort	array|object	La especificación de clasificación para el ordenamiento de los resultados. Retoma la opción deprecada "$orderby" si no se especifica.
tailable	bool	Devuelve un cursor tailable para una colección acotada.