Перейти к основному содержимому

Страница «Данные»

Страница «Данные» предназначена для просмотра записей процессов и агентов, удаления записей, очистки коллекций, управления полями для фильтров и выполнения запросов.

Записи здесь нельзя создать или изменить: их сохраняют процессы нодой «Данные проекта» и агенты.

Вверху страницы указаны состояние хранилища, число записей в проекте и квота, а также срок хранения по умолчанию.

Коллекции и записи​

Записи отображаются по одной коллекции; её можно выбрать из списка или указать название.

Фильтр Начало ключа оставляет записи, ключи которых начинаются с указанного текста; регистр учитывается. Например, префикс 2026-09- подходит для ключей с датой 2026-09-28 в начале.

Записи отсортированы по ключу как по строке. Открытие записи показывает значение целиком и служебные поля.

Запись можно удалить из таблицы; удаление необратимо. Удаление записи, занятой операцией «Занять ключ», освобождает ключ, поэтому следующий вызов операции успешно займёт его.

Очистка коллекции​

Очистка удаляет все записи коллекции, сохранённые до запроса; записи, сохранённые после него, остаются. Очистка выполняется в фоне, отменить её или восстановить удалённые записи нельзя. Фильтр по началу ключа на очистку не влияет.

Поля для фильтров​

Поля позволяют фильтровать, считать и группировать записи по значениям внутри них. По ключу можно искать и без объявления поля.

Поле задаётся путём в записи и типом значения. Путь может включать точки для вложенных объектов, например order.status.

Путь не может начинаться с _, содержать пустые части или превышать 255 символов. Тип поля — Текст, Число, Дата и время или Да/нет.

Поле можно объявить и для коллекции, в которой ещё нет записей.

Например, в записи

{
"status": "paid",
"amount": 1500,
"paidAt": "2026-09-28T10:15:00Z",
"customer": { "email": "anna@example.com", "vip": true }
}

можно объявить поля status (Текст), amount (Число), paidAt (Дата и время), customer.email (Текст) и customer.vip (Да/нет).

При сохранении записи значение по пути проверяется на соответствие типу:

Тип поляДопустимое значение
ТекстСтрока
ЧислоЧисло; строка и true/false не подходят
Дата и времяСтрока ISO 8601; время без часового пояса считается UTC
Да/нетtrue или false

Если значения нет или оно null, запись сохраняется, а поле считается незаполненным. При несовпадении типа запись не сохраняется; объект или массив по пути вызывает ошибку. Адресовать элементы массивов нельзя.

На коллекцию допускается до 4 полей типов Текст и Да/нет вместе, до 2 полей Число и до 2 полей Дата и время.

На проект допускается до 64 полей. Поля в процессе удаления продолжают занимать место.

Поле учитывает только новые записи

Поле заполняется только у записей, сохранённых после его добавления; старые записи считаются незаполненными.

Поэтому старые записи не подходят под условия «Равно», сравнения, «Между», «Входит в список», «Начинается с», «Содержит» и «Заполнено». Они подходят под «Не заполнено», «Не равно» и «Не входит в список», а при группировке попадают в null.

Например, условие processedAt «Не заполнено» найдёт также старые, в том числе уже обработанные, заказы.

Чтобы избежать этого, объявляйте поле до записи данных, пересохраните старые записи или добавьте условие «Создана ≥ дата добавления поля».

Пересохранение продлевает срок жизни, обновляет «Создана» и «Кем занята». Не пересохраняйте коллекции с ключами, занятыми «Занять ключ»: повтор этой операции исходным запуском и нодой вернёт claimed = false.

Удалённое поле сразу перестаёт использоваться в фильтрах, но сами записи не меняются. Его место освобождается позднее; до этого в коллекции нельзя добавить поле с тем же путём.

Запросы​

Вкладка «Запрос» задаёт условия по ключу, служебным полям и объявленным полям и возвращает подходящие записи или результаты подсчёта. Подробнее — запросы к коллекции.

Доступные действия зависят от прав проекта на раздел «Память» — подробнее в разделе «Права доступа».