Redis
 Computer >> コンピューター >  >> プログラミング >> Redis

Redis HDELコマンド徹底解説 – ハッシュからフィールドを削除する方法

このチュートリアルでは、Redisに保存されたハッシュ値から1つ以上のフィールドを削除する方法を解説します。削除にはredis-cliでHDELコマンドを使用します。

HDELコマンドは、キーに格納されているハッシュ値から指定したフィールドを1つ以上削除します。ハッシュ内に存在しないフィールドが指定された場合、そのフィールドは単純に無視されます。

キーが存在しない場合は空のハッシュとして扱われ、戻り値として0が返されます。一方、キーは存在するものの、その値がハッシュ型ではない場合はエラーが返されます。

構文

redis host:port> HDEL <keyname> <field> [ field ... ]

戻り値

  • (integer): ハッシュから実際に削除されたフィールドの数（存在しなかったフィールドは含まれない）
  • エラー: キーが存在するが、格納されている値がハッシュ型ではない場合

実行例

Redis HDELコマンド徹底解説 – ハッシュからフィールドを削除する方法

補足ポイント

  • HDELは複数のフィールドを同時に指定できるため、1回のコマンド呼び出しでまとめて削除でき、ネットワークラウンドトリップを削減できます。
  • すべてのフィールドを削除すると、そのキー自体も自動的に削除されます。
  • 存在しないキーやフィールドに対して実行してもエラーにはならないため、冪等性のある処理が可能です。

参考資料

  1. HDELコマンド公式ドキュメント

以上が、Redisデータストア内のハッシュ値から1つ以上のフィールドを削除する方法の解説でした。この記事が役に立ったと思ったら、ぜひコメント欄で感想を共有したり、他の方にもシェアしてください。

  1. 【Redis入門】HSET・HSETNX・HMSETコマンドでハッシュのフィールドに値を設定する方法

    このチュートリアルでは、Redisのキーに格納されたハッシュ値の各フィールドに対して値を設定する方法を解説します。使用するのは HSET、HSETNX、HMSET の3つのコマンドです。それぞれの構文、戻り値、実行例を順番に見ていきましょう。 HSETコマンドとは HSET コマンドは、指定したキーに格納されているハッシュ内の指定フィールドに値を設定します。 フィールドがすでに存在する場合は、既存の値が上書きされます。 キーが存在しない場合は、設定操作の前にハッシュを保持する新しいキーが自動的に作成されます。 キーは存在するものの、格納されている値がハッシュ型でない場合はエラーが返されます。

  2. Redis HGETALLコマンドの使い方 – ハッシュに含まれるすべてのフィールドと値のペアを一括取得する方法

    このチュートリアルでは、Redisのキーに保存されたハッシュ値に含まれるすべてのフィールドと値のペアを取得する方法について解説します。この操作には、RedisのHGETALLコマンドを使用します。 HGETALLコマンドとは HGETALLコマンドは、指定したキーに保存されているハッシュ値に含まれるすべてのフィールドと、それぞれに関連付けられた値を返すコマンドです。 動作のポイントは以下の通りです。 キーが存在しない場合は、空のリストが返されます(エラーにはなりません)。 キーは存在するが、その値がハッシュ型ではない場合は、エラーが返されます。 構文 redis host:port>