Redis 構成の変更
IBM Cloud® Databases for Redis では、一部の Redis 構成設定を変更して、データベースをユース・ケースに合わせて調整することができます。 典型的なRedisの設定では、コマンドラインから'CONFIG SET
を使って設定を変更できる。 デプロイメントに対しても
CONFIG SET
を使用できますが、デプロイメントでフェイルオーバーやノード再始動などのイベントがあると、変更は保持されません。 CONFIG SET
を使用した構成の変更は、テスト、評価、および調整の目的で使用できます。
以下のRedisコンフィギュレーションの制限に注意:
- Redis4: '
CONFIG
およびすべてのサブコマンドは非推奨となり、2021年11月30日以降に動作しなくなります - Redis 5: 制限なし
- Redis 6 (およびそれ以降):
CONFIG GET
およびCONFIG RESETSTAT
のみが表示されます
データベース構成に恒久的な変更を加えるには、Cloud DatabasesCLI プラグインまたは API を使用します。CLIプラグイン または API を使用して、デプロイメント用の設定ファイルに変更を書き込みます。
変更を行うには、変更する設定とそれらの新しい値を指定した JSON オブジェクトを送信します。 例えば、「maxmemory-policy
設定するには、CLIまたはAPIに次のように入力する。
{"configuration":{"maxmemory-policy":"allkeys-lru"}}
CLI の使用
cdb deployment-configuration-schema
コマンドでCloud Databasescli-pluginを通して可能な設定の構成スキーマを見る。
ibmcloud cdb deployment-configuration-schema <INSTANCE_NAME_OR_CRN>
設定を変更するには、「cdb deployment-configuration
コマンドを使用する。
ibmcloud cdb deployment-configuration <INSTANCE_NAME_OR_CRN> [@JSON_FILE | JSON_STRING]
このコマンドは、変更内容を JSON オブジェクトまたはファイルから読み取ります。
API の使用
2 つのデプロイメント構成エンドポイントがあり、1 つは構成スキーマを表示するためのエンドポイント、もう 1 つは構成を変更するためのエンドポイントです。 構成スキーマを表示するには、GET
要求を /deployments/{id}/configuration/schema
に送信します。
構成を変更するには、変更する設定を JSON オブジェクトとして PATCH
要求の本文に指定して /deployments/{id}/configuration
に送信します。
詳しくは、API リファレンスを参照してください。
選択可能な構成設定
設定の現在値を確認するには、CLIクライアント から「CONFIG GET
使用する。 CONFIG GET *
を使用すると、すべての設定を確認することができます。
設定の多くは、Redis をキャッシュとして構成するために使用されています。 詳しくは、キャッシュとしての Redis の構成のページを参照してください。
設定 | デフォルト | 注記 |
---|---|---|
maxmemory |
デプロイメントのメモリーの 80% | Redisに保存できるデータ量を決定します。 |
appendonly |
yes |
Redis のパーシスタンスを有効または無効にします。 |
maxmemory-policy |
noeviction |
maxmemory 制限に達したときの除去の動作を決定します。 |
maxmemory-samples |
5 |
Redis がキャッシュとして構成されている場合に LRU 除去アルゴリズムを調整します。 |
stop-writes-on-bgsave-error |
yes |
Redis は、失敗したバックアップ・スナップショットを検出すると、書き込みの受け入れを停止します。 |