Docs Menu
Docs Home
/ /

sh.checkMetadataConsistency() (método mongosh)

sh.checkMetadataConsistency(options)

Realiza una serie de comprobaciones de consistencia en los metadatos de fragmentación del clúster. 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 una mongosh Método. Esta no es la documentación para comandos de base de datos ni para 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 degradaciones, o para verificar si los metadatos del clúster son inconsistentes o están dañados debido a errores en versiones anteriores de MongoDB.

De forma predeterminada, el método no comprueba la coherencia de los índices en todos los fragmentos. Las comprobaciones de índices pueden generar inconsistencias de falsos positivos si se ejecutan simultáneamente con operaciones que crean, eliminan o modifican índices. Para comprobar los índices con este método, configure la opción checkIndexes.

Para obtener más información sobre las inconsistencias que verifica este método, consulte Tipos de inconsistencia.

Devuelve:Este método devuelve un cursor con una matriz documents, que contiene un documento para cada inconsistencia encontrada en los metadatos de fragmentación.

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 se puede ejecutar cuando se conecta a mongos. mongod no admite este método.

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

sh.checkMetadataConsistency( { <options> } )

El documento options puede tomar 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.

De forma predeterminada, esta operación está deshabilitada, ya que puede generar inconsistencias por falsos positivos al ejecutarse simultáneamente con operaciones que crean, eliminan o modifican índices. Compruebe los índices solo cuando sepa que es improbable que estas operaciones se realicen.

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.

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

Volver

Estado de la colección sh.balancer

En esta página