Таблица

Таблицы позволяют создавать и управлять пользовательскими таблицами данных непосредственно в AACFlow. Храните, запрашивайте и манипулируйте структурированными данными в ваших рабочих процессах без необходимости интеграции внешних баз данных.

Зачем использовать таблицы?

Без внешней настройки: Создавайте таблицы мгновенно без настройки внешних баз данных
Нативные для рабочих процессов: Данные сохраняются между выполнениями рабочих процессов и доступны из любого рабочего процесса в вашем рабочем пространстве
Гибкая схема: Определяйте столбцы с типами (строка, число, логическое значение, дата, json) и ограничениями (обязательное, уникальное)
Мощные запросы: Фильтруйте, сортируйте и разбивайте на страницы данные с использованием операторов в стиле MongoDB
Дружелюбно к агентам: Таблицы могут использоваться как инструменты AI-агентами для динамического хранения и извлечения данных

Ключевые возможности:

Создание таблиц с пользовательскими схемами
Вставка, обновление, upsert и удаление строк
Запросы с фильтрами и сортировкой
Пакетные операции для массовой вставки
Массовые обновления и удаления по фильтру
До 10 000 строк на таблицу, 100 таблиц на рабочее пространство

Создание таблиц

Таблицы создаются из раздела Таблицы на боковой панели. Каждая таблица требует:

Имя: Буквенно-цифровое с подчеркиваниями (например, customer_leads)
Описание: Необязательное описание назначения таблицы
Схема: Определение столбцов с именем, типом и необязательными ограничениями

Типы столбцов

Тип	Описание	Примеры значений
`string`	Текстовые данные	`"John Doe"`, `"active"`
`number`	Числовые данные	`42`, `99.99`
`boolean`	Логические значения	`true`, `false`
`date`	Значения даты/времени	`"2024-01-15T10:30:00Z"`
`json`	Сложные вложенные данные	`\{"address": {"city": "NYC"}}`

Ограничения столбцов

Обязательный: Столбец должен иметь значение (не может быть null)
Уникальный: Значения должны быть уникальными во всех строках (позволяет сопоставление для upsert)

Инструкции по использованию

Создавайте и управляйте пользовательскими таблицами данных. Храните, запрашивайте и манипулируйте структурированными данными в рабочих процессах.

Инструменты

`table_запрос_rows`

Запрос строк из таблицы с фильтрацией, сортировкой и разбиением на страницы

Входные параметры

Параметр	Тип	Обязательный	Описание
`tableId`	string	Да	ID таблицы
`filter`	object	Нет	Условия фильтрации с использованием операторов в стиле MongoDB
`sort`	object	Нет	Порядок сортировки как {'{'}column: "asc"\|"desc"{'}'}
`limit`	number	Нет	Максимальное количество возвращаемых строк (по умолчанию: 100, максимум: 1000)
`offset`	number	Нет	Количество пропускаемых строк (по умолчанию: 0)

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Успешен ли запрос
`rows`	array	Строки результата запроса
`rowCount`	number	Количество возвращенных строк
`totalCount`	number	Общее количество строк, соответствующих фильтру
`limit`	number	Лимит, использованный в запросе
`offset`	number	Смещение, использованное в запросе

`table_insert_row`

Вставка новой строки в таблицу

Входные параметры

Параметр	Тип	Обязательный	Описание
`tableId`	string	Да	ID таблицы
`data`	object	Да	Данные строки как JSON-объект, соответствующий схеме таблицы

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Была ли строка вставлена
`row`	object	Данные вставленной строки, включая сгенерированный ID
`message`	string	Статусное сообщение

`table_upsert_row`

Вставка или обновление строки на основе ограничений уникальных столбцов. Если строка с соответствующим уникальным полем существует, обновите ее; в противном случае вставьте новую строку.

Входные параметры

Параметр	Тип	Обязательный	Описание
`tableId`	string	Да	ID таблицы
`data`	object	Да	Данные строки для вставки или обновления

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Была ли строка upsert'нута
`row`	object	Данные upsert'нутой строки
`operation`	string	Выполненная операция: "insert" или "update"
`message`	string	Статусное сообщение

`table_batch_insert_rows`

Вставка нескольких строк одновременно (до 1000 строк на пакет)

Входные параметры

Параметр	Тип	Обязательный	Описание
`tableId`	string	Да	ID таблицы
`rows`	array	Да	Массив объектов данных строк для вставки

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Успешна ли пакетная вставка
`rows`	array	Массив вставленных строк с ID
`insertedCount`	number	Количество вставленных строк
`message`	string	Статусное сообщение

`table_update_row`

Обновление конкретной строки по ее ID

Входные параметры

Параметр	Тип	Обязательный	Описание
`tableId`	string	Да	ID таблицы
`rowId`	string	Да	ID строки для обновления
`data`	object	Да	Данные для обновления (поддерживается частичное обновление)

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Была ли строка обновлена
`row`	object	Данные обновленной строки
`message`	string	Статусное сообщение

`table_update_rows_by_filter`

Обновление нескольких строк, соответствующих условию фильтра

Входные параметры

Параметр	Тип	Обязательный	Описание
`tableId`	string	Да	ID таблицы
`filter`	object	Да	Фильтр для сопоставления строк для обновления
`data`	object	Да	Данные для применения к соответствующим строкам
`limit`	number	Нет	Максимальное количество строк для обновления (по умолчанию: 1000)

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Успешно ли обновление
`updatedCount`	number	Количество обновленных строк
`updatedRowIds`	array	ID обновленных строк
`message`	string	Статусное сообщение

`table_delete_row`

Удаление конкретной строки по ее ID

Входные параметры

Параметр	Тип	Обязательный	Описание
`tableId`	string	Да	ID таблицы
`rowId`	string	Да	ID строки для удаления

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Была ли строка удалена
`deletedCount`	number	Количество удаленных строк (1 или 0)
`message`	string	Статусное сообщение

`table_delete_rows_by_filter`

Удаление нескольких строк, соответствующих условию фильтра

Входные параметры

Параметр	Тип	Обязательный	Описание
`tableId`	string	Да	ID таблицы
`filter`	object	Да	Фильтр для сопоставления строк для удаления
`limit`	number	Нет	Максимальное количество строк для удаления (по умолчанию: 1000)

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Успешно ли удаление
`deletedCount`	number	Количество удаленных строк
`deletedRowIds`	array	ID удаленных строк
`message`	string	Статусное сообщение

`table_get_row`

Получение одной строки по ее ID

Входные параметры

Параметр	Тип	Обязательный	Описание
`tableId`	string	Да	ID таблицы
`rowId`	string	Да	ID строки для получения

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Была ли найдена строка
`row`	object	Данные строки
`message`	string	Статусное сообщение

`table_get_schema`

Получение определения схемы для таблицы

Входные параметры

Параметр	Тип	Обязательный	Описание
`tableId`	string	Да	ID таблицы

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Была ли получена схема
`name`	string	Имя таблицы
`columns`	array	Массив определений столбцов
`message`	string	Статусное сообщение

Операторы фильтрации

Фильтры используют операторы в стиле MongoDB для гибкого запроса:

Оператор	Описание	Пример
`$eq`	Равно	`\{"status": {"$eq": "active"}}` или `\{"status": "active"\}`
`$ne`	Не равно	`\{"status": {"$ne": "deleted"}}`
`$gt`	Больше чем	`\{"age": {"$gt": 18}}`
`$gte`	Больше или равно	`\{"score": {"$gte": 80}}`
`$lt`	Меньше чем	`\{"price": {"$lt": 100}}`
`$lte`	Меньше или равно	`\{"quantity": {"$lte": 10}}`
`$in`	В массиве	`\{"status": {"$in": ["active", "pending"]}}`
`$nin`	Не в массиве	`\{"type": {"$nin": ["spam", "blocked"]}}`
`$contains`	Строка содержит	`\{"email": {"$contains": "@gmail.com"}}`

Комбинирование фильтров

Несколько условий полей комбинируются с логикой AND:

{
  "status": "active",
  "age": {"$gte": 18}
}

Используйте $or для логики OR:

{
  "$or": [
    {"status": "active"},
    {"status": "pending"}
  ]
}

Спецификация сортировки

Указывайте порядок сортировки с именами столбцов и направлением:

{
  "createdAt": "desc"
}

Сортировка по нескольким столбцам:

{
  "priority": "desc",
  "name": "asc"
}

Встроенные столбцы

Каждая строка автоматически включает:

Столбец	Тип	Описание
`id`	string	Уникальный идентификатор строки
`createdAt`	date	Когда строка была создана
`updatedAt`	date	Когда строка была последний раз изменена

Их можно использовать в фильтрах и сортировке.

Ограничения

Ресурс	Ограничение
Таблиц на рабочее пространство	100
Строк на таблицу	10 000
Столбцов на таблицу	50
Максимальный размер строки	100KB
Длина строкового значения	10 000 символов
Лимит запроса	1 000 строк
Размер пакетной вставки	1 000 строк
Массовое обновление/удаление	1 000 строк

Примечания

Категория: blocks
Тип: table
Таблицы ограничены рабочими пространствами и доступны из любого рабочего процесса в этом рабочем пространстве
Данные сохраняются между выполнениями рабочих процессов
Используйте уникальные ограничения для включения функциональности upsert
Визуальный конструктор фильтров/сортировки предоставляет простой способ создания запросов без написания JSON

Таблица

On this page