refineCollectionShardKey (comando de base de datos)

Consideraciones sobre los índices

• Índice Existencia

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

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

  • { x: 1, y: 1 }

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

  Nota

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

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

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

• Índice único

  Si el índice de fragmento actual tiene una restricción de unicidad, el nuevo índice de clave de fragmento 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 consimple intercalaciónno

Para configurar el ejemplo en la base de datos test:

1. Cree la colección cafés en la base de datos test, especificando francés fr como la intercalación predeterminada.

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

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

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

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

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

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

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

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

Al completar el comando correctamente, la clave de fragmento de la colección cambia { customer_id: 1, order_id: 1 } a. Para verificarlo, puede sh.status() ejecutar.