sh.addShardToZone() (mongoshメソッド)

定義

sh.addShardToZone(shard, zone)

シャードをゾーンに関連付けます。 MongoDB はこのシャードを指定されたゾーンに関連付けます。ゾーンによってカバーされるチャンクは、そのゾーンに関連付けられているシャードに割り当てられます。

重要

mongosh メソッド

This page documents a mongosh method. This is not the documentation for database commands or language-specific drivers, such as Node.js.

データベースコマンドについては、addShardToZone コマンドを参照してください。

MongoDB API ドライバーについては、各言語の「MongoDB ドライバーのドキュメント」を参照してください。

このメソッドには次のパラメーターがあります。

Parameter	タイプ	説明
シャード	string	The name of the shard to which to associate the zone.
ゾーン	string	The name of the zone to associate with the shard.

Only issue sh.addShardToZone() when connected to a mongos instance.

互換性

このメソッドは、次の環境でホストされている配置で使用できます。

MongoDB Atlas はクラウドでの MongoDB 配置のための完全管理サービスです

重要

このコマンドは、M0 および Flex クラスターではサポートされていません。詳細については、サポートされていないコマンドを参照してください。

MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

動作

ゾーンを複数のシャードに関連付けることができ、シャードは複数のゾーンに関連付けらることができます。

シャーディングされたクラスター内のゾーンの詳細については、ゾーンのマニュアルページを参照してください。

Ranges

MongoDB は、関連付けられているシャードキー値が少なくとも 1 つの範囲ではないゾーンを実質的に無視します。

シャードキー値の範囲をゾーンに関連付けるには、 sh.updateZoneKeyRange()メソッドを使用します。

updateZoneKeyRangeデータベースコマンドとそのヘルパーsh.updateZoneKeyRange()およびsh.addTagRange()は、シャーディングされていないコレクションまたは存在しないコレクションで実行できます。

Tip

空のコレクションまたは存在しないコレクションをシャーディングする前にゾーンとゾーン範囲を定義することで、シャードコレクション操作は定義されたゾーン範囲のチャンクと、シャードキー値の全範囲をカバーする追加のチャンクを作成し、初期化を実行しますゾーン範囲に基づくチャンク分散。このように初期チャンクを作成して分散することで、ゾーンシャーディングの設定を迅速に行うことができます。初期分散後、バランサーは今後のチャンク分散を管理します。

例については、「空または存在しないコレクションのゾーンとゾーン範囲の事前定義」を参照してください。

セキュリティ

アクセス制御を強制するシャーディングされたクラスターの場合は、次のいずれかの特権を持つユーザーとして認証する必要があります。

データベース内のupdate shardsコレクションにある { または、あるいは、config
enableShardingクラスターリソースの

The clusterAdmin or clusterManager built-in roles have the appropriate permissions for issuing sh.addShardToZone(). See the Role-Based Access Control manual page for more information.

例

次の例では、 NYC 、 LAX 、 NRTの 3 つのゾーンを追加し、それぞれをシャードに関連付けます。

sh.addShardToZone("shard0000", "JFK")
sh.addShardToZone("shard0001", "LAX")
sh.addShardToZone("shard0002", "NRT")

シャードは複数のゾーンに関連付けることができます。次の例えでは、 LGAをshard0000に関連付けます。

sh.addShardToZone("shard0000", "LGA")

shard0000 は、 LGAゾーンとJFKゾーンの両方に関連付けられています。 MongoDB はバランスの取れたクラスター内で、いずれのゾーンでカバーされる読み取りと書込みをshard0000にルーティングします。

Tip

戻る

sh.addShardTag

sh.addTagRange