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

db.コレクション.getShardlocation()(mongoshメソッド)

db.collection.getShardLocation()

バージョン8.1の新機能。

コレクションが配置されているシャードと、コレクションがシャーディングされたかどうかを含むドキュメントを返します。

重要

mongosh メソッド

This page documents a mongosh method. This is not the documentation for database commands or language-specific drivers.

getShardLocation() メソッドは、$listClusterCatalog 集計ステージのラッパーです。

getShardLocation() メソッドは、次のフィールドを含むドキュメントを返します。

フィールド
タイプ
説明

shards

配列

コレクションのデータが存在するシャード。

sharded

ブール値

コレクションがシャーディングされたかどうかを示します。

シャーディングされていない配置で メソッドを実行する場合:

  • shards 配列は空です。

  • shardedフィールドは false です。

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

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

重要

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

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

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

db.<collection>.getShardLocation()

次の例では、sample_mflix.moviesコレクション内のデータを含むシャードを示しています。

use sample_mflix
db.movies.getShardLocation()
{ shards: [ 'shard01', 'shard02' ], sharded: true }

シャーディングされたクラスターでコマンドを実行するが、コレクションがシャーディングされていない場合、shardedフィールドはfalseで、shards配列にはconfigシャードのみが含まれます。

use sample_mflix
db.movies.getShardLocation()
{ shards: [ 'config' ], sharded: false }

シャーディングされていない配置で コマンドを実行すると、shardedフィールドは false で、shards 配列は空です。

use sample_mflix
db.movies.getShardLocation()
{ shards: [], sharded: false }
このページを評価