Definición
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 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, 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.De forma predeterminada, el método comprueba los metadatos de fragmentación de la base de datos dada. Si se ejecuta en la base de datos
admin, comprueba los metadatos de fragmentación de todo el clúster.Para obtener más información sobre las inconsistencias que busca 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.checkMetadataConsistency() tiene la siguiente sintaxis:
db.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
Realizar una comprobación de consistencia en la base de datos
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") } } ], }
Realizar comprobaciones de consistencia en el clúster
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") } } ], }