Escopo de inquilino

funcional

Configure o protetor de filtro ausente multilocatário: se ele será executado, a coluna de locatário e a tabela de locatários.

Configure no SQLly o proteção contra filtros ausentes para o banco de dados atual. Quatro modos: Desativado (o padrão, nada relacionado ao locatário é mostrado), Permitido (reconhecer filtros de locatário, nunca reclamar), Avisar (uma tabela com escopo de locatário consultada sem seu predicado de locatário gera um aviso de validação), e Obrigatório (essa omissão se torna um erro bloqueante e Executar recusa). É assim que você ensina ao SQLly o que «esqueceu o filtro de locatário» significa para seu esquema.

Desativado até você ativá-lo. Todo banco de dados começa em Desativado: sem avisos de inquilino e sem execuções bloqueadas até você escolher Permitido, Aviso ou Obrigatório para esse banco de dados em Ferramentas › Escopo do Locatário.... O mesmo padrão vale em todo lugar onde o SQLly verifica o seu SQL - no aplicativo de desktop, na pré-visualização no navegador, no servidor de linguagem e no motor de linha de comando.

Deixe a coluna de tenant em branco e o guardião usa as convenções usuais - TenantId, AccountId, OrganizationId, OrgId e suas formas com sublinhado - ou nomeie uma coluna sua para restringir a detecção. Opcionalmente, aponte para a própria tabela de inquilinos, com suas colunas id e display-name. As alterações são salvas a cada pressionamento de tecla e se aplicam à próxima validação; as configurações ficam por servidor e banco de dados em um arquivo local simples, como o resto da sua configuração do SQLly.

Uma proteção, não um reescritor. O Escopo de inquilino nunca injeta uma cláusula WHERE nem edita o seu SQL. Ele só verifica o que você escreveu, e mesmo no modo Obrigatório bloqueia apenas com base em um diagnóstico confirmado de filtro de inquilino ausente, preferindo falhar aberto a adivinhar.
SQLly
Configuração de Escopo de Locatário do SQLLYConfiguração de Escopo de Locatário do SQLLY
Escopo de inquilino: ative a proteção para um banco de dados e informe a coluna de inquilino e a tabela de inquilinos.

Configuração para um banco de dados SaaS

  1. Clique com o botão direito no banco de dados e escolha Ferramentas › Escopo do Locatário…, ou execute Escopo de inquilino do paleta de comandos enquanto conectado a ele. O título mostra o servidor e o banco de dados sendo configurados.
  2. Escolha um modo. Uma descrição em uma linha abaixo dos botões explica o que o modo selecionado faz.
  3. Se a sua coluna de tenant não tiver um dos nomes convencionais - digamos que seja customer_id - digite-o Coluna de inquilino. Depois que você nomeia uma coluna, só essa coluna marca a tabela como vinculada a um tenant.
  4. Preencha opcionalmente Tabela de inquilinos. Seus Coluna de id do inquilino e Coluna de nome de exibição do inquilino campos aparecem assim que uma tabela é nomeada.
  5. Feche o diálogo. Não há botão Salvar; toda alteração já está armazenada.

O que o guardião verifica

Uma tabela conta como com escopo de locatário quando ela tem a coluna de tenant. Uma instrução que lê, atualiza ou exclui dela precisa mencionar essa coluna em uma WHERE ou JOIN ... ON condição:

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

A primeira instrução recebe um diagnóstico de validação no editor, com uma mensagem como `dbo.orders` é isolado por tenant por meio de `tenant_id`, mas a instrução não tem filtro `tenant_id` no WHERE ou no JOIN ON.

  • INSERT está isento - as novas linhas trazem o próprio valor de locatário delas.
  • O registro de inquilinos está isento - uma tabela cuja chave primária é a coluna de locatário, como tenants(tenant_id, name), é a lista de locatários, não os dados do locatário.
  • A verificação procura a coluna em uma condição; não julga o valor com o qual você a compara.

Os quatro modos

ModoEfeito
DesativadoO padrão para cada banco de dados. A proteção está desativada e nada relacionado a locatário é mostrado. Os campos ficam ocultos, e Off não armazena nenhuma configuração de coluna ou tabela, então fechar o diálogo em Off as descarta.
PermitidoSem avisos ou erros sobre filtros de locatário faltando. Suas configurações de coluna e tabela são mantidas.
AvisarUm filtro ausente é um aviso de validação; Executar continua funcionando.
ObrigatórioUm filtro ausente é um erro de validação. Executar recusa o lote e mostra a mensagem na barra de status, inclusive ao executar contra vários destinos ao mesmo tempo.

Onde está armazenado

As configurações são indexadas pelo nome do servidor e do banco de dados, ignorando maiúsculas e minúsculas, e salvas como JSON em tenant-scoping.json na pasta de dados do aplicativo do SQLly (no macOS, ~/Library/Application Support/SQLLY). Um banco de dados que você nunca configura fica no modo Desativado. A pré-visualização do navegador mantém as configurações só para a sessão atual.

Atualizando de uma versão anterior? Na primeira vez que a nova versão inicia, ela limpa todas as configurações de escopo de locatário salvas anteriormente, uma vez - incluindo bancos de dados que você havia definido como Avisar ou Obrigatório. Se quiser a proteção em um banco de dados, abra Escopo de Locatário e ative a proteção novamente.

A proteção precisa das colunas da tabela do modelo de esquema carregado para saber que uma tabela tem escopo de locatário. Tabelas que o modelo não conhece não são verificadas.