(PECL mongo >=0.9.2)
MongoDB::command — Ejecuta una orden de base de datos
$command
[, array $options = array()
[, string &$hash
]] ) : arrayPrácticamente todo lo que no son operaciones CRUD se puede realizar con una orden de base de datos. ¿Necesita conocer la versión de la base de datos? Hay una orden para ello. ¿Necesita hacer una agregación? Hay una orden para ello. ¿Necesia habilitar la identificación? Ha captado la idea.
Este método es idéntico a:
<?php
public function command($datos) {
return $this->selectCollection('$cmd')->findOne($datos);
}
?>
command
La Consulta a enviar.
options
Un array de opciones para la creación del índice. Actualmente las opciones disponibles incluyen:
"socketTimeoutMS"
Esta opción especifica el tiempo límite, en milisegundos, para las comunicaciones con socket. Si el servidor no responde en el periodo especificado, se lanzará una MongoCursorTimeoutException y no habrá forma de determinar si el servidor manejó realmente la escritura o no. Se podría especificar un valor de -1 para bloquear indefinidamente. El valor predeterminado para MongoClient es 30000 (30 segundos).
Las siguientes opciones están obsoletas y no deberían utilizarse más:
"timeout"
Alias obsoleto de "socketTimeoutMS".
hash
Establecer el hash de conexión del servidor que ejecutó la orden. Cuando el resultado de la orden es apropiado para crear un MongoCommandCursor, el objeto del hash es pasarlo a MongoCommandCursor::createFromDocument().
El hash también se corresponderá con una conexión devuelta desde MongoClient::getConnections().
| Versión | Descripción |
|---|---|
| 1.5.0 |
Se renombró la opción "timeout" a
"socketTimeoutMS". Emite un error
Se añadió el parámetro por referencia hash. |
| 1.2.0 | Se añadió el parámetro options con una única opción: timeout. |
Devuelve la respuesta de la base de datos. Cada respuesta de la base de datos siempre es como máximo un documento, lo que significa que el resultado de una orden de base de datos nunca puede exceder 16 MB. La estructura del documento resultante depende de la orden, pero la mayoría de los resultados tendrán el campo ok para indicar éxito o fracaso, y results, que contiene un array por cada documento resultante.
Ejemplo #1 Ejemplo de MongoDB::command() con "distinct"
Buscar todos los valores distintos de una clave.
<?php
$personas = $bd->personas;
$personas->insert(array("nombre" => "Joe", "edad" => 4));
$personas->insert(array("nombre" => "Sally", "edad" => 22));
$personas->insert(array("nombre" => "Dave", "edad" => 22));
$personas->insert(array("nombre" => "Molly", "edad" => 87));
$edades = $bd->command(array("distinct" => "personas", "key" => "edad"));
foreach ($edades['values'] as $edad) {
echo "$edad\n";
}
?>
El resultado del ejemplo sería algo similar a:
Ejemplo #2 Ejemplo de MongoDB::command() con "distinct"
Buscar todos los valores distintos de una clave, donde el valor es mayor o igual a 18.
<?php
$personas= $bd->personas;
$personas->insert(array("nombre" => "Joe", "edad" => 4));
$personas->insert(array("nombre" => "Sally", "edad" => 22));
$personas->insert(array("nombre" => "Dave", "edad" => 22));
$personas->insert(array("nombre" => "Molly", "edad" => 87));
$edades = $bd->command(
array(
"distinct" => "personas",
"key" => "edad",
"query" => array("edad" => array('$gte' => 18))
)
);
foreach ($edades['values'] as $edad) {
echo "$edad\n";
}
?>
El resultado del ejemplo sería algo similar a:
Ejemplo #3 Ejemplo de MongoDB::command() con MapReduce
Obtener todos los usuarios con al menos un evento de venta ("sale"), y cuántas veces han realizado ventas cada uno de esos usuarios.
<?php
// documento de eventos de ejemplo
$eventos->insert(array("user_id" => $id,
"type" => $tipo,
"time" => new MongoDate(),
"desc" => $descripción));
// construcción del mapa y función reductora
$mapa = new MongoCode("function() { emit(this.user_id,1); }");
$reductora = new MongoCode("function(k, vals) { ".
"var sum = 0;".
"for (var i in vals) {".
"sum += vals[i];".
"}".
"return sum; }");
$sales = $bd->command(array(
"mapreduce" => "events",
"map" => $mapa,
"reduce" => $reductora,
"query" => array("type" => "sale"),
"out" => array("merge" => "eventCounts")));
$usuarios = $bd->selectCollection($sales['result'])->find();
foreach ($usuarios as $usuario) {
echo "El usuario {$usuario['_id']} realizó {$usuario['value']} venta(s).\n";
}
?>
El resultado del ejemplo sería algo similar a:
Nota: Usando MongoCode
Este ejemplo utiliza MongoCode, que puede utilizar también un argumento de ámbito. Sin embargo, por el momento, MongoDB no admite el uso de ámbitos en MapReduce. Si fuera necesario usar variables en el lado del cliente con las funciones MapReduce, puede añairlas al ámbito global usando el campo opcional de ámbito con la orden de la base de datos. Consulte la » documentación de MapReduce para más información.
Nota: El argumento out
Antes de 1.8.0, el argumento out era opcional. Si no se iba a usar, los resultados de MapReduce se escribían a una colección temporal, que se eliminaba cuando se cerraba la conexión. A partir de la versión 1.8.0, el argumento out es obligatorio. Consulte la » documentación de MapReduce para más información.
Ejemplo #4 Ejemplo de MongoDB::command() con "geoNear"
Este ejemplo muestra cómo usar la orden geoNear.
<?php
$m = new MongoClient();
$d = $m->demo;
$c = $d->poiConcat;
$r = $d->command(array(
'geoNear' => "poiConcat", // Buscar en la colección poiConcat
'near' => array(-0.08, 51.48), // Buscar cerca de 51.48°N, 0.08°E
'spherical' => true, // Habilitar la búsqueda esférica
'num' => 5, // 5 documentos devueltos como máximo
));
print_r($r);
?>
La documentación de MongoDB sobre » órdenes de base de datos y las órdenes individuales: » findAndModify, » getLastError, y » repair (existen muchas más, éstos son sólo unos pocos ejemplos).