Mandantenabgrenzung

funktional

Konfiguriere 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.

Ausgeschaltet, bis du es einschaltest. Jede Datenbank startet auf Aus: keine Mandantenwarnungen und keine blockierten Ausführungen, bis du für diese Datenbank in Werkzeuge › Mandantenabgrenzung. Derselbe Standard gilt überall dort, wo SQLly dein SQL prüft - in der Desktop-App, in der Browser-Vorschau, im Language Server und in der Kommandozeilen-Engine.

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.

Ein Guard, kein Umschreiber. Die Mandantenabgrenzung fügt niemals eine WHERE-Klausel ein und ändert dein SQL nicht. Sie prüft nur, was du geschrieben hast, und selbst im Modus „Erforderlich“ blockiert sie ausschließlich bei einer bestätigten Diagnose eines fehlenden Mandantenfilters und lässt im Zweifel zu, statt zu raten.
SQLly
SQLly Tenant-Scoping-KonfigurationSQLly Tenant-Scoping-Konfiguration
Mandantenabgrenzung: Aktiviere den Schutz für eine Datenbank und benenne die Mandantenspalte und die Mandantentabelle.

Einrichten für eine SaaS-Datenbank

  1. 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.
  2. Wähle einen Modus. Eine einzeilige Beschreibung unter den Schaltflächen erklärt, was der gewählte Modus macht.
  3. 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.
  4. Optional ausfüllen Mandantentabelle. Seine Mandanten-ID-Spalte und Spalte für Mandanten-Anzeigenamen Felder erscheinen, sobald eine Tabelle benannt wird.
  5. 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

ModusEffekt
AusDer 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.
ErlaubtKeine Warnungen oder Fehler wegen fehlender Mandantenfilter. Deine Spalten- und Tabelleneinstellungen bleiben erhalten.
WarnenEin fehlender Filter ist eine Validierungswarnung; Ausführen funktioniert trotzdem.
ErforderlichEin 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.