定義
setClusterParametersetClusterParameterは、クラスター パラメータの値を変更するための管理コマンドです。 クラスター パラメーターは、レプリカセットまたはシャーディングされたクラスター内のすべてのノードに影響する構成可能なパラメーターです。また、
adminデータベースに対してsetClusterParameterコマンドを発行する必要があります。
互換性
このコマンドは、次の環境でホストされている配置で使用できます。
MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン
重要
このコマンドは、 MongoDB Atlasクラスターではサポートされていません。 すべてのコマンドの Atlas サポートの詳細については、「 サポートされていないコマンド 」を参照してください。
構文
db.adminCommand( { setClusterParameter: { <parameter>: <value> } } )
例を含む使用可能なクラスター パラメーターについては、「自己管理型配置のクラスター パラメーター 」を参照してください。
動作
setClusterParameterはadminデータベースでのみ実行できます。 他のデータベースで コマンドを実行すると、MongoDB はエラーを返します。レプリカセット プライマリまたはシャーディングされたクラスターでのみ
setClusterParameterを実行できます。スタンドアロン配置では
setClusterParameterは実行できません。setClusterParameterは一度に 1 つのパラメーターのみを受け入れます。
アクセス制御
認証が有効になっている場合、 setClusterParameterはsetClusterParameterアクションへのアクセス権を持つロールを持つユーザーとして認証された場合にのみ機能します。
永続性
setClusterParameterを使用して行われたパラメーターの変更は、レプリカセットとシャーディングされたクラスターで永続化されます。 これにより、 setClusterParameterを使用して行われたパラメータの変更が再起動に耐えられるようになります。
Stable API
Stable API V 1を使用し、 apiStrictをtrueに設定している場合、 setClusterParameterを使用してクラスター パラメータを変更することはできません。