Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.
Docs Menu

clearJumboFlag (comando de base de datos)

clearJumboFlag

Borra la bandera jumbo para un fragmento. Para usar el comando, ejecute el comando clearJumboFlag mongos en una instancia.

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.

El comando tiene la siguiente sintaxis:

db.adminCommand(
{
clearJumboFlag: "<database>.<collection>",
bounds: <array>
}
)

-OR-

// Cannot use for collections with hashed shard keys
db.adminCommand(
{
clearJumboFlag: "<database>.<collection>",
find: <query>
}
)

El comando toma los siguientes campos como clearJumboFlag argumentos:

Campo
Tipo
Descripción

string

El namespace de la colección particionada que tenga el(los) fragmento(s) jumbo.

Especifique el espacio de nombres completo de la colección, incluyendo el nombre de la base de datos (es decir, <database><collection>".<colección>")

arreglo

Los límites exactos de un fragmento específico. El arreglo debe consistir en dos documentos que especifiquen los valores inferior y superior de la clave de partición de un fragmento para trasladar:

[ { <shardKey> : <minValue> },{ <shardKey> : <maxValue> } ]

Documento

Una clave de partición específica y su valor contenidos en el fragmento jumbo.

{ <shardKey> : <value> }

  • Especifique el campo de límites o el find campo, pero no ambos.

  • Si la colección utiliza una clave de fragmento hash,no utilice el campo de búsqueda. En su lugar, utilice los límites.

En sistemas que funcionan con authorization, el usuario debe tener las acciones necesarias para el privilegio clearJumboFlag en el recurso { db: "", collection: "" }.

El rol integrado clusterManager proporciona los privilegios apropiados.

El sh.status() incluye los siguientes sh.status.databases.<collection>.chunk-details para la colección test.jumbo.

... // Content omitted for brevity
test.jumbo
shard key: { "x" : 1 }
unique: false
balancing: true
chunks:
shardA 2
shardB 2
{ "x" : { "$minKey" : 1 } } -->> { "x" : 1 } on : shardB Timestamp(3, 0)
{ "x" : 1 } -->> { "x" : 2 } on : shardA Timestamp(6, 1) jumbo
{ "x" : 2 } -->> { "x" : 3 } on : shardA Timestamp(5, 1) jumbo
{ "x" : 3 } -->> { "x" : { "$maxKey" : 1 } } on : shardB Timestamp(6, 0)

El siguiente comando clearJumboFlag especifica los límites del { "x" : 1 } -->> { "x" : 2 } fragmento:

db.adminCommand( {
clearJumboFlag: "test.jumbo",
bounds: [{ "x" : 1 }, { "x" : 2 }]
} )

Cuando se ejecuta con éxito, el comando devuelve "ok": 1 en su salida:

{
"ok" : 1,
"operationTime" : Timestamp(1580190080, 5),
"$clusterTime" : {
"clusterTime" : Timestamp(1580190080, 5),
"signature" : {
"hash" : BinData(0,"0cYT49s72MHUYV1F2WpoEwlyeVs="),
"keyId" : Long("6786859092951433239")
}
}
}

El siguiente comando clearJumboFlag especifica el campo de búsqueda para encontrar el fragmento que contiene la clave de { "x" : 2 } fragmentación:

db.adminCommand( {
clearJumboFlag: "test.jumbo",
find: { "x" : 2 }
} )

Cuando se ejecuta con éxito, el comando devuelve "ok": 1 en su salida:

{
"ok" : 1,
"operationTime" : Timestamp(1580191819, 5),
"$clusterTime" : {
"clusterTime" : Timestamp(1580191819, 5),
"signature" : {
"hash" : BinData(0,"N6x6drN7HUq5MR5ezUJns1rfeqY="),
"keyId" : Long("6786859092951433239")
}
}
}

Para verificar la operación, ejecuta sh.status() nuevamente. La bandera jumbo ya no debe aparecer en su salida.

... // Content omitted for brevity
test.jumbo
shard key: { "x" : 1 }
unique: false
balancing: true
chunks:
shardA 2
shardB 2
{ "x" : { "$minKey" : 1 } } -->> { "x" : 1 } on : shardB Timestamp(3, 0)
{ "x" : 1 } -->> { "x" : 2 } on : shardA Timestamp(7, 0)
{ "x" : 2 } -->> { "x" : 3 } on : shardA Timestamp(8, 0)
{ "x" : 3 } -->> { "x" : { "$maxKey" : 1 } } on : shardB Timestamp(6, 0)

El sh.status() incluye los siguientes sh.status.databases.<collection>.chunk-details para la colección test.jumboHashed. La colección utiliza una clave de partición con hash.

... // Content omitted for brevity
test.jumboHashed
shard key: { "x" : "hashed" }
unique: false
balancing: true
chunks:
shardA 2
shardB 2
{ "x" : { "$minKey" : 1 } } -->> { "x" : Long(0) } on : shardA Timestamp(1, 0)
{ "x" : Long(0) } -->> { "x" : Long("848411777775835583") } on : shardA Timestamp(4, 0)
{ "x" : Long("848411777775835583") } -->> { "x" : Long("5902408780260971510") } on : shardB Timestamp(4, 1) jumbo
{ "x" : Long("5902408780260971510") } -->> { "x" : { "$maxKey" : 1 } } on : shardB Timestamp(2, 2)

Para borrar la jumbo bandera para un fragmento si la colección utiliza una clave de fragmento hash, utilice con clearJumboFlag el campo de límites:

db.adminCommand( {
clearJumboFlag: "test.jumboHashed",
bounds: [{ "x" : Long("848411777775835583") }, { "x" : Long("5902408780260971510") }]
} )

Cuando se ejecuta con éxito, el comando devuelve "ok": 1 en su salida:

{
"ok" : 1,
"operationTime" : Timestamp(1580194290, 5),
"$clusterTime" : {
"clusterTime" : Timestamp(1580194290, 5),
"signature" : {
"hash" : BinData(0,"nWCqOYVrab7NEGHWoo2NYENqHR4="),
"keyId" : Long("6786875525496307742")
}
}
}

Para verificar la operación, ejecuta sh.status() nuevamente. La bandera jumbo ya no debe aparecer en su salida.

... // Content omitted for brevity
test.jumboHashed
shard key: { "x" : "hashed" }
unique: false
balancing: true
chunks:
shardA 2
shardB 2
{ "x" : { "$minKey" : 1 } } -->> { "x" : Long(0) } on : shardA Timestamp(1, 0)
{ "x" : Long(0) } -->> { "x" : Long("848411777775835583") } on : shardA Timestamp(4, 0)
{ "x" : Long("848411777775835583") } -->> { "x" : Long("5902408780260971510") } on : shardB Timestamp(5, 0)
{ "x" : Long("5902408780260971510") } -->> { "x" : { "$maxKey" : 1 } } on : shardB Timestamp(2, 2)