Схемы и роли базы

Ваша база — отдельный сервер PostgreSQL, поднятый только для вас: чужих данных в нём нет физически, а ваши не видны никому.

Схемы

Схема	Что в ней	Роль «клиент»	Роль «только чтение»
raw	сырые данные: raw.events — каждое событие целиком (payload — тело в jsonb, канал, время приёма, пометка повторной отправки, пометка удаления); raw.event_bodies — исходный запрос, 90 дней	читает	читает
sources	таблица на каждый источник — Таблица источника	читает, правит значения (необратимо), удаляет строки (в корзину)	читает
public и ваши схемы	ваши таблицы, представления, материализованные представления, функции, индексы	создаёт любые объекты и владеет ими	читает

Служебные таблицы кабинета (настройки, ключи, журналы) ролям не видны — так и задумано. Пишите схемы в запросах явно: raw.events, sources.zayavki.

Обе роли сами выбирают язык сообщений базы для своего сеанса: set lc_messages = 'ru_RU.UTF-8'; — по-русски, по умолчанию — по-английски (Язык сообщений базы).

Сырые данные — raw.events

Столбец	Что в нём
id	номер события
source_id	источник
payload	тело события, jsonb
channel	webhook, file или pull
received_at	когда принято
repeat_of	у повторной отправки — номер первого такого же события
history	событие из истории: загрузка файла, первый запуск опроса
deleted_at	строку события удалили — она в корзине

-- последние события одного источника вместе с телом
select id, received_at, payload
  from raw.events
 where source_id = 14
 order by id desc
 limit 20;

Ваши объекты

С ролью «клиент» схема public — ваша: в ней и в своих схемах (create schema moya;) можно заводить таблицы, представления, материализованные представления, функции и индексы. Их владелец — вы: вы их правите и удаляете, drop и delete по ним идут без корзины. Роль «только чтение» (например, у вашей BI-программы) их видит. Создать объект в схемах raw и sources нельзя: ими владеет платформа.

Если ваш объект держится за столбец таблицы источника, а тот расширяет тип, платформа пересоздаёт объект сама — тем же текстом, от вашей роли, с теми же правами и комментариями.

Где выполняются запросы

• SQL-редактор кабинета — ролью «клиент»: Работать в SQL-редакторе.
• Прямой доступ через SSH-туннель — ролью «клиент» или «только чтение»: Подключиться к базе напрямую.

Пределы запросов у этих путей разные — Пределы и сроки.