Ограничение по арендатору
функциональныйНастройте защиту от пропущенного фильтра: включена ли она, столбец тенанта и таблица тенантов.
Настройка мультитенантности SQLly защита от отсутствующих фильтров для текущей базы данных. Четыре режима: Выключено (по умолчанию, ничего, связанного с арендатором, не отображается), Разрешено (распознают фильтры арендатора, никогда не донимают), Предупреждение (таблица с изоляцией по арендатору, запрошенная без предиката арендатора, получает предупреждение валидации) и Обязательно (такое упущение становится блокирующей ошибкой, и Выполнить откажет). Так вы объясняете SQLly, что значит «забыл фильтр арендатора» для ваш схемы.
Оставьте столбец арендатора пустым, и защита использует обычные соглашения —
TenantId, AccountId, OrganizationId,
OrgId и их варианты с подчёркиванием — или задайте свой столбец, чтобы сузить распознавание. При желании укажите прямо таблицу арендаторов с её столбцами id и display-name. Изменения сохраняются при каждом нажатии клавиши и применяются при следующей проверке; настройки хранятся для каждого сочетания сервера и базы данных в обычном локальном файле, как и остальная конфигурация SQLly.


Настройка для SaaS-базы данных
- Щелкните правой кнопкой мыши по базе данных и выберите Инструменты › Изоляция арендаторов...или выполните Ограничение по арендатору из палитры команд при подключении к ней. Заголовок показывает сервер и базу данных, которые настраиваются.
- Выберите режим. Однострочное описание под кнопками объясняет, что делает выбранный режим.
- Если у вашего столбца tenant нестандартное имя — скажем, это
customer_id- введите его Столбец арендатора. Как только вы укажете столбец, только он один помечает таблицу как ограниченную по арендатору. - По желанию заполните Таблица арендаторов. Его Столбец ID арендатора и Столбец отображаемого имени арендатора поля появляются, как только указана таблица.
- Закройте диалог. Кнопки «Сохранить» нет; все изменения уже сохранены.
Что проверяет защита
Таблица считается ограниченной по арендатору если у неё есть столбец арендатора. Инструкция, которая читает, обновляет или удаляет из неё данные, должна упоминать этот столбец в WHERE или
JOIN ... ON условии:
SELECT total FROM dbo.orders; -- flagged SELECT total FROM dbo.orders WHERE tenant_id = 7; -- fine SELECT o.total FROM dbo.orders o JOIN dbo.users u ON o.tenant_id = u.tenant_id; -- fine
Первый оператор получает диагностику валидации в редакторе с сообщением вроде `dbo.orders` разграничена по арендатору через `tenant_id`, но в операторе нет фильтра по `tenant_id` в WHERE или JOIN ON.
- INSERT — исключение - новые строки содержат собственное значение арендатора.
- Реестр арендаторов исключён - таблица, первичный ключ которой — столбец арендатора, например
tenants(tenant_id, name), является списком арендаторов, а не данными арендаторов. - Проверка ищет столбец в условии; она не оценивает значение, с которым вы его сравниваете.
Четыре режима
| Режим | Эффект |
|---|---|
| Выключено | Значение по умолчанию для любой базы данных. Защита отключена, и ничего о тенантах не показывается. Поля скрыты, режим Off не хранит настройки столбцов и таблиц, поэтому закрытие диалога в Off их отбрасывает. |
| Разрешено | Нет предупреждений и ошибок об отсутствующих фильтрах тенантов. Ваши настройки столбцов и таблиц сохранены. |
| Предупреждение | Отсутствующий фильтр — предупреждение валидации; выполнение всё равно работает. |
| Обязательно | Отсутствующий фильтр — ошибка валидации. Нажатие «Выполнить» не пропустит пакет и покажет сообщение в строке состояния — в том числе при запуске сразу по нескольким целям. |
Где это хранится
Настройки привязаны к серверу и имени базы данных, без учета регистра, и сохраняются в формате JSON в
tenant-scoping.json в папке данных приложения SQLly (на macOS,
~/Library/Application Support/SQLLY). База данных, которую вы никогда не настраивали, находится в режиме Off. Предпросмотр в браузере хранит настройки только в текущей сессии.
Обновляетесь с более ранней версии? При первом запуске новой версии она один раз очищает все сохранённые ранее настройки мультиарендности — включая базы, для которых вы задали «Предупреждать» или «Обязательно». Если защита нужна какой-то базе, откройте «Мультиарендность» и включите её заново.
Защите нужны столбцы таблицы из загруженной модели схемы, чтобы понять, что на таблицу распространяется мультиарендность. Таблицы, которых модель не знает, не проверяются.