/ /

$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 enumerar las consultas muestreadas para todas las colecciones, omita el argumento namespace.

Control de acceso

$listSampledQueries requiere el clusterMonitor rol en el cluster.

Limitaciones

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

Ejemplos

Lista de 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: {  } } ] )

Lista de consultas muestreadas para una colección específica

La siguiente operación de agregación enumera todas las consultas muestreadas para una colección 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.

Lista de 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;

Lista de consultas muestreadas para una colección específica

La siguiente operación de agregación enumera todas las consultas 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	Espacio de nombres de la colección muestreada.
`collectionUuid`	UUID	ID de la colección muestreada.
`cmdName`	string	Nombre del comando muestreado. Puede ser uno de los siguientes: `"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, si corresponde.
`expireAt`	fecha	Fecha de caducidad de la muestra.

Escribir consultas

{
   _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	Espacio de nombres de la colección muestreada.
`collectionUuid`	UUID	ID de la colección muestreada.
`cmdName`	string	Nombre del comando muestreado. Puede ser uno de los siguientes: `"update"` `"delete"` `"findAndModify"`
`cmd`	Objeto	Objeto de comando
`expireAt`	fecha	Fecha de caducidad de la muestra.

Volver

$listLocalSessions

$listSearchIndexes