Supabase — мощная open-source платформа backend-as-a-service, которая предоставляет разработчикам набор инструментов для создания, масштабирования и управления современными приложениями. Supabase предлагает полностью управляемую базу данных PostgreSQL, надёжную аутентификацию, мгновенные REST- и GraphQL-API, real-time подписки, файловое хранилище и edge-функции — всё это через единый удобный для разработчиков интерфейс. Открытый исходный код и совместимость с популярными фреймворками делают Supabase сильной альтернативой Firebase с дополнительной гибкостью и прозрачностью SQL.
Почему Supabase?
- Мгновенные API: каждая таблица и представление в вашей базе мгновенно доступны через REST- и GraphQL-эндпоинты, что упрощает создание data-driven приложений без написания кастомного бэкенда.
- Real-time данные: Supabase поддерживает real-time подписки, позволяя приложениям мгновенно реагировать на изменения в базе данных.
- Аутентификация и авторизация: встроенное управление пользователями с поддержкой email, OAuth, SSO и других методов, плюс row-level security для тонкого контроля доступа.
- Storage: безопасно загружайте, отдавайте и управляйте файлами через встроенное хранилище, бесшовно интегрированное с базой данных.
- Edge Functions: разворачивайте serverless-функции близко к пользователям для кастомной логики с низкой задержкой.
Использование Supabase в AACFlow
Интеграция Supabase в AACFlow делает подключение ваших воркфлоу к проектам Supabase простым. Достаточно нескольких полей конфигурации — Project ID, имени таблицы и Service Role Secret — чтобы безопасно работать с базой данных прямо из блоков AACFlow. Интеграция скрывает сложность API-вызовов, позволяя вам сосредоточиться на логике и автоматизациях.
Ключевые преимущества использования Supabase в AACFlow:
- No-code/low-code операции с базой: делайте запросы, вставляйте, обновляйте и удаляйте строки в таблицах Supabase без написания SQL или бэкенд-кода.
- Гибкие запросы: используйте синтаксис фильтров PostgREST для расширенных запросов, включая фильтрацию, сортировку и ограничение результатов.
- Бесшовная интеграция: легко связывайте Supabase с другими инструментами и сервисами в воркфлоу — для синхронизации данных, запуска уведомлений или обогащения записей.
- Безопасно и масштабируемо: все операции используют ваш Service Role Secret Supabase, обеспечивая безопасный доступ к данным и масштабируемость управляемой облачной платформы.
Создаёте ли вы внутренние инструменты, автоматизируете бизнес-процессы или поддерживаете production-приложения — Supabase в AACFlow даёт быстрый, надёжный и удобный для разработчиков способ управлять данными и бэкенд-логикой без управления инфраструктурой. Просто настройте блок, выберите нужную операцию — а AACFlow позаботится об остальном.
Интегрируйте Supabase в рабочий процесс. Supports database operations (запрос, insert, update, delete, upsert), full-text search, RPC functions, row counting, vector search, и complete storage management (upload, download, list, move, copy, delete files и buckets).
Запрос data from a Supabase table
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
table | string | Да | The name of the Supabase table to query |
schema | string | Нет | Database schema to query from (default: public). Use this to access tables in other schemas. |
select | string | Нет | Columns to return (comma-separated). Defaults to * (all columns) |
filter | string | Нет | PostgREST filter (e.g., "id=eq.123") |
orderBy | string | Нет | Column to order by (add DESC for descending) |
limit | number | Нет | Maximum number of rows to return |
offset | number | Нет | Number of rows to skip (for постраничная выборка) |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
results | array | Массив records returned from the query |
Insert data into a Supabase table
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
table | string | Да | The name of the Supabase table to insert data into |
schema | string | Нет | Database schema to insert into (default: public). Use this to access tables in other schemas. |
data | array | Да | The data to insert (array of objects or a single object) |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
results | array | Массив inserted records |
Получить a single row from a Supabase table based on filter criteria
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
table | string | Да | The name of the Supabase table to query |
schema | string | Нет | Database schema to query from (default: public). Use this to access tables in other schemas. |
select | string | Нет | Columns to return (comma-separated). Defaults to * (all columns) |
filter | string | Да | PostgREST filter to find the specific row (e.g., "id=eq.123") |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
results | array | Array containing the row data if found, empty array if not found |
Обновить rows in a Supabase table based on filter criteria
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
table | string | Да | The name of the Supabase table to update |
schema | string | Нет | Database schema to update in (default: public). Use this to access tables in other schemas. |
filter | string | Да | PostgREST filter to identify rows to update (e.g., "id=eq.123") |
data | object | Да | Data to update in the matching rows |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
results | array | Массив updated records |
Удалить rows from a Supabase table based on filter criteria
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
table | string | Да | The name of the Supabase table to delete from |
schema | string | Нет | Database schema to delete from (default: public). Use this to access tables in other schemas. |
filter | string | Да | PostgREST filter to identify rows to delete (e.g., "id=eq.123") |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
results | array | Массив deleted records |
Insert или update data in a Supabase table (upsert operation)
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
table | string | Да | The name of the Supabase table to upsert data into |
schema | string | Нет | Database schema to upsert into (default: public). Use this to access tables in other schemas. |
data | array | Да | The data to upsert (insert or update) - array of objects or a single object |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
results | array | Массив upserted records |
Count rows in a Supabase table
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
table | string | Да | The name of the Supabase table to count rows from |
schema | string | Нет | Database schema to count from (default: public). Use this to access tables in other schemas. |
filter | string | Нет | PostgREST filter (e.g., "status=eq.active") |
countType | string | Нет | Count type: exact, planned, or estimated (default: exact) |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
count | number | Number of rows matching the filter |
Perform full-text search on a Supabase table
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
table | string | Да | The name of the Supabase table to search |
schema | string | Нет | Database schema to search in (default: public). Use this to access tables in other schemas. |
column | string | Да | The column to search in |
query | string | Да | The search query |
searchType | string | Нет | Search type: plain, phrase, or websearch (default: websearch) |
language | string | Нет | Language for text search configuration (default: english) |
limit | number | Нет | Maximum number of rows to return |
offset | number | Нет | Number of rows to skip (for постраничная выборка) |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
results | array | Массив records matching the search query |
Perform similarity search using pgvector in a Supabase table
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
functionName | string | Да | The name of the PostgreSQL function that performs vector search (e.g., match_documents) |
queryEmbedding | array | Да | The query vector/embedding to search for similar items |
matchThreshold | number | Нет | Minimum similarity threshold (0-1), typically 0.7-0.9 |
matchCount | number | Нет | Maximum number of results to return (default: 10) |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
results | array | Массив records with similarity scores from the vector search. Each record includes a similarity field (0-1) indicating how similar it is to the query vector. |
Call a PostgreSQL function in Supabase
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
functionName | string | Да | The name of the PostgreSQL function to call |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
results | json | Result returned from the function |
Introspect Supabase database schema to get table structures, columns, и relationships
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
schema | string | Нет | Database schema to introspect (defaults to all user schemas, commonly "public") |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
tables | array | Массив table schemas with columns, keys, and indexes |
↳ name | string | Table name |
↳ schema | string | Database schema name |
↳ columns | array | Массив column definitions |
↳ name | string | Column name |
↳ type | string | Column data type |
↳ nullable | boolean | Произошла ли column allows null values |
↳ default | string | Default value for the column |
↳ isPrimaryKey | boolean | Произошла ли column is a primary key |
↳ isForeignKey | boolean | Произошла ли column is a foreign key |
↳ references | object | Foreign key reference details |
↳ table | string | Referenced table name |
↳ column | string | Referenced column name |
↳ primaryKey | array | Массив primary key column names |
↳ foreignKeys | array | Массив foreign key relationships |
↳ column | string | Local column name |
↳ referencesTable | string | Referenced table name |
↳ referencesColumn | string | Referenced column name |
↳ indexes | array | Массив index definitions |
↳ name | string | Index name |
↳ columns | array | Columns included in the index |
↳ unique | boolean | Произошла ли index enforces uniqueness |
schemas | array | List of schemas found in the database |
Загрузить a file to a Supabase storage bucket
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
bucket | string | Да | The name of the storage bucket |
fileName | string | Да | The name of the file (e.g., "document.pdf", "image.jpg") |
path | string | Нет | Optional folder path (e.g., "folder/subfolder/") |
fileData | json | Да | File to upload - UserFile object (basic mode) or string content (advanced mode: base64 or plain text). Supports data URLs. |
contentType | string | Нет | MIME type of the file (e.g., "image/jpeg", "text/plain") |
upsert | boolean | Нет | If true, overwrites existing file (default: false) |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
results | object | Upload result including file path, bucket, and public URL |
↳ id | string | Unique identifier for the uploaded file |
↳ path | string | Path to the uploaded file within the bucket |
↳ fullPath | string | Full path including bucket name |
Загрузить a file from a Supabase storage bucket
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
bucket | string | Да | The name of the storage bucket |
path | string | Да | The path to the file to download (e.g., "folder/file.jpg") |
fileName | string | Нет | Optional filename override |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
file | file | Downloaded file stored in execution files |
Список files in a Supabase storage bucket
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
bucket | string | Да | The name of the storage bucket |
path | string | Нет | folder path to list files from (default: root) |
limit | number | Нет | Maximum number of files to return (default: 100) |
offset | number | Нет | Number of files to skip (for постраничная выборка) |
sortBy | string | Нет | Column to sort by: name, created_at, updated_at (default: name) |
sortOrder | string | Нет | Sort order: asc or desc (default: asc) |
search | string | Нет | Search term to filter files by name |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
results | array | Массив file objects with metadata |
↳ id | string | Unique file identifier |
↳ name | string | File name |
↳ bucket_id | string | Bucket identifier the file belongs to |
↳ owner | string | Owner identifier |
↳ created_at | string | File creation timestamp |
↳ updated_at | string | Last update timestamp |
↳ last_accessed_at | string | Last access timestamp |
↳ metadata | object | File metadata including size and MIME type |
↳ size | number | File size in bytes |
↳ mimetype | string | MIME type of the file |
↳ cacheControl | string | Cache control header value |
↳ lastModified | string | Last modified timestamp |
↳ eTag | string | Entity tag for caching |
Удалить files from a Supabase storage bucket
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
bucket | string | Да | The name of the storage bucket |
paths | array | Да | Массив file paths to delete (e.g., ["folder/file1.jpg", "folder/file2.jpg"]) |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
results | array | Массив deleted file objects |
↳ name | string | Name of the deleted file |
↳ bucket_id | string | Bucket identifier |
↳ owner | string | Owner identifier |
↳ id | string | Unique file identifier |
↳ updated_at | string | Last update timestamp |
↳ created_at | string | File creation timestamp |
↳ last_accessed_at | string | Last access timestamp |
Move a file within a Supabase storage bucket
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
bucket | string | Да | The name of the storage bucket |
fromPath | string | Да | The current path of the file (e.g., "folder/old.jpg") |
toPath | string | Да | The new path for the file (e.g., "newfolder/new.jpg") |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
results | object | Move operation result |
↳ message | string | Operation status message |
Copy a file within a Supabase storage bucket
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
bucket | string | Да | The name of the storage bucket |
fromPath | string | Да | The path of the source file (e.g., "folder/source.jpg") |
toPath | string | Да | The path for the copied file (e.g., "folder/copy.jpg") |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
results | object | Copy operation result |
↳ message | string | Operation status message |
Создать новый storage bucket in Supabase
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
bucket | string | Да | The name of the bucket to create |
isPublic | boolean | Нет | Произошла ли bucket should be publicly accessible (default: false) |
fileSizeLimit | number | Нет | Maximum file size in bytes (optional) |
allowedMimeTypes | array | Нет | Массив allowed MIME types (e.g., ["image/png", "image/jpeg"]) |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
results | object | Created bucket information |
↳ name | string | Created bucket name |
Список всех storage buckets in Supabase
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
results | array | Массив bucket objects |
↳ id | string | Unique bucket identifier |
↳ name | string | Bucket name |
↳ owner | string | Owner identifier |
↳ public | boolean | Произошла ли bucket is publicly accessible |
↳ created_at | string | Bucket creation timestamp |
↳ updated_at | string | Last update timestamp |
↳ file_size_limit | number | Maximum file size allowed in bytes |
↳ allowed_mime_types | array | List of allowed MIME types for uploads |
Удалить storage bucket in Supabase
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
bucket | string | Да | The name of the bucket to delete |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
results | object | Delete operation result |
↳ message | string | Operation status message |
Получить public URL для a file in a Supabase storage bucket
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
bucket | string | Да | The name of the storage bucket |
path | string | Да | The path to the file (e.g., "folder/file.jpg") |
download | boolean | Нет | If true, forces download instead of inline display (default: false) |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
publicUrl | string | The public URL to access the file |
Создать a temporary signed URL для a file in a Supabase storage bucket
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | Your Supabase project ID (e.g., jdrkgepadsdopsntdlom) |
bucket | string | Да | The name of the storage bucket |
path | string | Да | The path to the file (e.g., "folder/file.jpg") |
expiresIn | number | Да | Number of seconds until the URL expires (e.g., 3600 for 1 hour) |
download | boolean | Нет | If true, forces download instead of inline display (default: false) |
apiKey | string | Да | Your Supabase service role secret key |
| Параметр | Тип | Описание |
|---|
message | string | Operation status message |
signedUrl | string | The temporary signed URL to access the file |
