AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
Docs Menu

getTransitionToD CompatibleConfigServerStatus(データベースコマンド)

getTransitionToDedicatedConfigServerStatus

埋め込みコンフィギュレーションサーバーから専用コンフィギュレーションサーバーへの移行のステータスを表示。

コマンドは、移行が失敗した場合はエラーとともに ok: 0 を返しますが、それ以外の場合は ok: 1 を返します。

専用のコンフィギュレーションサーバーへの移行を開始するには、startTransitionToDedicatedConfigServer コマンドを参照してください。

埋め込みコンフィギュレーションサーバーから専用コンフィギュレーションサーバーへの進行中の移行を停止するには、stopTransitionToDedicatedConfigServer コマンドを参照してください。

埋め込みコンフィギュレーションサーバーから専用コンフィギュレーションサーバーへの移行をコミットするには、commitTransitionToDedicatedConfigServer コマンドを参照してください。

Tip

In mongosh, this command can also be run through the sh.shardDrainingStatus() and.

Helper methods are convenient for mongosh users, but they may not return the same level of information as database commands. In cases where the convenience is not needed or the additional return fields are required, use the database command.

バージョン8.3の新機能。

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

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

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

注意

This command is not supported in MongoDB Atlas. See Modify your Atlas Sharded Cluster to drain the embedded config server.

このコマンドの構文は、次のとおりです。

db.adminCommand( {
getTransitionToDedicatedConfigServerStatus: 1
} )

このコマンドは、次の出力を返します。

フィールド
タイプ
説明

msg

string

バランサーによって実行されている現在のドレイン操作を提供します。

state

string

専用のコンフィギュレーションサーバーへの移行のステータスを提供します。

remaining

ドキュメント

専用コンフィギュレーションサーバーに完全に移行する前に、バランサーがシャードを空にするために実行する必要がある残りのタスクを表示します。

remaining.chunks

long

シャード上にまだ存在するチャンクの数を示します。

remaining.dbs

long

まだシャード上にあるデータベースの数を示します。

remaining.jumboChunks

long

シャード上にまだ存在する大きなチャンクの数を示します。

remaining.collectionsToMove

long

まだシャード上にあるコレクションの数を示します。

remaining.estimatedRemainingBytes

long

削除実行中のシャード上に残っているバイト数の推定値。

note

string

ユーザーに追加のメッセージを提供します。

dbsToMove

配列

ドレインシャードをプライマリシャードとして使用するデータベースを示します。専用コンフィギュレーションサーバーに完全に移行する前に、movePrimary コマンドを使用してこれらのデータベースを新しいシャードに手動で移動する必要があります。

collectionsToMove

配列

ドレイン中のシャードに保存されているシャーディングされていないコレクションを示します。専用コンフィギュレーションサーバーに完全に移行する前に、moveCollection コマンドを使用してこれらのコレクションを別のシャードに手動で移動する必要があります。

pendingRangeDeletions

long

削除中のシャードに残っている保留中の範囲削除の数。バランサーがすべてのチャンクとデータベースをコンフィギュレーションサーバーから移動した後の、transitionToDedicatedConfigServer操作中にのみ存在します。

firstNonEmptyCollection

string

削除中のシャード上の最初の空でないコレクション。バランサーがすべてのチャンクとデータベースをコンフィギュレーションサーバーから移動した後の transitionToDedicatedConfigServer 操作中にのみ表示されます。

authorizationを有効にしている場合は、 clusterManagerロールまたはremoveShardアクションを含む任意のロールが必要です。

埋め込みコンフィギュレーションサーバーがクラスターのデータベースの 1 つのプライマリでもある場合は、シャードからすべてのデータを移行した後、データベースを新しいシャードに手動で移動する必要があります。See the movePrimary command and the シャードからクラスターを削除する for more information.

シャーディングされていないコレクションの 1 つが 埋め込みコンフィギュレーションサーバー上にある場合は、まずそのコレクションを別のシャードに移行する必要があります。

シャーディングされていないコレクションを移行するには、moveCollection コマンドをご覧ください。

専用のコンフィギュレーションサーバーへの移行を開始するには、db.adminCommand() メソッドを使用して startTransitionToDedicatedConfigServer コマンドを実行する:

db.adminCommand( { startTransitionToDedicatedConfigServer: 1 } )

ドレイン操作のステータスを確認するには、getTransitionToDedicatedConfigServerStatus コマンドを使用します。

db.adminCommand( { getTransitionToDedicatedConfigServerStatus: 1 } )
{
"state" : "ongoing",
"remaining" : {
"chunks" : NumberLong(2),
"collectionsToMove" : NumberLong(1),
"dbs" : NumberLong(1),
"jumboChunks" : NumberLong(0),
"estimatedRemainingBytes" : NumberLong(18)
},
"msg" : "draining ongoing",
"dbsToMove" : [
"testDB"
],
"note" : "you need to call moveCollection for collectionsToMove and afterwards movePrimary for the dbsToMove",
"collectionsToMove" : [
"testDB.testCollUnsharded"
],
"ok" : 1,
"$clusterTime" : {
"clusterTime" : Timestamp(1772210444, 27),
"signature" : {
"hash" : BinData(0,"AAAAAAAAAAAAAAAAAAAAAAAAAAA="),
"keyId" : NumberLong(0)
}
},
"operationTime" : Timestamp(1772210444, 27)
}