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 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
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 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 documentsarreglo, que contiene un documento para cada inconsistencia encontrada en los metadatos de particionado.
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 es ejecutable 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 tener 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. 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. |
| 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
Realice una comprobación de coherencia 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 coherencia 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") } } ], }