refineCollectionShardKey

Considerações sobre o índice

• Existência do Índice

  Um índice que suporta a chave especificada do comando deve existir antes de executar o comando.

  Um índice de suporte é um índice que começa com a nova especificação da chave de shard; ou seja, o prefixo do índice corresponde à nova especificação da chave de shard. Ou seja, para alterar a chave de shard de { x: 1, y: 1 } de { x: 1 }, e o índice que começa com { x: 1, y: 1 } deve existir; por exemplo

  • { x: 1, y: 1 }

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

  Observação

  • O índice de suporte não pode ser um índice parcial.

  • O índice de suporte não pode ser um índice esparso.

  • Se a collection usar um agrupamento nãosimple , o índice de suporte deverá especificar o agrupamento { locale: "simple" } .

• índice único

  Se o índice de fragmento atual tiver uma restrição de exclusividade, o novo índice da chave de fragmento também deverá ter uma restrição exclusiva.

  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.

• Agrupamento de Índices

  Se a collection fragmentada tiver um agrupamento padrão nãosimple , o índice deverá incluir um documento de agrupamento com { locale : "simple" }. Pelo menos um dos índices cujos campos suportam o padrão de chave de fragmento deve ter o agrupamento simples.

Collection comsimple agrupamento que não seja

Para configurar o exemplo no reconhecimento de data center do test :

1. Crie a collection cafés no reconhecimento de data center test , especificando o fr francês como o agrupamento padrão.

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

2. Fragmente a coleta usando o campo customer_id como a chave de fragmento inicial. Como a collection tem um agrupamento fr padrão e não um agrupamento simple , o comando shardCollection deve incluir uma opção collation: { locale: "simple" } :

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

Para modificar a chave de fragmento para ser o campo customer_id e o campo order_id { customer_id: 1, order_id: 1 },

1. Create the index para dar suporte à nova chave de shard, se o índice ainda não existir. Como a collection usa um agrupamento não simples, o índice deve incluir a opção collation: { locale: "simple" } .

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

2. Execute o comando refineCollectionShardKey para adicionar o campo order_id como um sufixo:

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

Após a conclusão bem-sucedida do comando, a chave de fragmento da collection foi alterada para { customer_id: 1, order_id: 1 }. Para verificar, você pode executar sh.status().