پایگاه داده

چیت‌شیت Redis و راهبرد کش

الگوهای انتخاب کلید، انقضا و cache invalidation برای استفادهٔ قابل اتکا از Redis. نوع String برای متن، شمارنده و دادهٔ سریال‌شده مناسب است. دستورها از خواندن و نوشتن پایه تا افزایش عددی، نوشتن شرطی و تعیین انقضا را پوشش می‌دهند؛ برای چند فرمان مرتبط، نتیجه و رفتار اتمیک را در نسخهٔ Redis خود بررسی کنید. Set مجموعه‌ای بدون ترتیب با عضوهای یکتا است. برای عضویت، حذف تکرار، انتخاب نمونه و محاسبهٔ اجتماع یا اشتراک میان مجموعه‌ها از فرمان‌های این بخش استفاده کنید. از این صفحه به‌عنوان مرجع سریع استفاده کنید و مثال‌ها و نکته‌ها را با نسخهٔ ابزار، نیاز و شرایط واقعی پروژهٔ خود تطبیق دهید.

NOVIN SKILLS / DIGITAL STUDIO

نوشتن و خواندن مقدار

SET مقدار را می‌نویسد و GET مقدار همان کلید را برمی‌گرداند.

1SET user:42:name "Nina"2GET user:42:name

نوشتن با انقضای زمانی

EXPIRE زمان را بر حسب ثانیه و PEXPIRE بر حسب میلی‌ثانیه می‌گیرد؛ TTL و PTTL زمان باقی‌مانده را نشان می‌دهند.

1SET session:abc "active"2EXPIRE session:abc 3003TTL session:abc4SET cache:item "value" EX 60

نوشتن فقط در صورت نبود کلید

NX از بازنویسی کلید موجود جلوگیری می‌کند؛ برای قفل‌های توزیع‌شده باید انقضا، توکن یکتا و آزادسازی امن را هم طراحی کنید.

1SET lock:report "token-123" NX EX 30

افزایش و کاهش شمارنده

INCR و DECR مقدار عددی را یک واحد تغییر می‌دهند؛ INCRBY و DECRBY اندازهٔ تغییر را مشخص می‌کنند.

1INCR page:views2INCRBY inventory:42 53DECR inventory:424DECRBY inventory:42 3

افزایش اعشاری و عملیات Bit

INCRBYFLOAT شمارندهٔ اعشاری را تغییر می‌دهد؛ فرمان‌های BIT برای خواندن یا تغییر بیت‌های رشته و محاسبهٔ عملگرهای بیتی کاربرد دارند.

1INCRBYFLOAT cart:total 1.252GETBIT feature:flags 33SETBIT feature:flags 3 14BITCOUNT feature:flags5BITOP OR flags:combined flags:a flags:b

افزودن و جایگزینی بخشی از رشته

APPEND متن را به انتهای مقدار اضافه می‌کند، STRLEN طول بایتی آن را می‌دهد و SETRANGE بخشی از رشته را از offset مشخص جایگزین می‌کند.

1APPEND message " Redis"2STRLEN message3SETRANGE message 0 "Hello"

خواندن چند مقدار و بازه

MGET چند کلید را در یک درخواست می‌خواند و GETRANGE بازه‌ای از رشته را با offsetهای شامل ابتدا و انتها برمی‌گرداند.

1MGET user:42:name user:42:role2GETRANGE article:title 0 9

نوشتن و دریافت مقدار قبلی

MSET چند کلید را یک‌جا مقداردهی می‌کند؛ GETSET مقدار تازه را می‌نویسد و مقدار قبلی را برمی‌گرداند.

1MSET setting:theme "dark" setting:locale "fa"2GETSET status "ready"

افزودن عضو و شمارش مجموعه

SADD عضوهای تازه را اضافه می‌کند و SCARD تعداد عضوهای یکتای مجموعه را می‌شمارد.

1SADD tags:article:7 "redis" "database" "cache"2SCARD tags:article:7

فهرست‌کردن و بررسی عضویت

SMEMBERS همهٔ اعضا را می‌خواند و SISMEMBER وجود یک عضو مشخص را بررسی می‌کند.

1SMEMBERS tags:article:72SISMEMBER tags:article:7 "redis"

حذف یا انتقال عضو

SREM عضوها را حذف می‌کند؛ SMOVE یک عضو را از مجموعهٔ مبدأ به مجموعهٔ مقصد منتقل می‌کند.

1SREM tags:article:7 "cache"2SMOVE tags:article:7 tags:article:8 "redis"

اجتماع، اشتراک و تفاضل

SUNION، SINTER و SDIFF مجموعه‌های موقت نتیجه می‌سازند؛ گونه‌های STORE خروجی را در کلید دیگری ذخیره می‌کنند.

1SUNION team:design team:frontend2SINTER team:design team:frontend3SDIFF team:design team:frontend4SINTERSTORE team:shared team:design team:frontend5SUNIONSTORE team:all team:design team:frontend6SDIFFSTORE team:design:only team:design team:frontend

برداشتن یا انتخاب عضو تصادفی

SPOP عضو را از مجموعه خارج می‌کند؛ SRANDMEMBER عضو تصادفی را بدون حذف برمی‌گرداند.

1SPOP queue:pending2SRANDMEMBER featured:items 3

افزودن عضو به ابتدا یا انتها

LPUSH و RPUSH عضو را در ابتدا یا انتهای فهرست اضافه می‌کنند؛ نسخهٔ X فقط وقتی فهرست موجود باشد عمل می‌کند.

1LPUSH jobs:ready "job-3" "job-2"2RPUSH jobs:ready "job-4"3LPUSHX jobs:ready "job-1"

خواندن بازه و طول فهرست

LRANGE بازهٔ شامل ابتدا و انتها را می‌خواند؛ برای همهٔ عضوها معمولاً از 0 و -1 استفاده می‌شود.

1LRANGE jobs:ready 0 -12LLEN jobs:ready3LINDEX jobs:ready 0

برداشتن عضو از دو سر

LPOP و RPOP عضو را هم‌زمان برمی‌گردانند و از فهرست حذف می‌کنند؛ در Redis جدید می‌توان تعداد عضو را نیز تعیین کرد.

1LPOP jobs:ready2RPOP jobs:ready

برداشتن مسدودشونده برای صف

BLPOP و BRPOP تا رسیدن عضو یا پایان timeout منتظر می‌مانند؛ برای workerهای هم‌زمان رفتار مصرف و بازیابی پیام را طراحی کنید.

1BLPOP jobs:ready 52BRPOP jobs:retry 5

درج، تغییر و حذف عضو

LINSERT نسبت به یک pivot درج می‌کند، LSET عضو یک index را عوض می‌کند و LREM تعداد مشخصی تطبیق را حذف می‌کند.

1LINSERT jobs:ready BEFORE "job-4" "job-3a"2LSET jobs:ready 0 "job-urgent"3LREM jobs:ready 1 "job-old"

برش فهرست و جابه‌جایی میان صف‌ها

LTRIM فهرست را به بازه نگه می‌دارد؛ LMOVE یا RPOPLPUSH عضو را از یک فهرست به دیگری منتقل می‌کند.

1LTRIM events:recent 0 992LMOVE jobs:ready jobs:processing LEFT RIGHT

ثبت و دریافت یک فیلد

HSET فیلد را می‌نویسد، HGET آن را می‌خواند و HEXISTS وجود فیلد را می‌سنجد.

1HSET user:42 name "Nina" role "editor"2HGET user:42 name3HEXISTS user:42 role

خواندن چند فیلد یا همهٔ رکورد

HMGET چند فیلد انتخابی و HGETALL همهٔ فیلدها و مقدارها را برمی‌گرداند.

1HMGET user:42 name role2HGETALL user:42

فهرست فیلدها و مقدارها

HKEYS فقط نام فیلدها و HVALS فقط مقدارها را می‌دهد؛ HLEN تعداد فیلدهای hash را می‌شمارد.

1HKEYS user:422HVALS user:423HLEN user:42

افزایش عددی و حذف فیلد

HINCRBY مقدار عددی یک فیلد را افزایش می‌دهد و HDEL فیلدهای انتخابی را حذف می‌کند.

1HINCRBY product:7 stock 22HDEL user:42 temporary_note

افزودن، رتبه‌بندی و امتیاز

ZADD عضو و score را ثبت می‌کند؛ ZRANGE بر اساس امتیاز صعودی، ZRANK رتبه و ZSCORE امتیاز عضو را می‌دهد.

1ZADD leaderboard 120 "user:42" 95 "user:17"2ZRANGE leaderboard 0 9 WITHSCORES3ZRANK leaderboard "user:42"4ZSCORE leaderboard "user:42"

فیلتر و تغییر score

ZCOUNT تعداد عضوهای در بازهٔ امتیاز را می‌شمارد و ZINCRBY امتیاز عضو را افزایش می‌دهد.

1ZCOUNT leaderboard 100 2002ZINCRBY leaderboard 10 "user:17"3ZRANGE leaderboard 0 9 REV WITHSCORES4ZREM leaderboard "user:17"

ترکیب مجموعه‌های مرتب

ZUNIONSTORE و ZINTERSTORE اجتماع یا اشتراک را در مقصد می‌نویسند؛ وزن‌دهی و aggregate را مطابق معنی امتیازها انتخاب کنید.

1ZUNIONSTORE weekly:score 2 score:games score:bonus WEIGHTS 1 2 AGGREGATE SUM2ZINTERSTORE active:ranking 2 score:games users:active

ثبت و خواندن مختصات

GEOADD مختصات longitude/latitude و نام مکان را می‌پذیرد؛ GEOPOS مختصات و GEODIST فاصله را با واحد مشخص برمی‌گرداند.

1GEOADD stores 51.3890 35.6892 "tehran"2GEOPOS stores "tehran"3GEODIST stores "tehran" "shiraz" km

جست‌وجوی نزدیک‌ترین عضوها

GEOSEARCH عضوها را پیرامون نقطه یا عضو جست‌وجو می‌کند؛ GEOSEARCHSTORE نتیجه را در یک Sorted Set ذخیره می‌کند.

1GEOSEARCH stores FROMMEMBER "tehran" BYRADIUS 20 km ASC COUNT 10

ثبت مقدار یکتا و تخمین شمارش

PFADD مقدارها را به ساختار تخمینی اضافه می‌کند و PFCOUNT شمارش تقریبی یک یا چند ساختار را می‌دهد.

1PFADD visits:2025-04-01 "user:42" "user:17"2PFCOUNT visits:2025-04-01

ادغام شمارنده‌ها

PFMERGE ساختارهای ورودی را در کلید مقصد ادغام می‌کند؛ خروجی همچنان تخمینی است.

1PFMERGE visits:week visits:day:1 visits:day:2 visits:day:32PFCOUNT visits:week

افزودن و خواندن رخداد Stream

XADD رخداد را با شناسهٔ خودکار اضافه می‌کند؛ XRANGE بازه‌ای از رخدادها و XREAD رخدادهای بعد از شناسه را می‌خواند.

1XADD orders * order_id 1042 status "created"2XRANGE orders - +3XREAD COUNT 10 STREAMS orders 0

گروه مصرف‌کننده و تأیید پیام

XGROUP گروه را می‌سازد، XREADGROUP پیام را به consumer می‌دهد و XACK پردازش موفق را تأیید می‌کند.

1XGROUP CREATE orders order-workers 0 MKSTREAM2XREADGROUP GROUP order-workers worker-1 COUNT 5 STREAMS orders >3XACK orders order-workers 1710000000000-0

یافتن و بررسی کلید

EXISTS وجود کلید، TYPE نوع داده، TTL زمان باقی‌مانده و SCAN پیمایش تدریجی کلیدها را نشان می‌دهد.

1EXISTS cache:product:72TYPE cache:product:73TTL cache:product:74SCAN 0 MATCH cache:product:* COUNT 100

تغییر ماندگاری یا نام کلید

PERSIST انقضا را حذف می‌کند، RENAME کلید را تغییر نام می‌دهد و UNLINK حذف را به شکل ناهمگام انجام می‌دهد.

1PERSIST cache:product:72RENAME cache:old cache:new3UNLINK cache:expired

اطلاعات اتصال و سرور

PING اتصال را بررسی می‌کند، INFO اطلاعات وضعیت می‌دهد، DBSIZE تعداد کلیدهای پایگاه انتخاب‌شده و SELECT شمارهٔ پایگاه را عوض می‌کند.

1PING2INFO server3DBSIZE4SELECT 1

فرمان‌های حساس و پاک‌سازی

FLUSHDB داده‌های پایگاه انتخابی و FLUSHALL همهٔ پایگاه‌ها را پاک می‌کند؛ CONFIG و ACL نیز تنظیمات و دسترسی‌ها را تغییر می‌دهند.

1# فقط برای محیط آزمایشی و پس از تأیید مقصد2FLUSHDB

برای استفاده در پروژه

نکات کلیدی

۱
کلیدها را namespaced و قابل‌فهم بسازید؛ نسخه یا نوع منبع را در نام بگنجانید.
۲
برای دادهٔ کش‌شده TTL تعیین کنید تا مقدار قدیمی دائمی نماند.
۳
الگوی cache-aside را با خواندن از کش و پرکردن از منبع به‌کار ببرید.
۴
هنگام تغییر منبع، invalidation یا بازسازی کش را صریح طراحی کنید.
۵
برای جلوگیری از stampede، درخواست‌های هم‌زمان را هماهنگ یا بازهٔ انقضا را پراکنده کنید.
۶
مقدارها را محدود و اندازهٔ payload را کنترل کنید.
۷
از Redis به‌عنوان تنها منبع حقیقت استفاده نکنید مگر دوام داده عمداً طراحی شده باشد.
۸
timeout، اتصال مجدد و رفتار خطای کش را طوری تنظیم کنید که سرویس در دسترس بماند.
۹
دسترسی شبکه و رمز Redis را محدود و از افشای پورت عمومی جلوگیری کنید.
۱۰
hit rate، حافظه، eviction و latency را پایش کنید.
۱۱
برای کلید cache، TTL و سیاست invalidation را کنار هم طراحی کنید؛ TTL به‌تنهایی تازگی داده را تضمین نمی‌کند.
۱۲
برای operation چندمرحله‌ای اتمیک از primitive مناسب مثل Lua script یا transaction پشتیبانی‌شده استفاده کنید.
۱۳
برای پیمایش کلیدها در محیط پرترافیک از SCAN به‌جای KEYS استفاده کنید و حلقهٔ cursor را تا پایان کامل کنید.
۱۴
پیش از FLUSHDB، FLUSHALL یا تغییر ACL و CONFIG، مقصد اتصال و اثر فرمان را دوباره تأیید کنید.