checkMetadataConsistency (comando de base de datos)

Definición

checkMetadataConsistency

Realiza una serie de verificaciones de coherencia en los metadatos de particionado para un clúster, base de datos o colección. El comando devuelve un cursor con todos o un agrupar de los Se encontraron resultados inconsistentes.

Tip

En mongosh, este comando también se puede ejecutar a través de los métodos asistentes db.checkMetadataConsistency(), db.collection.checkMetadataConsistency() o sh.checkMetadataConsistency().

Los métodos asistente son convenientes para usuarios de mongosh, pero es posible que no proporcionen el mismo nivel de información que los comandos de base de datos. En los casos en que no se necesite la conveniencia o se requieran campos de retorno adicionales, utiliza el comando de base de datos.

Ejecute este comando después de realizar operaciones de mantenimiento importantes, como actualizaciones y degradaciones, para comprobar el estado del catálogo.

Por defecto, el comando no comprueba la coherencia de los índices entre las particiones. Para comprobar índices, ajuste la opción checkIndexes.

Nuevo en la versión 7.0.

Compatibilidad

Este comando está disponible en implementaciones alojadas en los siguientes entornos:

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

• 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.

Sintaxis

• Para verificar todo el clúster en busca de inconsistencias de metadatos de fragmentación, ejecute el comando desde la base de datos admin.

  db.adminCommand( {
     checkMetadataConsistency: 1
  } )

• Para comprobar la base de datos en busca de inconsistencias en los metadatos de partición, ejecuta el comando desde el contexto de la base de datos:

  use cars
  db.runCommand( {
     checkMetadataConsistency: 1
  } )

• Para verificar si hay inconsistencias en los metadatos de fragmentación de una colección, ejecute el comando con el nombre de la colección:

  use library
  db.runCommand( {
     checkMetadataConsistency: "authors",
  } )

Comportamiento

var cur = db.runCommand( {
   checkMetadataConsistency: 1,
   cursor: {
      batchSize: 10
   }
} )

db.runCommand( {
   checkMetadataConsistency: 1,
   checkIndexes: true
} )

Ejemplo

Utilice para ejecutar runCommand() el checkMetadataConsistency comando:

db.runCommand( { checkMetadataConsistency: 1 } )

Ejemplo de salida:

{
   cursor: {
      id: Long("0"),
      ns: "test.$cmd.aggregate",
      firstBatch: [
         {
            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")
            }
         }
      ],
   },
   ok: 1
}