sh.addShardToZone()

項目一覧

定義

互換性
動作
セキュリティ
例

定義

sh.addShardToZone(shard, zone)

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

重要

mongosh メソッド

このページでは、mongosh メソッドについて説明します。ただし、データベースコマンドや Node.js などの言語固有のドライバーのドキュメントには該当しません。

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

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

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

Parameter	タイプ	説明
シャード	string	ゾーンを関連付けるシャードの名前。
ゾーン	string	シャードに関連付けるゾーンの名前。

sh.addShardToZone()インスタンスに接続されている場合にのみmongos を発行します。

互換性

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

MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージドサービスです

重要

このコマンドは、M 0 、M 2 、M 5クラスターではサポートされていません。詳細については、「サポートされていないコマンド」を参照してください。

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

動作

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

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

Ranges

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

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

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

Tip

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

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

セキュリティ

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

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

clusterAdminまたはclusterManagerの組み込みロールには、 sh.addShardToZone()を発行するための適切な権限があります。詳細については、ロールベースのアクセス制御のマニュアルページを参照してください。

例

次の例では、 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