【Redis入門】SMEMBERSコマンドでセットの全要素を取得する方法

このチュートリアルでは、redis-cliでSMEMBERSコマンドを使用して、指定したキーに保存されたセット（Set）型の値からすべての要素を取得する方法を解説します。

SMEMBERSは、セットに格納されている全メンバーを一括で取得できるシンプルかつ便利なコマンドです。それでは、基本的な使い方を見ていきましょう。

構文

redis host:port> SMEMBERS <keyname>

戻り値

• 配列（Array）：セットに含まれるすべての要素を返します。
• エラー：キーが存在するものの、そのキーに保存されている値がセット型ではない場合にエラーを返します。

使用例

まず、SADDコマンドでセットに複数の要素を追加し、その後SMEMBERSで全要素を取得してみます。

# セットに要素を追加
redis host:port> SADD myset "apple" "banana" "orange"
(integer) 3

# セットの全要素を取得
redis host:port> SMEMBERS myset
1) "apple"
2) "banana"
3) "orange"

このように、SMEMBERSを実行すると、セット内のすべてのメンバーが配列形式で返されます。

補足ポイント

• キーが存在しない場合は、空の配列が返されます（エラーにはなりません）。
• セット内の要素数が非常に多い場合、SMEMBERSはO(N)の計算量で動作するため、大きなセットに対してはパフォーマンスへの影響に注意が必要です。そのような場合は、SSCANコマンドを使った段階的な走査を検討しましょう。
• セットは重複しない要素のコレクションであるため、取得結果にも同じ値は含まれません。

参考資料

1. SMEMBERSコマンド公式ドキュメント（Redis公式サイト）

以上が、Redisデータストアでセット型の値からすべての要素を取得する方法でした。この記事が役に立った場合は、ぜひコメントで感想を共有したり、他の方にもシェアしてください。