tencent cloud

Tencent Cloud Distributed Cache (Redis OSS-Compatible)

ハッシュファミリー

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

コマンドの紹介

Hashファミリーコマンドは、キー内のフィールド値(field-value)マッピング構造を操作するために使用され、「1つのKey=1つのオブジェクト」という方式でユーザー情報や設定項目などの構造化データを保存するのに適しています。その主要コマンドは機能に応じて以下の4種類に分類できます:
フィールドの読み書きと削除
HSET / HMSET:1つまたは複数のフィールドの値を設定します。
HGET / HMGET / HGETALL:単一フィールド、複数フィールド、または全フィールド値ペアを読み取ります。
HDEL:指定したフィールドを削除します。
HSETNX:フィールドが存在しない場合にのみ値を設定します。
フィールドの検索と統計
HEXISTS:フィールドが存在するかどうかを確認します。
HLEN:フィールド数を返します。
HKEYS / HVALS:すべてのフィールド名またはすべてのフィールド値をそれぞれ返します。
HSCAN:カーソル方式で大きなHash内のフィールドを増分的に反復処理し、一度のHGETALLによるブロッキングを回避します。
原子カウント
HINCRBY / HINCRBYFLOAT:数値型フィールドに対してアトミックにインクリメントし、ユーザーポイント、商品在庫などの多次元カウンターシーンに適しています。
高バージョン拡張コマンド(Redis 6.2+ / Valkey 8.0+)
HRANDFIELD:1つまたは複数のフィールドをランダムに返します。サンプリングやランダムレコメンデーションのシーンに適しています。
詳細については、Valkey公式ドキュメントのHashコマンドグループを参照してください。

コマンドサポート概要

基本コマンド:hdel、hexists、hget、hgetall、hincrby、hincrbyfloat、hkeys、hlen、hmget、hmset、hset、hsetnx、hstrlen、hvals、hscanは、Redis 2.8標準アーキテクチャおよび4.0、5.0、6.2、7.0バージョン、Valkey 8.0、9.0の標準アーキテクチャとクラスタアーキテクチャでサポートされています。
hrandfieldコマンド:Redis 6.2、7.0バージョンおよびValkey 8.0、9.0バージョンのみサポートされています。
フィールドレベル有効期限コマンド:hexpire、hpexpire、hexpireat、hpexpireat、hexpiretime、hpexpiretime、httl、hpttl、hpersist、hsetex、hgetex、hgetdelは、Valkey 9.0のみサポートされています。
クロスSlot制限:クラスタアーキテクチャでは、コマンド操作が複数の異なるSlotに分散されたHashキーに関わる場合、そのコマンドはサポートされません。

コマンド互換性マトリクス

Hash系コマンドの各バージョンおよびアーキテクチャにおけるサポート状況は以下の表の通りです(✓はサポート、✗は非サポート、—は該当コマンドにクロスSlotアクセスシーンが存在しないことを示します)。
コマンド
Valkey 9.0スタンダードアーキテクチャ
Valkey 9.0クラスタアーキテクチャ
Redis 7.0/Valkey 8.0スタンダードアーキテクチャ
Redis 7.0/Valkey 8.0クラスタアーキテクチャ
Redis 6.2スタンダードアーキテクチャ
Redis 6.2クラスタアーキテクチャ
Redis 5.0スタンダードアーキテクチャ
Redis 5.0クラスタアーキテクチャ
Redis 4.0スタンダードアーキテクチャ
Redis 4.0クラスタアーキテクチャ
Redis 2.8スタンダードアーキテクチャ
クラスタアーキテクチャのクロススロット対応
hdel
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
—
hexists
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
—
hget
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
—
hgetall
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
—
hincrby
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
—
hincrbyfloat
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
—
hkeys
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
—
hlen
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
—
hmget
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
—
hmset
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
—
hset
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
—
hsetnx
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
—
hstrlen
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
✗
—
hvals
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
—
hscan
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
✓
—
hrandfield
✓
✓
✓
✓
✓
✓
✗
✗
✗
✗
✗
—
hexpire
✓
✓
✗
✗
✗
✗
✗
✗
✗
✗
✗
—
hpexpire
✓
✓
✗
✗
✗
✗
✗
✗
✗
✗
✗
—
hexpireat
✓
✓
✗
✗
✗
✗
✗
✗
✗
✗
✗
—
hpexpireat
✓
✓
✗
✗
✗
✗
✗
✗
✗
✗
✗
—
hexpiretime
✓
✓
✗
✗
✗
✗
✗
✗
✗
✗
✗
—
hpexpiretime
✓
✓
✗
✗
✗
✗
✗
✗
✗
✗
✗
—
httl
✓
✓
✗
✗
✗
✗
✗
✗
✗
✗
✗
—
hpttl
✓
✓
✗
✗
✗
✗
✗
✗
✗
✗
✗
—
hpersist
✓
✓
✗
✗
✗
✗
✗
✗
✗
✗
✗
—
hsetex
✓
✓
✗
✗
✗
✗
✗
✗
✗
✗
✗
—
hgetex
✓
✓
✗
✗
✗
✗
✗
✗
✗
✗
✗
—
hgetdel
✓
✓
✗
✗
✗
✗
✗
✗
✗
✗
✗
—

ヘルプとサポート

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

フィードバック