Busca em resumo
Três estratégias, um endpoint
| Estratégia | Alcançada por | Boa em |
|---|---|---|
| Texto completo | Uma consulta, sem atributo e sem o sinalizador tolerante | Consultas naturais sobre o texto indexado |
| Rótulo tolerante | Uma consulta com o sinalizador tolerante | Erros de digitação e quase-acertos no rótulo |
| Escopada a atributo | Uma consulta mais um atributo | Encontrar um registro por identificador, e-mail ou código |
O despacho é exclusivo — definir o sinalizador tolerante é a única forma de alcançar a correspondência tolerante de rótulo.
Atributos vinculados a lookup
O valor armazenado é o código; o rótulo é resolvido na leitura. A busca escopada a atributo casa também com o rótulo, então encontrar um lugar pelo nome funciona mesmo que um número seja o que está armazenado.
O que o controle de acesso faz
| Camada | Efeito nos resultados |
|---|---|
| Isolamento entre organizações | Apenas sua organização é pesquisável |
| Políticas ABAC | Registros negados ficam ausentes |
| Mascaramento de campos | Valores correspondidos vêm mascarados |
Um registro pode existir e estar oculto de você por uma política ABAC. Isso morde mais forte ao reconciliar contagens contra um sistema de origem, onde a divergência parece perda de dados.
A busca não é uma porta lateral: um valor mascarado ao ler uma entidade está mascarado nos resultados de busca para quem consulta.
Dois comportamentos a conhecer
Parâmetros desconhecidos são ignorados, não rejeitados. Um parâmetro com erro de grafia não produz erro — simplesmente não tem efeito, e você recebe resultados não filtrados que parecem filtrados.
A expansão de rótulo é limitada em 1000, com um sinal de truncamento. Gerar erro foi descartado: uma consulta de um caractere é uma busca por prefixo legítima.
A seguir
Última verificação no commit d3c2586b (2026-08-03)