getClusterParameter
定義
getClusterParameter
getClusterParameter
は、クラスター パラメータの値を取得するための管理コマンドです。 クラスター パラメーターは、シャーディングされたクラスター内のすべてのノードに影響する構成可能なパラメーターです。getClusterParameter
を実行するには、db.adminCommand( { command } )
メソッドを使用します。
互換性
このコマンドは、次の環境でホストされている配置で使用できます。
MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです
注意
このコマンドは、すべてのMongoDB Atlasクラスターでサポートされています。すべてのコマンドの Atlas サポートの詳細については、「 サポートされていないコマンド 」を参照してください。
MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン
構文
このコマンドの構文は、次のとおりです。
db.adminCommand( { getClusterParameter: <parameter> | [<parameter>, <parameter>] | "'*'" } )
コマンドフィールド
このコマンドは、次のフィールドを使用します。
フィールド | タイプ | 説明 |
---|---|---|
<parameter> | 文字列または複数の文字列の配列 | 次のいずれかを指定できます。
|
動作
getClusterParameter
はadmin
データベースでのみ実行できます。 他のデータベースで コマンドを実行すると、MongoDB はエラーを返します。レプリカセットまたはシャーディングされたクラスター内の任意のノードで
getClusterParameter
を実行できます。mongod
でgetClusterParameter
を実行すると、getClusterParameter
はキャッシュされたパラメータ値を返します。で
getClusterParameter
mongos
を実行すると、getClusterParameter
は コンフィギュレーションサーバー からクラスター パラメータの 永続 値を返します。
アクセス制御
認証が有効になっている場合、 getClusterParameter
はgetClusterParameter
アクションへのアクセス権を持つロールを持つユーザーとして認証された場合にのみ機能します。
MongoDB AtlasユーザーにはatlasAdmin
ロールが必要です。
例
注意
次の例の出力は、実行中の MongoDB 配置の特定の構成によって異なる場合があります。
Retrieve Single Cluster Parameter
次の操作では、 hostName
の値を使用してadmin
データベースでgetClusterParameter
を実行し、 hostName
という名前の仮想クラスター パラメータの値を取得します。
use admin db.adminCommand( { getClusterParameter : "hostName" } )
Retrieve Multiple Cluster Parameters
次の操作では、 hostName
とtestParameter
の値を使用してadmin
データベースでgetClusterParameter
を実行し、 hostName
とtestParameter
という名前の仮想クラスター パラメータの値を取得します。
use admin db.adminCommand( { getClusterParameter: [ "hostName", "testParameter" ] } )
Retrieve All Cluster Parameters
次の操作では、 '*'
の 値を持つgetClusterParameter
を実行し、すべてのクラスター パラメータから 値を取得します。
use admin db.adminCommand( { getClusterParameter : '*' } )