Ámbito de inquilinos
funcionalConfigura la protección contra el filtro de inquilino ausente: si se aplica, la columna de inquilino y la tabla de inquilinos.
Configurar el multiinquilino de SQLly protección contra filtro faltante para la base de datos actual. Cuatro modos: Desactivado (el predeterminado, no se muestra nada relacionado con inquilinos), Permitido (reconoce filtros de inquilinos, nunca molesta), Advertir (una tabla acotada por inquilino que se consulta sin su predicado de inquilino genera una advertencia de validación), y Obligatorio (esa omisión se convierte en un error bloqueante y Ejecutar se niega a continuar). Así enseñas a SQLly qué significa «olvidaste el filtro de inquilino» para tu esquema.
Deja la columna de inquilino en blanco y el guardián usa las convenciones habituales -
TenantId, AccountId, OrganizationId,
OrgId y sus formas con guion bajo - o nombra tu propia columna para acotar la detección. Opcionalmente, apúntala a la propia tabla de inquilinos, con sus columnas id y display-name. Los cambios se guardan con cada tecla y se aplican en la siguiente validación; los ajustes viven por servidor y base de datos en un archivo local sencillo, como el resto de la configuración de SQLly.


Configurándolo para una base de datos SaaS
- Haz clic derecho en la base de datos y elige Herramientas › Alcance de inquilinos..., o ejecuta Ámbito de inquilinos desde la paleta de comandos mientras esté conectado a ella. El título muestra el servidor y la base de datos que se están configurando.
- Elige un modo. Una descripción de una línea debajo de los botones explica qué hace el modo seleccionado.
- Si tu columna de inquilino no tiene uno de los nombres convencionales - digamos que es
customer_id- escríbelo Columna de inquilino. Una vez que nombras una columna, solo esa columna marca una tabla con ámbito de inquilino. - Opcionalmente, rellena Tabla de inquilinos. Su Columna de id del inquilino y Columna del nombre visible del inquilino Los campos aparecen una vez que nombras una tabla.
- Cierra el diálogo. No hay botón de Guardar; todos los cambios ya quedan guardados.
Lo que comprueba la protección
Una tabla cuenta como con ámbito de inquilino cuando tiene la columna de inquilino. Una instrucción que lea, actualice o elimine de ella debe mencionar esa columna en una WHERE o
JOIN ... ON condición:
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
La primera instrucción obtiene un diagnóstico de validación en el editor, con un mensaje como `dbo.orders` está acotada por inquilino mediante `tenant_id`, pero la instrucción no tiene ningún filtro `tenant_id` en WHERE ni en JOIN ON.
- INSERT está exento - las filas nuevas llevan su propio valor de inquilino.
- El registro de inquilinos está exento - una tabla cuya clave primaria es la columna de inquilino, como
tenants(tenant_id, name), es la lista de inquilinos, no sus datos. - La verificación busca la columna en una condición; no juzga el valor con el que la comparas.
Los cuatro modos
| Modo | Efecto |
|---|---|
| Desactivado | Es el valor predeterminado para todas las bases de datos. La protección está desactivada y no se muestra nada relacionado con el inquilino. Los campos quedan ocultos y Desactivado no guarda ajustes de columnas ni de tablas, así que cerrar el diálogo con Desactivado los descarta. |
| Permitido | No hay advertencias ni errores por filtros de inquilinos que falten. Tus ajustes de columnas y tablas se conservan. |
| Advertir | Un filtro ausente es una advertencia de validación; Ejecutar sigue funcionando. |
| Obligatorio | Un filtro ausente es un error de validación: al pulsar Ejecutar se rechaza el lote y el mensaje se muestra en la barra de estado, incluso al ejecutar contra varios objetivos a la vez. |
Dónde se almacena
Los ajustes se identifican por nombre de servidor y de base de datos, sin distinguir mayúsculas de minúsculas, y se guardan como JSON en
tenant-scoping.json en la carpeta de datos de la aplicación de SQLly (en macOS,
~/Library/Application Support/SQLLY). Una base de datos que nunca configuras está en modo Apagado. La vista previa del navegador solo conserva los ajustes durante la sesión actual.
¿Actualizando desde una versión anterior? La primera vez que arranca la nueva versión, borra una sola vez todos los ajustes de delimitación de inquilinos guardados antes, incluidas las bases de datos que tenías en Advertir o Requerido. Si quieres la protección en una base de datos, abre Delimitación de inquilinos y actívala de nuevo.
La protección necesita las columnas de la tabla según el modelo de esquema cargado para saber que una tabla tiene ámbito por inquilino. Las tablas que el modelo no conoce no se comprueban.