Ограничение по арендатору

функциональный

Настройте защиту от пропущенного фильтра: включена ли она, столбец тенанта и таблица тенантов.

Настройка мультитенантности SQLly защита от отсутствующих фильтров для текущей базы данных. Четыре режима: Выключено (по умолчанию, ничего, связанного с арендатором, не отображается), Разрешено (распознают фильтры арендатора, никогда не донимают), Предупреждение (таблица с изоляцией по арендатору, запрошенная без предиката арендатора, получает предупреждение валидации) и Обязательно (такое упущение становится блокирующей ошибкой, и Выполнить откажет). Так вы объясняете SQLly, что значит «забыл фильтр арендатора» для ваш схемы.

Выключено, пока вы не включите. Каждая база данных стартует в режиме Off: никаких предупреждений об арендаторе и никакой блокировки запуска, пока вы не выберете Allowed, Warn или Required для этой базы данных в Инструменты › Изоляция арендаторов. Тот же режим по умолчанию действует везде, где SQLly проверяет ваш SQL: в десктоп-приложении, в браузерном превью, в языковом сервере и в движке командной строки.

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

Защита, а не переписывание. Tenant Scoping никогда не подставляет предложение WHERE и не правит ваш SQL. Он только проверяет то, что вы написали, и даже в режиме Required блокирует лишь при подтверждённой диагностике отсутствующего фильтра по арендатору — скорее пропустит, чем станет гадать.
SQLly
Настройка Tenant Scoping в SQLlyНастройка Tenant Scoping в SQLly
Ограничение по арендатору: включите защиту для базы данных и укажите столбец арендатора и таблицу арендаторов.

Настройка для SaaS-базы данных

  1. Щелкните правой кнопкой мыши по базе данных и выберите Инструменты › Изоляция арендаторов...или выполните Ограничение по арендатору из палитры команд при подключении к ней. Заголовок показывает сервер и базу данных, которые настраиваются.
  2. Выберите режим. Однострочное описание под кнопками объясняет, что делает выбранный режим.
  3. Если у вашего столбца tenant нестандартное имя — скажем, это customer_id - введите его Столбец арендатора. Как только вы укажете столбец, только он один помечает таблицу как ограниченную по арендатору.
  4. По желанию заполните Таблица арендаторов. Его Столбец ID арендатора и Столбец отображаемого имени арендатора поля появляются, как только указана таблица.
  5. Закройте диалог. Кнопки «Сохранить» нет; все изменения уже сохранены.

Что проверяет защита

Таблица считается ограниченной по арендатору если у неё есть столбец арендатора. Инструкция, которая читает, обновляет или удаляет из неё данные, должна упоминать этот столбец в 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. Предпросмотр в браузере хранит настройки только в текущей сессии.

Обновляетесь с более ранней версии? При первом запуске новой версии она один раз очищает все сохранённые ранее настройки мультиарендности — включая базы, для которых вы задали «Предупреждать» или «Обязательно». Если защита нужна какой-то базе, откройте «Мультиарендность» и включите её заново.

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