Redis Keyspace Notifications

IMPORTANT Keyspace notifications là một tính năng mới hoạt động từ version 2.8.0

Tổng quan về tính năng

Keyspace notifications cho phép client đăng kí tới kênh pub/sub để nhận các sự kiện ảnh hưởng đến bộ dữ liệu của Redis theo một cách nào đó. để nhận các sự kiện ảnh hưởng đến bộ dữ liệu Redis theo một cách nào đó.

Ví dụ các sự kiện có thể nhận được như sau:

• Tất cả các commands ảnh hưởng đến key
• Tất cả các key tiếp nhận từ LPUSH operation
• Tất cả các khóa hết hạn trong database 0

Các sự kiện được phân phối bằng tầng Pub/Sub của Redis, vì vậy clients triển khai Pub/Sub có thể sử dụng tính năng này mà không cần phải chỉnh sửa

Bởi vì Redis Pub/Sub là bắn và quên hiện tại nên nó không cách nào sử dụng tính năng nếu ứng dụng của bạn yêu cầu notification về các event, nghĩa là nếu client Pub/sub của bạn ngăt kết nối và kết nội lại sau, tất cả các sự kiện được phân phối trong suốt thời gian cliebt bị ngắt kết nối sẽ bị mất

Trong tương lai sẽ có kế hoạch cho phép phân phối các sự kiện đáng tin cậy hơn, nhưng có lẽ điều này sẽ được giải quyết ở cấp độ chung hơn hoặc mang lại độ tin cậy cho chính Pub / Sub hoặc cho phép các Lua scripts chặn các messages Pub / Sub để thực hiện các hoạt động như push các sự kiện vào một danh sách.

Type of events

Keyspace notifications được triển khai gửi hai loại sự kiện riêng biệt cho mọi hoạt động ảnh hưởng đến không gian dữ liệu của Redis. Ví dụ, một hoạt động DEL với khóa có tên mykey trong cơ sở dữ liệu 0 sẽ kích hoạt việc phân phối hai thông báo, tương đương chính xác với hai lệnh PUBLISH sau:

Thật dễ dàng để xem làm thế nào một kênh cho phép nghe tất cả các sự kiện nhắm vào khóa mykey và kênh kia cho phép lấy thông tin về tất cả các khóa là mục tiêu của thao tác del.

Loại sự kiện đầu tiên, với tiền tố keyspace trong kênh được gọi là Key-space notification, trong khi loại thứ hai, với tiền tố là keyevent, được gọi là Key-event notification.

Trong ví dụ trên, một sự kiện del đã được tạo cho khóa mykey. Điều xảy ra là:

• Kênh Key-space nhận thông điệp tên của sự kiện.
• Kênh Key-event nhân thông ddieepje tên của key.

Nó chỉ có thể kích hoạt một loại notification để chỉ cung cấp tập hợp con các sự kiện mà chúng ta quan tâm.

Configuration

Theo mặc định các keyspace notification bị disable vì tính năng này sư dụng 1 ít CPU. Nó được enable bằng cách sử dụng notify-keyspace-events của redis.conf hoặc thông qua CONFIG SET.

Đặt tham số cho chuỗi rỗng sẽ disable notifications. Để kích hoạt tính năng, một chuỗi không rỗng được sử dụng, bao gồm nhiều ký tự, trong đó mỗi ký tự có một ý nghĩa đặc biệt theo bảng sau:

Ít nhất K hoặc E phải có mặt trong chuỗi, nếu không sẽ không có sự kiện nào được phân phối bất kể phần còn lại của chuỗi.

Chẳng hạn, để chỉ kích hoạt các sự kiện key-space cho danh sách, tham số cấu hình phải được đặt thành Kl, v.v.

Chuỗi KEA có thể được sử dụng để kích hoạt mọi sự kiện có thể.

Events generated by different commands

Các lệnh khác nhau tạo ra loại sự kiện khác nhau theo danh sách sau đây.

• DEL tạo một sự kiện del cho mọi khóa bị xóa.
• RENAME tạo hai sự kiện, sự kiện rename_from cho khóa nguồn và sự kiện rename_to cho khóa đích.
• EXPIRE tạo sự kiện hết hạn khi hết hạn được đặt cho key, hoặc một sự kiện đã hết hạn mỗi khi thời gian chờ tích cực được đặt trên một khóa dẫn đến khóa bị xóa (xem tài liệu EXPIRE để biết thêm thông tin).
• SORT tạo sự kiện sortstore khi STORE được sử dụng để đặt khóa mới. Nếu danh sách kết quả trống và tùy chọn STORE được sử dụng và đã có khóa hiện có tên đó, kết quả là khóa bị xóa, do đó, một sự kiện del được tạo trong điều kiện này
• SET và tất cả các biến thể của nó (SETEX, SETNX, GETSET) tạo ra các sự kiện đã đặt. Tuy nhiên, SETEX cũng sẽ tạo ra một sự kiện hết hạn.
• MSET tạo ra một sự kiện thiết lập riêng biệt cho mọi khóa.
• SETRANGE tạo ra một sự kiện setrange.
• INCR, DECR, INCRBY, DECRBY tất cả các lệnh tạo ra các sự kiện gia tăng.
• INCRBYFLOAT tạo ra một sự kiện incrbyfloat.
• APPEND tạo ra một sự kiện append.
• LPUSH and LPUSHX tạo ra một sự kiện lpush duy nhất, ngay cả trong trường hợp biến đổi.
• RPUSH and RPUSHX tạo ra một sự kiện rpush duy nhất, ngay cả trong trường hợp biến đổi.
• RPOP tạo ra một sự kiện rpop. Ngoài ra, một sự kiện del được tạo nếu khóa bị xóa vì phần tử cuối cùng trong danh sách đã được bật.
• LPOP tạo ra một sự kiện lpop. Ngoài ra, một sự kiện del được tạo nếu khóa bị xóa vì phần tử cuối cùng trong danh sách đã được bật.
• LINSERT tạo ra một sự kiện linsert.
• LSET tạo ra một sự kiện lset.
• LREM tạo ra một sự kiện lrem và thêm vào đó là một sự kiện del nếu danh sách kết quả trống và khóa bị xóa.
• LTRIM tạo ra một sự kiện ltrim và thêm vào đó là một sự kiện del nếu danh sách kết quả trống và khóa bị xóa.
• RPOPLPUSH and BRPOPLPUSH tạo ra một sự kiện rpop và một sự kiện lpush. Trong cả hai trường hợp, thứ tự luôn được đảm bảo (sự kiện lpush sẽ luôn được gửi sau sự kiện rpop). Ngoài ra, một sự kiện del sẽ được tạo nếu danh sách kết quả có độ dài bằng không và khóa bị xóa.
• HSET, HSETNX and HMSET tất cả tạo ra một sự kiện hset duy nhất.
• HINCRBY tạo ra sự kiện hincrby.
• HINCRBYFLOAT tạo ra một sự kiện hincrbyfloat.
• HDEL tạo một sự kiện hdel duy nhất và một sự kiện del bổ sung nếu hàm băm kết quả trống và khóa bị xóa.
• SADD tạo ra một sự kiện sadd duy nhất, ngay cả trong trường hợp biến đổi.
• SREM tạo một sự kiện srem duy nhất và một sự kiện del bổ sung nếu tập kết quả trống và khóa bị xóa.
• SMOVE tạo một sự kiện srem cho khóa nguồn và một sự kiện sadd cho khóa đích.
• SPOP tạo một sự kiện spop và một sự kiện del bổ sung nếu tập kết quả trống và khóa bị xóa.
• SINTERSTORE, SUNIONSTORE, SDIFFSTORE tạo các sự kiện sinterstore, sunionostore, sdiffstore tương ứng. Trong trường hợp đặc biệt, tập kết quả trống và khóa lưu trữ kết quả đã tồn tại, một sự kiện del được tạo kể từ khi khóa được xóa.
• ZINCR tạo ra một sự kiện zincr.
• ZADD tạo ra một sự kiện zadd duy nhất ngay cả khi nhiều yếu tố được thêm vào.
• ZREM tạo một sự kiện zrem duy nhất ngay cả khi nhiều phần tử bị xóa. Khi tập hợp được sắp xếp kết quả trống và khóa được tạo, một sự kiện del bổ sung được tạo.
• ZREMBYSCORE tạo ra một sự kiện zrembyscore duy nhất. Khi tập hợp được sắp xếp kết quả trống và khóa được tạo, một sự kiện del bổ sung được tạo.
• ZREMBYRANK tạo ra một sự kiện zrembyrank duy nhất. Khi tập hợp được sắp xếp kết quả trống và khóa được tạo, một sự kiện del bổ sung được tạo.
• ZINTERSTORE and ZUNIONSTORE tương ứng tạo ra các sự kiện zinterstore và zunionstore. Trong trường hợp đặc biệt, tập hợp được sắp xếp kết quả là trống và khóa lưu trữ kết quả đã tồn tại, một sự kiện del được tạo kể từ khi khóa được xóa..
• Mỗi khi một khóa có thời gian tồn tại được liên kết sẽ bị xóa khỏi bộ dữ liệu vì nó đã hết hạn, một sự kiện expired sẽ được tạo. -Mỗi khi khóa được lấy ra khỏi bộ dữ liệu để giải phóng bộ nhớ do chính sách tối đa, một sự kiện evicted được tạo ra.

IMPORTANT all the commands generate events only if the target key is really modified. For instance an SREM deleting a non-existing element from a Set will not actually change the value of the key, so no event will be generated.

IMPORTANT tất cả các lệnh tạo sự kiện chỉ khi khóa đích thực sự được sửa đổi. Chẳng hạn, SREM xóa phần tử không tồn tại khỏi Tập sẽ không thực sự thay đổi giá trị của khóa, do đó sẽ không có sự kiện nào được tạo.

Nếu nghi ngờ về cách các sự kiện được tạo cho một lệnh nhất định, điều đơn giản nhất để làm là xem chính bạn:

Tại thời điểm này, sử dụng redis-cli trong một thiết bị đầu cuối khác để gửi lệnh đến máy chủ Redis và xem các sự kiện được tạo:

Timing of expired events

Các khóa có thời gian sống liên quan đã hết hạn bởi Redis theo hai cách:

-Khi khóa được truy cập bởi command và được tìm thấy là hết hạn.

• Thông qua một hệ thống nền tìm kiếm các khóa hết hạn trong background, tăng dần, để có thể thu thập các khóa không bao giờ được truy cập.