Escopo de inquilino
funcionalConfigure 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.
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.


Configuração para um banco de dados SaaS
- 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.
- Escolha um modo. Uma descrição em uma linha abaixo dos botões explica o que o modo selecionado faz.
- 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. - 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.
- 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
| Modo | Efeito |
|---|---|
| Desativado | O 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. |
| Permitido | Sem avisos ou erros sobre filtros de locatário faltando. Suas configurações de coluna e tabela são mantidas. |
| Avisar | Um filtro ausente é um aviso de validação; Executar continua funcionando. |
| Obrigatório | Um 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.