refineCollectionShardKey (comando de base de datos)

Consideraciones sobre los índices

• Existencia de índice

  Debe existir un índice que admita la clave especificada del comando antes de ejecutar el comando.

  Un índice auxiliar es aquel que empieza con la nueva especificación de clave de partición; es decir, el prefijo del índice coincide con la nueva especificación de clave de partición. Es decir, para cambiar la clave de partición a { x: 1, y: 1 } desde { x: 1 }, debe existir un índice que comience con { x: 1, y: 1 }; por ejemplo,

  • { x: 1, y: 1 }

  • { x: 1, y: 1, a: 1, b: 1}

  Nota

  • El índice de soporte no puede ser un índice parcial.

  • El índice de soporte no puede ser un índice disperso.

  • Si la colección utiliza una intercalación que no seasimple, el índice de soporte debe especificar la intercalación { locale: "simple" }.

• índice único

  Si el índice de partición actual tiene una restricción de unicidad, el nuevo índice de clave de partición también debe tener una restricción única.

  After creating the unique index to support the new shard key, drop the old shard key index before running refineCollectionShardKey.

  Also, if the current shard index has a unique constraint, then the new shard key cannot specify "hashed" for any of its fields.

  See also Sharded Collection and Unique Indexes.

• Intercalación de índices

  Si la colección fragmentada tiene unasimple intercalación predeterminada distinta de, el índice debe incluir un documento de intercalación { locale : "simple" } con. Al menos uno de los índices cuyos campos admitan el patrón de clave de fragmentación debe tener la intercalación simple.

Colección con intercalaciones que no sonsimple

Para configurar el ejemplo en la base de datos test:

1. Crea la colección cafés en la base de datos test, especificando la intercalación francesa fr como por defecto.

   db.getSiblingDB("test").createCollection( "cafés", { collation: { locale: "fr" } } );

2. Fragmenta la colección usando el campo customer_id como la clave de partición inicial. Porque la colección tiene una intercalación por defecto fr y no una intercalación simple, el comando shardCollection debe incluir una opción collation: { locale: "simple" }:

   db.adminCommand( {
      shardCollection: "test.cafés",
      key: { customer_id: 1 },
      collation: { locale: "simple" }
   } )

Para modificar la clave de partición para que sea tanto el campo customer_id como el order_id campo { customer_id: 1, order_id: 1 },

1. Create the index para admitir la nueva clave de partición si el índice aún no existe. Debido a que la colección utiliza una intercalación no simple, el índice debe incluir la opción collation: { locale: "simple" }.

   db.getSiblingDB("test").cafés.createIndex(
      { customer_id: 1, order_id: 1 },
      { collation: { locale: "simple" } }
   )

2. Ejecute el comando refineCollectionShardKey para agregar el campo order_id como un sufijo:

   db.adminCommand( {
      refineCollectionShardKey: "test.cafés",
      key: { customer_id: 1, order_id: 1 }
   } )

Tras completar correctamente el comando, la clave de partición de la colección ha cambiado a { customer_id: 1, order_id: 1 }. Para comprobarlo, puede ejecutar sh.status().