Redis SCARDコマンド徹底解説 – セットの要素数を取得する方法

このチュートリアルでは、redis-cliでSCARDコマンドを使用して、指定したキーに保存されたセット（Set）型の値のサイズ（要素数）を取得する方法を解説します。SCARDは、Redisにおけるセット操作の基本コマンドの一つで、パフォーマンスが求められる場面でも高速に動作することが特徴です。

構文

redis host:post> SCARD <keyname>

キー名を引数として指定するだけで、そのキーに格納されているセットの要素数を取得できます。

戻り値

• (integer) 値：セットに含まれる要素の数を整数で返します。
• (integer) 0：指定したキーが存在しない場合に返されます。
• エラー：キーは存在するものの、その値がセット型ではない場合（例：文字列やリストなど）にエラーが返されます。

使用例

まず、SADDコマンドでセットに複数の要素を追加し、その後SCARDで要素数を確認してみましょう。

redis host:post> SADD myset "apple" "banana" "orange"
(integer) 3

redis host:post> SCARD myset
(integer) 3

このように、セットに3つの要素が追加されているため、SCARDは「3」を返します。また、存在しないキーに対して実行した場合は「0」が返されるため、キーの存在確認としても利用できます。

補足ポイント

• SCARDはO(1)の時間計算量で動作するため、大量の要素を含むセットでも瞬時にサイズを取得できます。
• 重複する要素はセットに登録されないため、SCARDが返す値はユニークな要素の数となります。
• SADDやSREMと組み合わせることで、タグ管理やユーザーリストのカウントなど、さまざまなユースケースに活用できます。

参考資料

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

以上が、Redisデータストア内のセット型の値のサイズを取得する方法についての解説でした。この記事が役に立った場合は、ぜひコメント欄でご意見をお聞かせください。また、他の方にもシェアしていただけると嬉しいです。