Mandantenabgrenzung
funktionalKonfiguriere den Multi-Tenant-Schutz vor fehlenden Filtern: ob er aktiv ist, die Mandantenspalte und die Mandantentabelle.
Konfiguriere SQLlys Multi-Tenant fehlender-Filter-Schutz für die aktuelle Datenbank. Vier Modi: Aus (standardmäßig wird nichts Mandantenbezogenes angezeigt), Erlaubt (Mandantenfilter erkennen, nie nerven), Warnen (eine mandantenbezogene Tabelle, die ohne ihren Mandantenfilter abgefragt wird, erhält eine Validierungswarnung), und Erforderlich (dieses Weglassen wird zu einem blockierenden Fehler, und die Ausführung wird verweigert). So bringst du SQLly bei, was „den Mandantenfilter vergessen“ für dein Schema.
Lass die Tenant-Spalte leer, dann nutzt der Guard die üblichen Konventionen -
TenantId, AccountId, OrganizationId,
OrgId und ihre Varianten mit Unterstrich - oder benenne eine eigene Spalte, um die Erkennung einzugrenzen. Optional kannst du sie auf die Tenant-Tabelle selbst richten, mit ihren id- und Anzeigenamen-Spalten. Änderungen werden bei jedem Tastendruck gespeichert und gelten für die nächste Validierung; die Einstellungen liegen pro Server und Datenbank in einer simplen lokalen Datei, wie der Rest deiner SQLly-Konfiguration.


Einrichten für eine SaaS-Datenbank
- Klicke mit der rechten Maustaste auf die Datenbank und wähle Werkzeuge › Mandantenabgrenzung..., oder führe Mandantenabgrenzung aus dem Befehlspalette während du verbunden bist. Der Titel zeigt den Server und die Datenbank, die gerade konfiguriert wird.
- Wähle einen Modus. Eine einzeilige Beschreibung unter den Schaltflächen erklärt, was der gewählte Modus macht.
- Wenn deine Mandantenspalte nicht einen der üblichen Namen trägt - sagen wir, sie heißt
customer_id- trage ihn ein unter Mandantenspalte. Sobald du eine Spalte benennst, markiert nur diese Spalte eine Tabelle als mandantenbezogen. - Optional ausfüllen Mandantentabelle. Seine Mandanten-ID-Spalte und Spalte für Mandanten-Anzeigenamen Felder erscheinen, sobald eine Tabelle benannt wird.
- Schließe den Dialog. Es gibt keine Speichern-Schaltfläche; jede Änderung ist bereits gespeichert.
Was der Wächter überprüft
Eine Tabelle zählt als Mandanten-bezogen wenn sie die Mandantenspalte hat. Eine Anweisung, die aus ihr liest, sie aktualisiert oder löscht, muss diese Spalte in einer WHERE oder
JOIN ... ON Bedingung:
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
Die erste Anweisung bekommt im Editor eine Validierungs-Diagnose, mit einer Meldung wie `dbo.orders` ist mandantenbezogen über `tenant_id`, aber die Anweisung hat keinen `tenant_id`-Filter in WHERE oder JOIN ON.
- INSERT ist ausgenommen - die neuen Zeilen tragen ihren eigenen Mandantenwert.
- Das Tenant-Register ist ausgenommen - eine Tabelle, deren Primärschlüssel die Mandantenspalte ist, wie
tenants(tenant_id, name), ist die Liste der Mandanten, nicht die Mandantendaten. - Die Prüfung sucht die Spalte in einer Bedingung; sie beurteilt nicht den Wert, mit dem du sie vergleichst.
Die vier Modi
| Modus | Effekt |
|---|---|
| Aus | Der Standard für jede Datenbank. Der Schutz ist deaktiviert, und nichts Mandantenbezogenes wird angezeigt. Die Felder sind ausgeblendet, und Aus speichert keine Spalten- oder Tabelleneinstellungen, weshalb sie beim Schließen des Dialogs in Aus verworfen werden. |
| Erlaubt | Keine Warnungen oder Fehler wegen fehlender Mandantenfilter. Deine Spalten- und Tabelleneinstellungen bleiben erhalten. |
| Warnen | Ein fehlender Filter ist eine Validierungswarnung; Ausführen funktioniert trotzdem. |
| Erforderlich | Ein fehlender Filter ist ein Validierungsfehler. Beim Drücken von Ausführen wird der Batch abgelehnt und die Meldung landet in der Statusleiste, auch beim Ausführen gegen mehrere Ziele gleichzeitig. |
Wo es gespeichert wird
Einstellungen werden nach Server- und Datenbankname ohne Groß-/Kleinschreibung indexiert und als JSON gespeichert in
tenant-scoping.json im Anwendungsdatenordner von SQLly (unter macOS,
~/Library/Application Support/SQLLY). Eine Datenbank, die du nie konfigurierst, bleibt im Aus-Modus. Die Browser-Vorschau behält die Einstellungen nur für die aktuelle Sitzung.
Upgrade von einer früheren Version? Beim ersten Start der neuen Version werden einmalig alle bisher gespeicherten Einstellungen zur Mandantenabgrenzung gelöscht — auch Datenbanken, die du auf „Warnung“ oder „Erforderlich“ gesetzt hattest. Willst du den Schutz für eine Datenbank, öffne Mandantenabgrenzung und schalte ihn wieder ein.
Der Schutz benötigt die Spalten der Tabelle aus dem geladenen Schema-Modell, um zu erkennen, dass eine Tabelle tenant-spezifisch ist. Tabellen, die dem Modell nicht bekannt sind, werden nicht überprüft.