Join us at MongoDB.local London on 7 May to unlock new possibilities for your data. Use WEB50 to save 50%.
Register now >
Docs Menu
Docs Home
/ /

db.checkMetadataConsistency() (método mongosh)

db.checkMetadataConsistency(options)

Realiza una serie de comprobaciones de consistencia en los metadatos de fragmentación del clúster o la base de datos. Este método devuelve un cursor con todos o un lote de los resultados de inconsistencia encontrados.

Importante

Método mongosh

Esta página documenta a Método mongosh. Esta no es la documentación de comandos de base de datos ni de controladores específicos del lenguaje, como Node.js.

Para el comando de base de datos, consulte el checkMetadataConsistency dominio.

Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.

Ejecute este método después de operaciones de mantenimiento importantes, como actualizaciones y retrogradaciones, o para comprobar si los metadatos del clúster son inconsistentes o están dañados debido a errores en versiones anteriores de MongoDB.

Por defecto, el método no verifica la coherencia de los índices en las particiones. Los chequeos de índices pueden devolver inconsistencias de falsos positivos si se ejecutan de manera simultánea con operaciones que creen, borren o modifiquen índices. Para comprobar los índices con este método, configura la opción checkIndexes.

Por defecto, el método verifica los metadatos de particionado para la base de datos dada. Si se ejecuta en la base de datos admin, en su lugar verifica los metadatos de particionado para todo el clúster.

Para obtener más información sobre las inconsistencias que busca este método, consulta Tipos de Inconsistencias.

Devuelve:Este método devuelve un cursor con un documents arreglo, que contiene un documento para cada inconsistencia encontrada en los metadatos de particionado.

Este método está disponible en implementaciones alojadas en los siguientes entornos:

  • MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

Importante

Este comando no es compatible con los clústeres M0 y Flex. Para obtener más información, consulta Comandos no compatibles.

  • MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB

  • MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Nota

El asistente checkMetadataConsistency solo es ejecutable cuando se conecta a mongos. mongod no admite este método.

El método db.checkMetadataConsistency() tiene la siguiente sintaxis:

db.checkMetadataConsistency( { <options> } )

El documento options puede tener los siguientes campos y valores:

Campo
Tipo
Descripción

checkIndexes

booleano

Establece si el comando también verifica los índices en los metadatos de fragmentación.

Por defecto, esta operación está deshabilitada porque puede devolver inconsistencias positivas falsas al ejecutarse de manera concurrente con operaciones que crean, eliminan o modifican índices. Solo verifica los índices en momentos en los que sepas que es poco probable que estas operaciones ocurran.

cursor

Documento

Configura el cursor de retorno.

cursor.batchSize

entero

Número máximo de documentos de inconsistencia de metadatos de fragmentación que se incluirán en cada lote.

Para realizar comprobaciones de consistencia en una base de datos, llame al método db.checkMetadataConsistency():

use library
db.checkMetadataConsistency()
{
cursorHasMore: false,
documents: [
{
type: "MisplacedCollection",
description: "Unsharded collection found on shard different from database primary shard",
details: {
namespace: "library.authors",
shard: "shard02",
localUUID: new UUID("1ad56770-61e2-48e9-83c6-8ecefe73cfc4")
}
}
],
}

Para realizar comprobaciones de consistencia en un clúster, llame al método db.checkMetadataConsistency() desde la base de datos admin:

use admin
db.checkMetadataConsistency()
{
cursorHasMore: false,
documents: [
{
type: "MisplacedCollection",
description: "Unsharded collection found on shard different from database primary shard",
details: {
namespace: "library.authors",
shard: "shard02",
localUUID: new UUID("1ad56770-61e2-48e9-83c6-8ecefe73cfc4")
}
}
],
}

Volver

convertShardKeyToHashed

En esta página