Глоссарий

Durable Object alarm представляет собой механизм, позволяющий запланировать активацию Durable Object в определённый момент в будущем.

Закладка представляет собой преимущественно буквенно-цифровую строку, например 0000007b-0000b26e-00001538-0c3e87bb37b3db5cc52eedb93cd3b96b который представляет определённое состояние базы данных SQLite в конкретный момент времени. Bookmarks спроектированы так, чтобы их можно было сравнивать лексически: bookmark, представляющий более ранний момент времени, при обычном строковом сравнении будет меньше bookmark, представляющего более поздний момент.

Durable Object представляет собой отдельный экземпляр класса Durable Object. Durable Object глобально уникален (на него ссылаются по ID), служит единой точкой координации для всех отправляемых ему методов и запросов, а также имеет собственное постоянное хранилище, не разделяемое с другими Durable Object в пределах пространства имён.

Класс JavaScript, определяющий методы (RPC) и обработчики (fetch, alarm) как часть вашего Durable Object, и/или необязательный constructor. Все Durable Objects в одном пространстве имён используют одно и то же определение класса.

Название продукта, а также собирательное существительное для обозначения нескольких Durable Object.

Пока выполняется операция с хранилищем, объекту Durable Object не доставляются никакие события, кроме событий завершения этой операции. Все остальные события откладываются до тех пор, пока объект не завершит выполнение кода JavaScript и не перестанет ожидать операций с хранилищем. Говорят, что такие события ожидают открытия «входного шлюза» (input gate).

См. раздел «Durable Object».

Методы API, входящие в Storage API, которые поддерживают сохранение данных в формате «ключ-значение».

Миграция Durable Object представляет собой процесс сопоставления имени класса с состоянием времени выполнения. Начинайте миграцию Durable Object, когда вам нужно:

• Создайте новый класс Durable Object.
• Переименование класса Durable Object.
• Удалите класс Durable Object.
• Перенос существующего класса Durable Objects.

Логическая коллекция Durable Objects, использующих одно и то же определение класса Durable Object. Одно пространство имён может содержать десятки миллионов Durable Objects. Метрики собираются в рамках каждого пространства имён.

• Имя привязки пространства имён (то есть то, как оно будет доступно в коде Worker) задаётся в файле Wrangler в разделе durable_objects.bindings.name ключ. Обратите внимание, что имя привязки может не идентифицировать пространство имён в аккаунте однозначно. У каждого пространства имён есть уникальный ID пространства имён, который можно посмотреть в Cloudflare dashboard.
• Вы можете создать уникальный Durable Object в пространстве имён с помощью Методы пространства имён Durable Object.

Пока выполняется операция записи в хранилище, все новые исходящие сетевые сообщения задерживаются до завершения записи. Говорят, что эти сообщения ожидают открытия «выходного шлюза» (output gate). Если запись в итоге завершится с ошибкой, исходящие сетевые сообщения будут отброшены и заменены ошибками, а Durable Object будет остановлен и перезапущен с нуля.

Методы API, входящие в Storage API, которые поддерживают SQL-запросы.

Транзакционный и строго согласованный (сериализуемый) Storage API для сохранения данных в каждом Durable Object. Состояние, хранящееся в уникальном Durable Object, является «приватным» для этого Durable Object и недоступно для других Durable Object.

Storage API включает API типа «ключ-значение» (KV), SQL API и API точечного восстановления (PITR).

• Классы Durable Object с хранилищем типа «ключ-значение» могут использовать KV API.
• Классы Durable Object с хранилищем на основе SQLite могут использовать KV API, SQL API и PITR API.

По умолчанию класс Durable Object может использовать Storage API, работающий на основе key-value хранилища. Новые классы Durable Object могут по желанию перейти на использование Хранилище на основе SQLite.

Объект, который ссылается на уникальный Durable Object внутри пространства имен и позволяет обращаться к этому Durable Object через методы RPC или fetch API. Например, let stub = env.MY_DURABLE_OBJECT.get(id)