/ /

$listSampledQueries (etapa de agregación)

Definición

$listSampledQueries: Devuelve consultas muestreadas para todas las colecciones o para una colección específica. El comando analyzeShardKey utiliza estas consultas para calcular métricas sobre la distribución de lectura y escritura de una clave de fragmento.

Sintaxis

$listSampledQueries tiene esta sintaxis:

{
   $listSampledQueries: { namespace: <namespace> }
}

Comportamiento

Para listar consultas muestreadas de una sola colección, especifique la colección en el argumento namespace.
Para listar consultas muestreadas para todas las colecciones, omite el argumento namespace.

Control de acceso

$listSampledQueries requiere la clusterMonitor rol en el clúster.

Limitaciones

No puedes utilizar $listSampledQueries en Atlas multicliente configuraciones.
No se puede utilizar $listSampledQueries en implementaciones independientes.
No puedes usar $listSampledQueries directamente contra un --shardsvr set de réplicas. Al ejecutarse en un clúster fragmentado, $listSampledQueries debe ejecutarse contra un mongos.

Ejemplos

Listar las consultas muestreadas para todas las colecciones

La siguiente operación de agregación enumera todas las consultas muestreadas para todas las colecciones en el set de réplicas:

db.aggregate( [  { $listSampledQueries: {  } } ] )

Enumerar las consultas muestreadas de una colección específica

La siguiente operación de agregación enumera todas las queries muestreadas para una colección de post en la base de datos social:

db.aggregate( [  { $listSampledQueries: { namespace: "social.post" } } ] )

Para utilizar el controlador de MongoDB Node.js para agregar una etapa de $listSampledQueries a una canalización de agregación, utilice el Operador $listSampledQueries en un objeto de canalización.

Listar las consultas muestreadas para todas las colecciones

La siguiente operación de agregación enumera todas las consultas muestreadas para todas las colecciones en el set de réplicas:

const pipeline = [{ $listSampledQueries: {} }];
const cursor = db.aggregate(pipeline);
return cursor;

Enumerar las consultas muestreadas de una colección específica

La siguiente operación de agregación enumera todas las queries muestreadas para la colección movies en la base de datos sample_mflix:

const pipeline = [{ $listSampledQueries: { namespace: "sample_mflix.movies" } }];
const cursor = db.aggregate(pipeline);
return cursor;

Salida

Los campos de salida difieren para las consultas de lectura y escritura.

Consultas de lectura

{
   _id: <uuid>,
   ns: "<database>.<collection>",
   collectionUuid: <collUUID>,
   cmdName: <find|aggregate|count|distinct>,
   cmd: {
     filter: <object>,
     collation: <object>,
     let: <object>
   },
   expireAt: <date>
}

Nombre de campo	Tipo	Descripción
`_id`	UUID	ID de muestra para la consulta.
`ns`	string	Namespace de la colección muestreada.
`collectionUuid`	UUID	ID de la colección muestreada.
`cmdName`	string	Nombre de la orden de muestra. Puede ser uno de: `"find"` `"aggregate"` `"count"` `"distinct"`
`cmd.filter`	Objeto	Filtrar el comando ejecutado, si corresponde.
`cmd.collation`	Objeto	Intercalación con la que se ejecutó el comando, si corresponde.
`cmd.let`	Objeto	Variables personalizadas con las que se ejecutó el comando, en caso de que sea relevante.
`expireAt`	fecha	Fecha de expiración de la muestra.

Guardar queries

{
   _id: <uuid>,
   ns: "<database>.<collection>",
   collectionUuid: <collUUID>,
   cmdName: <update|delete|findAndModify>,
   cmd: <object>,
   expireAt: <date>
}

Nombre de campo	Tipo	Descripción
`_id`	UUID	ID de muestra para la consulta.
`ns`	string	Namespace de la colección muestreada.
`collectionUuid`	UUID	ID de la colección muestreada.
`cmdName`	string	Nombre de la orden de muestra. Puede ser uno de: `"update"` `"delete"` `"findAndModify"`
`cmd`	Objeto	Objeto de comando
`expireAt`	fecha	Fecha de expiración de la muestra.

Volver

$listLocalSessions

$listSearchIndexes