Definición
db.collection.checkMetadataConsistency(options)Realiza una serie de comprobaciones de coherencia en los metadatos de particionamiento para la colección. El método devuelve un cursor con todos o una tanda de los resultados de incoherencias encontrados.
Importante
Método mongosh
Esta página documenta una
mongoshMé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
checkMetadataConsistencydominio.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, para verificar el estado del catálogo.
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.
Compatibilidad
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.
Sintaxis
El método db.collection.checkMetadataConsistency() tiene la siguiente sintaxis:
db.collection.checkMetadataConsistency( { <options> } )
El documento options puede tomar los siguientes campos y valores:
Campo | Tipo | Descripción |
|---|---|---|
| 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. |
| Documento | Configura el cursor de retorno. |
| entero | Número máximo de documentos de inconsistencia de metadatos de fragmentación que se incluirán en cada lote. |
Ejemplo
db.authors.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") } } ], }