근사 최근접 검색은 모든 벡터를 전수 비교하지 않고 인덱스의 후보를 따라 가까운 점을 찾습니다. 필터 결합 검색은 색상이나 테넌트 같은 조건을 후보 탐색과 함께 다룹니다.
필터를 탐색 뒤에만 적용하면 상위 후보가 모두 탈락해 필요한 결과 수를 채우지 못할 수 있습니다. 데모는 조건을 켰을 때 후보 집합과 반환 순서가 바뀌는 과정을 단순화해 보여줍니다.
언제 쓰나
벡터 검색 결과를 권한, 카테고리, 날짜 등으로 제한해야 할 때 씁니다.
필터 결합 근사 최근접 검색
Filtered approximate nearest-neighbor search
벡터 근접 탐색에 메타데이터 조건을 함께 적용합니다.
···
<div class="v"><header><b>FILTERED ANN</b><span id="state"></span></header><main><div class="plane" id="plane"></div><div class="legend" id="legend"></div></main><footer>index candidates respect filter</footer></div>.v{width:min(92vw,660px);height:min(86vh,310px);box-sizing:border-box;padding:clamp(9px,2.5vmin,18px);border:1px solid var(--line);border-radius:14px;background:var(--surface);display:flex;flex-direction:column;gap:7px;color:var(--fg);font:500 clamp(15px,4.5vmin,19px)/1.25 var(--font-sans, sans-serif)}.v header,.v footer{display:flex;justify-content:space-between;align-items:center;gap:8px;white-space:nowrap}.v header b{color:var(--accent);font-size:.9em}.v header span,.v footer{color:var(--muted);font-size:.82em}.v main{flex:1;min-height:0;position:relative;overflow:hidden}.v .mono{font-family:ui-monospace,SFMono-Regular,Consolas,monospace}.v .active{background:var(--accent)!important;color:var(--bg)!important;border-color:var(--accent)!important}.v .muted{opacity:.45} .plane{height:75%;position:relative;border:1px solid var(--line);border-radius:7px}.dot{position:absolute;width:13px;height:13px;border-radius:50%;background:var(--accent);transform:translate(-50%,-50%);transition:opacity .3s,transform .3s}.dot.blue{background:var(--accent-3)}.dot.hit{outline:2px solid var(--fg);outline-offset:3px;transform:translate(-50%,-50%) scale(1.2)}.query{position:absolute;left:48%;top:51%;font:700 1em ui-monospace,monospace}.legend{text-align:center;color:var(--muted);font-size:.8em}const pts=[[20,25,0],[38,35,1],[60,32,0],[75,25,1],[24,70,1],[42,65,0],[65,68,1],[80,75,0]];let filtered=false;function draw(){document.getElementById("plane").innerHTML=pts.map((p,i)=>"<i class=\"dot "+(p[2]?"blue ":"")+(filtered&&!p[2]?"muted ":"")+(i===(filtered?6:5)?"hit":"")+"\" style=\"left:"+p[0]+"%;top:"+p[1]+"%\"></i>").join("")+"<b class=query>Q</b>";document.getElementById("legend").textContent=filtered?"blue only → nearest eligible":"all points → nearest overall";document.getElementById("state").textContent=filtered?"filter ON":"filter OFF";filtered=!filtered}draw();setInterval(draw,1350)