Docs Menu
Docs Home
/
MongoDBマニュアル
/
参照
/
mongosh メソッド
/
シャーディング

sh.splitAt()

項目一覧

  • 定義
  • 互換性
  • 検討事項
  • 動作
  • 例

定義

sh.splitAt(namespace, query)

クエリによって指定されたシャードキー値でチャンクを分割します。

重要

mongosh メソッド

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

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

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

メソッドは次の引数を取ります。

Parameter
タイプ
説明

namespace

string

名前空間（ 分割するチャンクを含むシャーディングされたコレクションの<database>.<collection> ）。

query

ドキュメント

チャンクを分割するシャードキー値を指定するクエリ ドキュメント。

互換性

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

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

重要

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

  • MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

  • MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

検討事項

ほとんどの場合、チャンクは MongoDB 内の自動プロセスに分割されたままにしておく必要があります。 ただし、 シャーディングされた クラスター を最初に配置するときに、 などのメソッドを使用して空のコレクションを手動で 事前分割sh.splitAt() するのに役立つ場合があります。

動作

sh.splitAt() は、元の チャンク を 2 つのチャンクに分割します。 1 つのチャンクには、元の下限（包括的）から始まり、指定されたシャードキー値（排他的）で終わるシャードキー範囲があります。 もう 1 つのチャンクには、指定されたシャードキー値（包括的）を下限として始まり、元の上限（排他的）で終わるシャードキー範囲があります。

代わりに、中央値でチャンクを分割するにはsh.splitFind()を参照してください。

例

シャーディングされたコレクションtest.fooの場合、次の例では、シャードキー値x: 70でチャンクを分割します。

sh.splitAt( "test.foo", { x: 70 } )

戻る

sh.shardCollection

次へ

sh.splitFind