HeapTableRepo.findBy

Возвращает массив heap-объектов с заданной фильтрацией.

Этот метод является синтаксическим сахаром для findAll для случаев, когда важен только состав результирующего набора, но не порядок и количество записей.

Если фильтрация не задана, то возвращаются все записи таблицы.

Максимальное количество записей, которое может вернуть этот метод - 1000. Если нужно получить больше записей, следует использовать findAll с параметрами limit и offset.

Применение/сигнатура

table.findBy(ctx, where)

• Аргументы

  • ctx*: app.Ctx
    Контекст запроса. Используется для внутренней реализации, а также позволяет выполнить запрос в нужной транзакции.
  • where: HeapFilter
    Объект с условием фильтрации на специальном языке.

• Возвращаемое значение: Promise<HeapObject[]>

  • Массив heap-объектов, соответствующий условиям фильтрации.

Примеры

---

Выборка всех записей с приоритетом больше 3 и заголовком, включающим подстроку 'important'.

const Tasks = Heap.Table('tasks', {
  title: Heap.String(),
  priority: Heap.Integer(),
})
const importantTasks = await Tasks.findBy(ctx, {
  priority: { $gt: 3 },
  title: { $ilike: '%important%' },
})