Как использовать EXPIREAT и PEXPIREAT в Redis

Redis — одна из самых популярных in-memory баз данных, используемых для кэширования, хранения сессий, реализации очередей и управления временными данными. Одной из ключевых особенностей Redis является возможность установки времени жизни (TTL) для ключей. Два основных команды, которые позволяют это делать — `EXPIREAT` и `PEXPIREAT`. Они дают точный контроль над временем удаления ключа, основываясь на абсолютных временных метках. В отличие от относительных команд вроде `EXPIRE` или `PEXPIRE`, эти инструкции указывают конкретное время, когда ключ должен быть удален.

Что такое EXPIREAT и PEXPIREAT: базовое понимание

Команды `EXPIREAT` и `PEXPIREAT` в Redis используются для установки времени истечения срока действия ключа по абсолютной временной метке. Это означает, что вы указываете не сколько времени должно пройти, а конкретный момент, когда ключ перестанет существовать.
`EXPIREAT` принимает временну́ю метку в формате Unix timestamp (секунды с 1 января 1970 года). Например, если вы хотите, чтобы ключ удалился ровно в 15:30:00 по UTC 16 апреля 2026 года, вы можете рассчитать соответствующую метку и передать её в команду. Это обеспечивает высокую точность и предсказуемость поведения.
`PEXPIREAT` работает аналогично, но использует миллисекундную точность. Это особенно важно в современных высоконагруженных системах, где операции происходят быстрее одной секунды. Миллисекундная временная метка позволяет задавать TTL с гораздо большей гранулярностью.

Как работают EXPIREAT и PEXPIREAT: принцип действия

Redis управляет сроком жизни ключей с помощью внутреннего механизма, который периодически проверяет и удаляет просроченные записи. Этот процесс называется lazy expiration и active expiration. При использовании `EXPIREAT` или `PEXPIREAT` Redis сохраняет абсолютную метку времени, после которой ключ считается недействительным.
Когда клиент устанавливает `EXPIREAT key 1744814400`, Redis интерпретирует это как «удали ключ *key*, когда системное время достигнет 1744814400». Эта метка соответствует определённому моменту в будущем. Аналогично, `PEXPIREAT key 1744814400000` укажет на тот же момент, но выраженный в миллисекундах.
Redis хранит эту информацию во внутренней структуре, связанной с каждым ключом. При попытке доступа к ключу система сначала проверяет, не истёк ли его срок. Если да — ключ немедленно удаляется, и операция возвращает `nil`. Кроме того, фоновый процесс регулярно сканирует случайные наборы ключей, чтобы очистить те, что давно просрочены.

Синтаксис и практические примеры использования

Обе команды имеют простой синтаксис:

• EXPIREAT key timestamp — где timestamp в секундах.
• PEXPIREAT key milliseconds-timestamp — где временная метка в миллисекундах.

Пример 1: Установка истечения срока в 15:30:00 UTC 16 апреля 2026 года.

SET promo_code "SPRING26"
EXPIREAT promo_code 1744814400

В этом случае ключ `promo_code` будет автоматически удалён после указанного времени.
Пример 2: Использование миллисекундной точности.

SET session:user:12345 "active"
PEXPIREAT session:user:12345 1744814400500

Теперь сессия будет удалена с точностью до полумиллисекунды.
Пример 3: На языке Python с библиотекой redis-py.

1. Установите библиотеку: pip install redis
2. Напишите код:

import redis
import time
r = redis.Redis(host='localhost', port=6379, db=0)
# Установка ключа
r.set("temp_data", "important_value")
# Рассчитываем время: +1 час от текущего момента
future_time_sec = int(time.time()) + 3600
r.expireat("temp_data", future_time_sec)
# То же самое в миллисекундах
future_time_ms = int(time.time() * 1000) + 3600000
r.pexpireat("temp_data", future_time_ms)

Различия между EXPIRE/PEXPIRE и EXPIREAT/PEXPIREAT

Понимание различий между относительными (`EXPIRE`, `PEXPIRE`) и абсолютными (`EXPIREAT`, `PEXPIREAT`) командами критически важно для правильного проектирования системы.

Основное преимущество абсолютных команд — независимость от момента вызова. Представьте, что вы отправляете задачу в очередь, и она должна быть обработана строго в 18:00. Если вы используете `EXPIRE`, вам нужно каждый раз пересчитывать разницу. С `EXPIREAT` достаточно один раз указать цель.

Типичные сценарии применения

Команды `EXPIREAT` и `PEXPIREAT` находят применение в реальных проектах, где важна синхронизация и точность.

Кэширование данных с фиксированным временем обновления

Вы получаете курс валют раз в час по расписанию. Чтобы кэш обновлялся одновременно со свежими данными, вы можете установить `EXPIREAT` на момент следующего обновления.

SET exchange_rate_usd_eur "0.92"
EXPIREAT exchange_rate_usd_eur 1744818000 # 16:40:00 UTC

Такой подход исключает риск преждевременного или запоздалого сброса кэша.

Ограничение действия токенов и сессий

В системах аутентификации часто требуется, чтобы токен был действителен до определённого времени. Например, JWT с временем истечения (exp claim). Вы можете синхронизировать TTL в Redis с этим значением.

SET token:abc123 "{...}"
PEXPIREAT token:abc123 1744814400000

Это гарантирует, что данные будут удалены одновременно с потерей валидности токена.

Очереди с временными ограничениями

В системах обработки событий можно использовать Redis как временную очередь. Сообщение помещается в список, а ключ с метаданными помечается на удаление через `PEXPIREAT`.

Глобальная синхронизация в микросервисах

Когда несколько сервисов работают с одним Redis-экземпляром, использование абсолютного времени позволяет всем участникам иметь единое представление о сроках жизни данных.

Распространённые ошибки и как их избежать

Несмотря на простоту, при использовании этих команд встречаются типичные ошибки.

Ошибка 1: Передача неправильного формата временной метки

Частая ошибка — передача строки вместо числа или использование локального времени без учёта часового пояса. Все временные метки в Redis должны быть в UTC и в числовом формате.

• ❌ Неправильно: EXPIREAT key "2026-04-16T15:30:00Z"
• ✅ Правильно: EXPIREAT key 1744814400

Ошибка 2: Использование прошедшего времени

Если вы случайно укажете прошедшую временную метку, ключ будет немедленно помечен как просроченный.

EXPIREAT old_key 1600000000 # Удалится сразу

Перед установкой проверяйте, что метка больше текущего времени.

Ошибка 3: Смешивание EXPIREAT и PERSIST

Если вы применили `PERSIST` к ключу (что удаляет TTL), а затем снова вызвали `EXPIREAT`, всё сработает. Но если логика приложения зависит от наличия TTL, убедитесь, что вы не перезаписываете его случайно.

Ошибка 4: Зависимость от системного времени сервера

Если системные часы на сервере Redis сбиты, поведение `EXPIREAT` может стать непредсказуемым. Убедитесь, что используется NTP-синхронизация.

Экспертные рекомендации и лучшие практики

Чтобы эффективно использовать `EXPIREAT` и `PEXPIREAT`, следуйте проверенным подходам.

• Используйте абсолютные временные метки, когда логика приложения зависит от конкретного времени, например, расписания, акции, подписки.
• Предпочитайте `PEXPIREAT` при работе с событиями, происходящими чаще одной секунды.
• Централизуйте генерацию временных меток в приложении, чтобы избежать расхождений между сервисами.
• Логируйте установку TTL для ключей в критически важных системах.
• Тестируйте поведение при граничных значениях: ровно в момент истечения, за миллисекунду до и после.

При проектировании API, которое взаимодействует с Redis, документируйте, какой тип времени ожидается — абсолютный или относительный. Это снижает вероятность ошибок интеграции.

Вопросы и ответы

Заключение

Команды `EXPIREAT` и `PEXPIREAT` — мощные инструменты для точного управления временем жизни ключей в Redis. В отличие от относительных аналогов, они позволяют задавать конкретный момент удаления, что особенно ценно в синхронизированных и распределённых системах. Использование абсолютных временных меток повышает предсказуемость и упрощает отладку.

• EXPIREAT работает с Unix-временем в секундах, PEXPIREAT — в миллисекундах.
• Абсолютные команды обеспечивают точную синхронизацию между сервисами.
• Используйте PEXPIREAT для высоконагруженных систем, где важна миллисекундная точность.
• Избегайте распространённых ошибок: неверный формат времени, прошедшие метки, отсутствие NTP.
• Всегда проверяйте результат выполнения и логируйте критические операции с TTL.