Q: 컬렉션을 read_only=True로 열었는데도 zvec close()가 인덱스 파일을 수정하는 이유는 무엇인가요?

이는 zvec 0.7.0(Python) 및 0.7.2(Rust 바인딩)에서 알려진 버그입니다. 읽기 전용 Flat 또는 HNSW 인덱스를 닫을 때 내부 메타데이터가 무조건 플러시되어 `.proxima` 파일의 `update_time` 필드와 `footer_crc` 체크섬이 다시 기록되었습니다(일반적으로 파일당 약 6바이트). 데이터 손실이나 잘못된 쿼리 결과는 발생하지 않지만, 콘텐츠 해시/불변성 검사가 실패합니다. **수정:** zvec를 업그레이드하세요 — 수정 사항이 PR #834를 통해 `main`에 병합되었습니다. 이제 읽기 전용 닫기는 인덱스가 dirty 상태가 아닌 한 메타데이터 쓰기(타임스탬프/체크섬 업데이트)를 건너뛰며, 회귀 테스트를 통해 open/close 주기 전반에 걸쳐 파일이 바이트 단위로 변경되지 않음을 검증합니다. **영향받는 버전(0.7.0/0.7.2)에 대한 해결 방법:** 무결성 검사에 `.proxima` 인덱스 파일의 바이트 수준 파일 해시를 사용하지 마세요. 대신 벡터 페이로드만 해시하거나 문서 ID를 추적하세요. 쓰기는 네이티브 핸들을 해제하는 마지막 닫기에서만 트리거된다는 점에 유의하세요 — 캐시된 읽기 전용 핸들에 대한 반복된 쿼리는 파일을 수정하지 않습니다.

Q: Windows ARM64에서 MSVC로 zvec를 빌드할 때 발생하는 CMake 오류 "Target zvec_ailego is required by zvec_ailego_shared"를 해결하는 방법은 무엇인가요?

이 configure 시점 실패는 MSVC 툴셋이 적용된 Windows ARM64 환경의 zvec 0.5.1에 영향을 줍니다. `src/ailego/CMakeLists.txt`가 MSVC ARM64 경로에서 `return()`을 조기에 호출하므로 정적 타겟 `zvec_ailego`가 전혀 생성되지 않으며, 기본값인 `BUILD_ZVEC_AILEGO_SHARED=ON`이 여전히 이를 참조하여 CMake가 치명적 오류를 발생시킵니다. 해결 방법: MSVC ARM64에 대한 ailego CMake 및 아키텍처 매크로 처리를 수정한 PR #352(머지됨)가 포함된 main의 빌드로 zvec을 업그레이드하세요. 0.5.1에서의 우회 방법: (1) 누락된 정적 타겟이 참조되지 않도록 `-DBUILD_ZVEC_AILEGO_SHARED=OFF`로 configure하세요. (2) 영향을 받지 않는 GCC/Clang(Linux) 또는 AppleClang(macOS Apple Silicon)으로 ARM64 네이티브를 대신 빌드하세요. 또는 (3) `src/ailego/CMakeLists.txt`를 로컬에서 패치하여 MSVC `return()`을 제거하고 GCC 스타일의 `-march=armv8-a` 대신 MSVC 호환 ARM64 플래그를 사용하세요.

Q: 대규모 컬렉션에서 excludedFileTypes를 사용할 때 zvec QueryNode에서 발생하는 SIGSEGV 네이티브 스택 오버플로 크래시를 해결하는 방법

이 크래시는 PR #694에서 업스트림에 수정되었습니다(머지됨). `@zvec/zvec`와 이에 대응하는 네이티브 바인딩(예: `@zvec/bindings-linux-x64`)을 수정이 포함된 릴리스로 업그레이드한 다음 쿼리를 다시 시도하세요. 업그레이드할 수 있을 때까지는 `session.context()` 호출에서 `excludedFileTypes`를 제거하는 방식으로 우회하세요. zvec-grep의 `searchPlanToStorageFilter`는 이 제외 조건을 파일당 하나의 `file_id = '...' OR ...` 조건자로 확장하고(16k 파일 워크스페이스의 경우 약 15k개의 조건자), 재귀적인 sqlengine QueryNode 파서가 Linux x64 스택을 오버플로합니다. 파일 타입 제외가 없는 쿼리는 동일한 인덱스에서 정상적으로 반환됩니다.

Question 1

Windows ARM64에서 MSVC 19.51 (VS 2026)을 사용하여 /O2로 컴파일할 때 발생하는 MSVC C1001 내부 컴파일러 오류를 해결하는 방법

Accepted Answer

이것은 코드 버그가 아니라 MSVC 19.51 (VS 18.6) ARM64 옵티마이저 회귀입니다 — MSVC 19.44로 컴파일되던 코드가 `/O2 /Ob2` 하에서 `static_cast(codes[i]) * codes[i]`를 `int64_t`에 누적하는 루프가 상수로 채워진 벡터를 가진 호출자에 인라인될 때 cl.exe가 `fatal error C1001`로 크래시됩니다. 해결 방법 (어느 하나든 적용 가능): 1. 곱셈 피연산자를 64비트로 확장 (결과는 동일): ```cpp sum_squared += static_cast(codes[i]) * codes[i]; // static_cast(codes[i]) * codes[i] 대신 ``` 2. 해당 루프에 대해 벡터화 비활성화: ```cpp #pragma loop(no_vector) for (size_t i = 0; i < codes.size(); ++i) { ... } ``` 3. 누적을 별도의 루프로 분리. 또는 Microsoft가 회귀를 수정할 때까지 툴체인을 MSVC 14.44 (cl 19.44)로 고정하거나 다운그레이드하세요. Compiler Explorer에서 `arm64 msvc v19.51 VS18.6`, 플래그 `/DNDEBUG /O2 /Ob2 /EHsc -std:c++17 -MT /Zc:preprocessor /Zc:__cplusplus /W3`로 재현 가능합니다.

Question 2

컬렉션을 read_only=True로 열었는데도 zvec close()가 인덱스 파일을 수정하는 이유는 무엇인가요?

Accepted Answer

이는 zvec 0.7.0(Python) 및 0.7.2(Rust 바인딩)에서 알려진 버그입니다. 읽기 전용 Flat 또는 HNSW 인덱스를 닫을 때 내부 메타데이터가 무조건 플러시되어 `.proxima` 파일의 `update_time` 필드와 `footer_crc` 체크섬이 다시 기록되었습니다(일반적으로 파일당 약 6바이트). 데이터 손실이나 잘못된 쿼리 결과는 발생하지 않지만, 콘텐츠 해시/불변성 검사가 실패합니다.

**수정:** zvec를 업그레이드하세요 — 수정 사항이 PR #834를 통해 `main`에 병합되었습니다. 이제 읽기 전용 닫기는 인덱스가 dirty 상태가 아닌 한 메타데이터 쓰기(타임스탬프/체크섬 업데이트)를 건너뛰며, 회귀 테스트를 통해 open/close 주기 전반에 걸쳐 파일이 바이트 단위로 변경되지 않음을 검증합니다.

**영향받는 버전(0.7.0/0.7.2)에 대한 해결 방법:** 무결성 검사에 `.proxima` 인덱스 파일의 바이트 수준 파일 해시를 사용하지 마세요. 대신 벡터 페이로드만 해시하거나 문서 ID를 추적하세요. 쓰기는 네이티브 핸들을 해제하는 마지막 닫기에서만 트리거된다는 점에 유의하세요 — 캐시된 읽기 전용 핸들에 대한 반복된 쿼리는 파일을 수정하지 않습니다.

Question 3

Windows ARM64에서 MSVC로 zvec를 빌드할 때 발생하는 CMake 오류 "Target zvec_ailego is required by zvec_ailego_shared"를 해결하는 방법은 무엇인가요?

Accepted Answer

이 configure 시점 실패는 MSVC 툴셋이 적용된 Windows ARM64 환경의 zvec 0.5.1에 영향을 줍니다. `src/ailego/CMakeLists.txt`가 MSVC ARM64 경로에서 `return()`을 조기에 호출하므로 정적 타겟 `zvec_ailego`가 전혀 생성되지 않으며, 기본값인 `BUILD_ZVEC_AILEGO_SHARED=ON`이 여전히 이를 참조하여 CMake가 치명적 오류를 발생시킵니다. 해결 방법: MSVC ARM64에 대한 ailego CMake 및 아키텍처 매크로 처리를 수정한 PR #352(머지됨)가 포함된 main의 빌드로 zvec을 업그레이드하세요. 0.5.1에서의 우회 방법: (1) 누락된 정적 타겟이 참조되지 않도록 `-DBUILD_ZVEC_AILEGO_SHARED=OFF`로 configure하세요. (2) 영향을 받지 않는 GCC/Clang(Linux) 또는 AppleClang(macOS Apple Silicon)으로 ARM64 네이티브를 대신 빌드하세요. 또는 (3) `src/ailego/CMakeLists.txt`를 로컬에서 패치하여 MSVC `return()`을 제거하고 GCC 스타일의 `-march=armv8-a` 대신 MSVC 호환 ARM64 플래그를 사용하세요.

Question 4

대규모 컬렉션에서 excludedFileTypes를 사용할 때 zvec QueryNode에서 발생하는 SIGSEGV 네이티브 스택 오버플로 크래시를 해결하는 방법

Accepted Answer

이 크래시는 PR #694에서 업스트림에 수정되었습니다(머지됨). `@zvec/zvec`와 이에 대응하는 네이티브 바인딩(예: `@zvec/bindings-linux-x64`)을 수정이 포함된 릴리스로 업그레이드한 다음 쿼리를 다시 시도하세요. 업그레이드할 수 있을 때까지는 `session.context()` 호출에서 `excludedFileTypes`를 제거하는 방식으로 우회하세요. zvec-grep의 `searchPlanToStorageFilter`는 이 제외 조건을 파일당 하나의 `file_id = '...' OR ...` 조건자로 확장하고(16k 파일 워크스페이스의 경우 약 15k개의 조건자), 재귀적인 sqlengine QueryNode 파서가 Linux x64 스택을 오버플로합니다. 파일 타입 제외가 없는 쿼리는 동일한 인덱스에서 정상적으로 반환됩니다.

zvec

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트