tencent cloud

Tencent Cloud Distributed Cache (Redis OSS-Compatible)

disable-command-listによるコマンド無効化の設定

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-10-20 17:57:25
AI翻訳

操作シナリオ

Redisプロトコルの一部のコマンドを不適切に使用すると、サービスが不安定になったり、データが誤って削除されたりする可能性があります。例えば、KEYS、FLUSHALL、FLUSHDBなどのコマンドは実行時間が長すぎたり、影響範囲が大きすぎたりするため、本番環境ではオンラインでの使用を避けるべきです。Distributed Cacheは、設定パラメータdisable-command-listを設定することで、指定したコマンドを無効化できます。コマンドが無効化された後は、そのインスタンスでの実行は許可されません。
説明:
disable-command-listの値は1つまたは複数のコマンド名で、複数のコマンド間は英語のカンマで区切られます(例:flushall,flushdb,keys)。無効化をサポートするコマンドには、flushall、flushdb、keys、hgetall、eval、evalsha、scriptなどがあります。具体的なサポート範囲は、コンソールのパラメータリストにある「参考値」に記載されたコマンドに準じます。

前提条件

Distributed Cacheインスタンスを作成しました。
インスタンスのコンソールパラメータリストにdisable-command-listパラメータが表示されます。表示されない場合は、チケットを発行してバックエンドバージョンをアップグレードしてください(バージョンアップグレード時に接続が一時的に切断されますが、再接続すれば問題ありません)。

操作手順

ステップ1:disable-command-listパラメータの設定

1. Distributed Cacheコンソールにログインします。
2. 右側のインスタンスリストページの上部で、リージョンを選択します。
3. インスタンスリストで、対象インスタンスを見つけます。
4. 対象インスタンスIDをクリックし、インスタンス詳細ページに移動します。
5. インスタンス詳細ページで、パラメータ設定ページを選択します。
6. 変更可能なパラメータタブで、パラメータリストからdisable-command-listパラメータ行を見つけ、現在の実行パラメータ値列で、パラメータ値にマウスを合わせ、

をクリックしてパラメータ値を変更します。具体的な変更方法については、インスタンスパラメータの管理を参照してください。
説明:
無効化をサポートするコマンドには、flushall、flushdb、keys、hgetall、eval、evalsha、scriptなどがあります。具体的に無効化できるコマンドについては、実際のパラメータリストに記載されている参考値を基準としてください。
設定した無効化パラメータは2分以内に有効になります。無効化コマンドパラメータはRedisサービスを再起動せず、既存の接続に対して有効になります。


ステップ2:コマンド無効化の確認

クライアントからインスタンスに接続した後、無効化されたコマンドを実行すると、サーバーはエラーを返し、無効化が有効になったことを示します。例としてredis-cliを使用します:
redis-cli -h <インスタンス接続アドレス> -p <ポート> -a <パスワード>
<インスタンス接続アドレス>:<ポート>> keys *
(error) ERR command keys is disabled
説明:
上記のエラー情報は例示であり、実際に返されるメッセージはカーネルバージョンの実際の出力に準じます。

コマンド無効化の解除

変更可能なパラメータタブで、disable-command-listパラメータ行を見つけ、現在の実行パラメータ値の無効化リストから対応するコマンドを削除すると、そのコマンドの無効化を解除できます。

補足説明

無効化されたコマンドはインスタンス内で実行できなくなります。業務コードがこれらのコマンドに依存していないことを確認してから無効化を行い、コマンド無効化による業務エラーを回避してください。
時間計算量が高い、または危険性が高いコマンド(keys、flushall、flushdbなど)を優先的に無効化することをお勧めします。全量走査が必要な場合は、scanによる段階的な処理に変更することを推奨します。
パラメータ設定の変更履歴タブで、disable-command-listのこれまでの変更履歴を確認できます。

ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック