租戶範圍

功能性的

設定多租戶缺少篩選條件時的防護:是否啟用、租戶欄位及租戶資料表。

設定 SQLly 的多租戶 缺少篩選防護 針對當前資料庫的四種模式: 關閉 (預設,未顯示任何與租戶相關的內容), 允許 (能辨識租戶篩選條件,絕不囉嗦), 警告 (限定租戶的資料表若查詢時沒帶租戶述詞,會收到驗證警告),而且 必填 (該遺漏會變成阻斷錯誤,「執行」會拒絕執行)。這就是你教 SQLly 認識「忘記租戶篩選條件」對 你的 架構。

在你開啟之前都是關閉的。 每個資料庫一開始都是關閉:沒有租戶警告,也不會阻止執行,直到你在以下位置為該資料庫選擇 Allowed、Warn 或 Required: 工具 › 租戶範圍中為該資料庫選擇允許、警告或必須。SQLly 檢查 SQL 的任何地方都適用相同的預設設定——桌面應用程式、瀏覽器預覽、語言伺服器和命令列引擎。

租戶欄位留空時,防護機制會採用一般慣例 - TenantId, AccountId, OrganizationId, OrgId 以及底線形式——或者自己指定欄位名稱來縮小偵測範圍。也可以指到 tenants 資料表本身,用它的 id 與顯示名稱欄位。每敲一個鍵就會儲存變更,並在下一次驗證時生效;這些設定依伺服器與資料庫分開,存放在一個純文字的本機檔案裡,和你其他 SQLly 設定放在一起。

是防護,不是改寫者。 租戶範圍絕不會注入 WHERE 子句,也不會改你的 SQL。它只檢查你寫的內容;即使在「必需」模式下,也只在確認「缺少租戶篩選」這項診斷時才阻擋,寧可放行也不亂猜。
SQLly
SQLly 租用戶範圍設定SQLly 租用戶範圍設定
租戶範圍:為資料庫啟用防護,並指定租戶欄位與租戶資料表的名稱。

為 SaaS 資料庫進行設定

  1. 右鍵點擊資料庫並選擇 工具 › 租戶範圍...,或執行 租戶範圍 來自 命令面板 在連線到它的期間。標題會顯示正在設定的伺服器與資料庫。
  2. 選擇模式。按鈕下方有一行說明,解釋所選模式的作用。
  3. 如果你的租戶欄位名稱不是傳統名稱之一,例如 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` 限定租戶範圍,但語句在 WHERE 或 JOIN ON 中沒有 `tenant_id` 篩選條件.

  • INSERT 例外 - 新的資料列會帶有自己的租用戶值。
  • 租戶登錄表不受此限 - 主鍵就是租戶欄位的資料表,例如 tenants(tenant_id, name),是租戶清單,而不是租戶資料。
  • 這項檢查會在條件中尋找欄位,但不會判斷你拿來比較的值。

四種模式

模式效果
關閉所有資料庫的預設值。防護已停用,不會顯示任何與租用戶相關的內容。欄位會隱藏,且 Off 不會儲存任何欄位或資料表設定,因此在 Off 模式下關閉對話方塊就會捨棄這些設定。
允許不會針對缺少租用戶篩選條件發出警告或錯誤。你的欄位與資料表設定都會保留。
警告缺少篩選器只是驗證警告;仍可執行。
必填缺少篩選器屬於驗證錯誤。按下執行會拒絕整批,並把訊息放到狀態列,同時對多個目標執行時也一樣。

存放位置

設定以伺服器與資料庫名稱作為鍵值(不分大小寫),並以 JSON 儲存在 tenant-scoping.json 位於 SQLly 的應用程式資料夾中(在 macOS 上, ~/Library/Application Support/SQLLY。你從未設定過的資料庫會處於關閉模式。瀏覽器預覽只會在目前的工作階段保留這些設定。

從早期版本升級? 新版本首次啟動時,會一次性清除先前儲存的所有租用戶範圍設定——包括你設定為「警告」或「必要」的資料庫。如果你想讓某個資料庫重新受到這道防護,請開啟租用戶範圍並再次將它開啟。

這道防護需要從已載入的結構描述模型取得資料表的欄位,才能辨識資料表是否屬於某個租用戶範圍。模型不認得的資料表不會被檢查。