이 튜토리얼에서는 redis-cli에서 SADD 명령어를 사용하여 키에 저장된 집합(Set) 값을 생성하고 요소를 추가하는 방법을 알아봅니다.
SADD는 Redis의 기본 집합 연산 명령어로, 지정한 키가 데이터스토어에 이미 존재하면 해당 집합에 요소들을 추가합니다. 이때 중복된 요소는 자동으로 무시되며, 집합은 항상 고유한(unique) 멤버만 유지합니다. 반면 키가 존재하지 않으면 새로운 집합을 먼저 생성한 뒤 요소를 추가합니다.
문법(Syntax)
redis host:post> SADD <키 이름> <값 1> [ <값 2> ]
SADD는 한 번의 호출로 여러 개의 요소를 동시에 추가할 수 있어, 대량의 데이터를 삽입할 때도 효율적입니다.
반환값(Output)
- (integer) : 집합에 실제로 추가된 요소의 개수를 나타내는 정수 값입니다. 이때 이미 집합에 존재했던 요소는 개수에 포함되지 않습니다.
- error : 키가 존재하지만 해당 키에 저장된 값이 집합(Set) 타입이 아닌 경우 오류가 반환됩니다.
예제(Example)
위 예제에서처럼 SADD를 실행하면 새롭게 추가된 요소의 개수가 정수로 출력되는 것을 확인할 수 있습니다. 동일한 요소를 다시 추가하려고 하면 반환값이 0이 되며, 집합에는 변화가 없습니다.
참고 자료(References)
- SADD Command Docs
지금까지 Redis 데이터스토어에서 집합(Set) 값을 생성하고 요소를 추가하는 SADD 명령어의 사용법을 살펴보았습니다. 내용이 도움이 되었다면 댓글로 의견을 남겨주시고, 주변에도 공유해 주세요!