sh.shardCollection()（mongoshメソッド）

時系列オプション

To create a new time series collection that is sharded, specify the timeseries option to sh.shardCollection().

timeseries オプションには次のフィールドが含まれます。

シャードキー

シャードキーは後でも変更できますが、スケーラビリティやパフォーマンスの問題を回避するために、シャードキーの選択を慎重にすることが重要になります。

ハッシュされたシャードキー

ハッシュされたシャードキーは、ハッシュされたインデックスまたはハッシュされた複合インデックスをシャードキーとして使用します。

ハッシュされたシャードキー フィールドを指定するには、 field: "hashed"の形式を使用します。

ゾーン シャーディングと初期チャンク分散

The shard collection operation (i.e. shardCollection command and the sh.shardCollection() helper) can perform initial chunk creation and distribution for an empty or a non-existing collection if zones and zone ranges have been defined for the collection. Initial chunk distribution allows for a faster setup of zoned sharding. After the initial distribution, the balancer manages the chunk distribution going forward per usual.

To shard a collection using a compound hashed index, see Initial Chunk Distribution with Compound Hashed Indexes.

一意性

unique: trueを指定する場合

• If the collection is empty, sh.shardCollection() creates the unique index on the shard key if such an index does not already exist.

• If the collection is not empty, you must create the index first before using sh.shardCollection().

• If the collection has an index that supports the shard key but that index is not unique, sh.shardCollection() returns an error.

シャードキーがプレフィックスであるユニーク複合インデックスを持つことは可能ですが、unique パラメーターを使用する場合、コレクションにはシャードキー上のユニークインデックスが必要です。

If you omit unique or specify unique: false, sh.shardCollection() doesn't change the collection's existing indexes. If a unique index on the shard key already exists, that index remains unique and the sharded cluster continues to enforce the uniqueness constraint on the shard key values across shards.

「シャーディングされたコレクションと一意のインデックス」も参照してください

書込み保証 (write concern)

mongos uses "majority" for the write concern of the shardCollection command, its helper sh.shardCollection(), and the sh.shardAndDistributeCollection() method.

バランス調整のための再シャーディング

When you run the sh.shardCollection() method, the balancer begins distributing the collection data to other shards in the cluster. A single shard can only participate in one chunk migration at a time. When MongoDB succeeds in copying a range of data from one shard to another, the range on the donor shard is marked for removal by the range deleter. This process is slow and resource intensive.

MongoDB 8.0 以降では、配置が リソース要件 を満たしている場合は、sh.shardAndDistributeCollection() メソッドを使用してコレクションをシャーディングすることをお勧めします。このメソッドは、shardCollection コマンドと reshardCollection コマンドをラップしてコレクションをシャードし、すぐに同じキーに再シャードします。これにより、 MongoDB はバランサーを待たずにシャード間でデータを再バランス化します。

詳細については、「同じシャードキーへの再シャーディング」を参照してください。

簡単な使い方

records という名前のデータベースに people という名前のコレクションがある場合、次のコマンドは zipcode フィールドでコレクションをシャーディングします。

sh.shardCollection("records.people", { zipcode: 1 } )

オプションで使用

The phonebook database has a collection contacts with no default collation. The following example uses sh.shardCollection() to shard the phonebook.contacts with:

• last_name フィールドのハッシュされたシャードキー、

• 5 初期チャンク、

• simple の照合。

sh.shardCollection(
  "phonebook.contacts",
  { last_name: "hashed" },
  false,
  {
    collation: { locale: "simple" }
  }
)