Ámbito de inquilinos

funcional

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

Apagado hasta que lo enciendas. Cada base de datos comienza en Apagado: sin advertencias de inquilino y sin ejecuciones bloqueadas hasta que elijas Permitido, Advertir u Obligatorio para esa base de datos en Herramientas › Alcance de inquilinos. El mismo valor predeterminado se aplica en todos los sitios donde SQLly verifica tu SQL: la aplicación de escritorio, la vista previa del navegador, el servidor de lenguaje y el motor de línea de comandos.

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.

Un guardián, no un reescritor. El ámbito de inquilinos nunca inyecta una cláusula WHERE ni edita tu SQL. Solo comprueba lo que escribiste, e incluso en modo Requerido solo bloquea ante un diagnóstico confirmado de filtro de inquilino ausente: ante la duda deja ejecutar en lugar de adivinar.
SQLly
Configuración de ámbito de inquilinos de SQLlyConfiguración de ámbito de inquilinos de SQLly
Ámbito de inquilinos: activa la protección para una base de datos e indica la columna de inquilino y la tabla de inquilinos.

Configurándolo para una base de datos SaaS

  1. 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.
  2. Elige un modo. Una descripción de una línea debajo de los botones explica qué hace el modo seleccionado.
  3. 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.
  4. 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.
  5. 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

ModoEfecto
DesactivadoEs 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.
PermitidoNo hay advertencias ni errores por filtros de inquilinos que falten. Tus ajustes de columnas y tablas se conservan.
AdvertirUn filtro ausente es una advertencia de validación; Ejecutar sigue funcionando.
ObligatorioUn 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.