租戶範圍
功能性的設定多租戶缺少篩選條件時的防護:是否啟用、租戶欄位及租戶資料表。
設定 SQLly 的多租戶 缺少篩選防護 針對當前資料庫的四種模式: 關閉 (預設,未顯示任何與租戶相關的內容), 允許 (能辨識租戶篩選條件,絕不囉嗦), 警告 (限定租戶的資料表若查詢時沒帶租戶述詞,會收到驗證警告),而且 必填 (該遺漏會變成阻斷錯誤,「執行」會拒絕執行)。這就是你教 SQLly 認識「忘記租戶篩選條件」對 你的 架構。
租戶欄位留空時,防護機制會採用一般慣例 -
TenantId, AccountId, OrganizationId,
OrgId 以及底線形式——或者自己指定欄位名稱來縮小偵測範圍。也可以指到 tenants 資料表本身,用它的 id 與顯示名稱欄位。每敲一個鍵就會儲存變更,並在下一次驗證時生效;這些設定依伺服器與資料庫分開,存放在一個純文字的本機檔案裡,和你其他 SQLly 設定放在一起。


為 SaaS 資料庫進行設定
- 右鍵點擊資料庫並選擇 工具 › 租戶範圍...,或執行 租戶範圍 來自 命令面板 在連線到它的期間。標題會顯示正在設定的伺服器與資料庫。
- 選擇模式。按鈕下方有一行說明,解釋所選模式的作用。
- 如果你的租戶欄位名稱不是傳統名稱之一,例如
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` 限定租戶範圍,但語句在 WHERE 或 JOIN ON 中沒有 `tenant_id` 篩選條件.
- INSERT 例外 - 新的資料列會帶有自己的租用戶值。
- 租戶登錄表不受此限 - 主鍵就是租戶欄位的資料表,例如
tenants(tenant_id, name),是租戶清單,而不是租戶資料。 - 這項檢查會在條件中尋找欄位,但不會判斷你拿來比較的值。
四種模式
| 模式 | 效果 |
|---|---|
| 關閉 | 所有資料庫的預設值。防護已停用,不會顯示任何與租用戶相關的內容。欄位會隱藏,且 Off 不會儲存任何欄位或資料表設定,因此在 Off 模式下關閉對話方塊就會捨棄這些設定。 |
| 允許 | 不會針對缺少租用戶篩選條件發出警告或錯誤。你的欄位與資料表設定都會保留。 |
| 警告 | 缺少篩選器只是驗證警告;仍可執行。 |
| 必填 | 缺少篩選器屬於驗證錯誤。按下執行會拒絕整批,並把訊息放到狀態列,同時對多個目標執行時也一樣。 |
存放位置
設定以伺服器與資料庫名稱作為鍵值(不分大小寫),並以 JSON 儲存在
tenant-scoping.json 位於 SQLly 的應用程式資料夾中(在 macOS 上,
~/Library/Application Support/SQLLY。你從未設定過的資料庫會處於關閉模式。瀏覽器預覽只會在目前的工作階段保留這些設定。
從早期版本升級? 新版本首次啟動時,會一次性清除先前儲存的所有租用戶範圍設定——包括你設定為「警告」或「必要」的資料庫。如果你想讓某個資料庫重新受到這道防護,請開啟租用戶範圍並再次將它開啟。
這道防護需要從已載入的結構描述模型取得資料表的欄位,才能辨識資料表是否屬於某個租用戶範圍。模型不認得的資料表不會被檢查。