定義
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
apiStrict を に設定して1 Stable API Vtrue を使用している場合、 を使用してクラスターsetClusterParameter パラメータを変更することはできません。