Trong hướng dẫn này, chúng ta sẽ tìm hiểu cách tạo và thêm phần tử vào giá trị sorted set được lưu trữ tại khóa, bằng cách sử dụng lệnh redis ZADD.
Lệnh ZADD được dùng để thêm một hoặc nhiều phần tử với điểm số (score) tương ứng của chúng vào giá trị sorted set được lưu trữ tại một khóa được chỉ định. Nếu một phần tử được chỉ định đã tồn tại, điểm số của phần tử sẽ được cập nhật và phần tử được chèn lại vào vị trí đúng để đảm bảo thứ tự sắp xếp chính xác. Giá trị điểm số phải là biểu diễn chuỗi của số dấu phẩy động độ chính xác kép. Giá trị +inf và -inf là giá trị hợp lệ.
Nếu khóa không tồn tại trong kho dữ liệu, một sorted set mới sẽ được tạo trước khi thực hiện thao tác chèn. Nếu khóa tồn tại, nhưng giá trị lưu trữ tại khóa không phải là kiểu dữ liệu sorted set, lỗi sẽ được trả về.
Các đối số tùy chọn
Lệnh Redis ZADD nhận các đối số tùy chọn sau :-
- XX :- Chỉ cập nhật các phần tử đã tồn tại trong sorted set nhưng không bao giờ thêm phần tử mới.
- NX :- Chỉ thêm phần tử mới vào sorted set nhưng không bao giờ cập nhật phần tử đã tồn tại.
- CH :- Thay đổi giá trị trả về từ số phần tử mới được chèn, thành tổng số phần tử đã thay đổi. Phần tử thay đổi là phần tử mới thêm và phần tử đã tồn tại mà điểm số đã được cập nhật. Vì vậy, các phần tử được chỉ định trong dòng lệnh có cùng điểm số như trước đây sẽ không được đếm.
- INCR :- Nếu tùy chọn này được chỉ định, ZADD hoạt động như lệnh ZINCRBY. Chỉ một cặp score-element có thể được chỉ định trong chế độ này. Nó đặt giá trị chuỗi, chỉ nếu khóa đã tồn tại.
Các phần tử trong sorted set được sắp xếp theo thứ tự tăng dần theo điểm số của chúng. Đối với các phần tử có điểm số bằng nhau, thứ tự từ điển được duy trì. Cú pháp của lệnh Redis ZADD như sau :-
Cú pháp :-
redis host:port> ZADD <key> [XX|NX] [CH] [INCR] <score> <member> [<score> <member>]
Đầu ra :-
- (integer value), đại diện cho số phần tử được thêm vào sorted set, không kể các phần tử đã có mặt. - error, nếu khóa tồn tại và giá trị lưu trữ tại khóa không phải là sorted set.
Ví dụ :-
Tham khảo :-
- ZADD Command Docs
Đó là tất cả về cách tạo và thêm phần tử vào giá trị sorted set được lưu trữ trong kho dữ liệu redis. Nếu bạn thích, hãy chia sẻ suy nghĩ trong phần bình luận và chia sẻ với người khác.