운영 FAQ
Docker Hub에서 Milvus Docker 이미지를 가져오는 데 실패하면 어떻게 하나요?
Docker Hub에서 Milvus Docker 이미지를 가져오는 데 실패한 경우 다른 레지스트리 미러를 추가해 보세요.
중국 본토의 사용자는 /etc.docker/daemon.json의 레지스트리 미러 배열에 URL "https://registry.docker-cn.com"를 추가할 수 있습니다.
{
"registry-mirrors": ["https://registry.docker-cn.com"]
}
Milvus를 설치 및 실행하는 유일한 방법은 Docker인가요?
Docker는 Milvus를 배포하는 효율적인 방법이지만 유일한 방법은 아닙니다. 소스 코드에서 Milvus를 배포할 수도 있습니다. 이를 위해서는 Ubuntu(18.04 이상) 또는 CentOS(7 이상)가 필요합니다. 자세한 내용은 소스 코드에서 Milvus 빌드하기를 참조하세요.
리콜에 영향을 미치는 주요 요인은 무엇인가요?
리콜은 주로 인덱스 유형과 검색 매개변수에 의해 영향을 받습니다.
FLAT 인덱스의 경우, Milvus는 컬렉션 내에서 전수 스캔을 수행하며 100% 리턴합니다.
IVF 인덱스의 경우, nprobe 매개변수는 컬렉션 내에서 검색 범위를 결정합니다. nprobe를 늘리면 검색되는 벡터의 비율과 리콜이 증가하지만 쿼리 성능이 저하됩니다.
HNSW 인덱스의 경우, ef 매개변수는 그래프 검색의 폭을 결정합니다. ef를 높이면 그래프에서 검색되는 점의 수와 리콜이 증가하지만 쿼리 성능이 저하됩니다.
자세한 내용은 벡터 인덱싱을 참조하세요.
구성 파일에 대한 변경 사항이 적용되지 않는 이유는 무엇인가요?
Milvus는 런타임 중에 구성 파일 수정을 지원하지 않습니다. 구성 파일 변경 사항을 적용하려면 Milvus Docker를 다시 시작해야 합니다.
Milvus가 성공적으로 시작되었는지 어떻게 알 수 있나요?
Milvus가 Docker Compose를 사용하여 시작된 경우 docker ps 를 실행하여 실행 중인 Docker 컨테이너 수를 관찰하고 Milvus 서비스가 올바르게 시작되었는지 확인하세요.
Milvus 독립형의 경우, 실행 중인 Docker 컨테이너가 최소 3개(하나는 Milvus 서비스, 나머지 2개는 etcd 관리 및 스토리지 서비스)가 관찰되어야 합니다. 자세한 내용은 Milvus 독립형 설치하기를 참조하세요.
로그 파일의 시간이 시스템 시간과 다른 이유는 무엇인가요?
시간 차이는 일반적으로 호스트 시스템이 협정 세계시(UTC)를 사용하지 않기 때문입니다.
Docker 이미지 내의 로그 파일은 기본적으로 UTC를 사용합니다. 호스트 머신이 UTC를 사용하지 않는 경우 이 문제가 발생할 수 있습니다.
내 CPU가 Milvus를 지원하는지 어떻게 알 수 있나요?
Milvus의 컴퓨팅 작업은 CPU의 SIMD(단일 명령어, 다중 데이터) 확장 명령어 집합 지원 여부에 따라 달라집니다. Milvus 내에서 인덱스 구축과 벡터 유사성 검색을 위해서는 CPU의 SIMD 확장 명령어 세트 지원 여부가 중요합니다. 사용 중인 CPU가 다음 SIMD 명령어 세트 중 하나 이상을 지원하는지 확인하세요:
- SSE4.2
- AVX
- AVX2
- AVX512
lscpu 명령을 실행하여 CPU가 위에 언급된 SIMD 명령어 세트를 지원하는지 확인하세요:
$ lscpu | grep -e sse4_2 -e avx -e avx2 -e avx512
Milvus가 시작 중에 illegal instruction 을 반환하는 이유는 무엇인가요?
Milvus를 사용하려면 CPU가 SIMD 명령어 집합을 지원해야 합니다: SSE4.2, AVX, AVX2 또는 AVX512. CPU가 이 중 하나 이상을 지원해야 Milvus가 정상적으로 작동합니다. 시작 중에 illegal instruction 오류가 반환되면 CPU가 위의 네 가지 명령어 집합 중 어느 것도 지원하지 않는다는 뜻입니다.
CPU의 SIMD 명령어 세트 지원을 참조하세요.
Windows에 Milvus를 설치할 수 있나요?
예. 소스 코드 또는 바이너리 패키지에서 컴파일하여 Windows에 Milvus를 설치할 수 있습니다.
Windows에서 Milvus를 설치하는 방법을 알아보려면 Windows에서 Milvus 실행하기를 참조하세요.
Windows에 pymilvus를 설치할 때 오류가 발생했습니다. 어떻게 해야 하나요?
Windows에 PyMilvus를 설치하지 않는 것이 좋습니다. 그러나 Windows에 PyMilvus를 설치해야 하는데 오류가 발생하면 Conda 환경에서 설치해 보세요. Conda 환경에서 PyMilvus를 설치하는 방법에 대한 자세한 내용은 Milvus SDK 설치하기를 참조하세요.
인터넷 연결이 끊긴 상태에서도 Milvus를 배포할 수 있나요?
예. 오프라인 환경에서도 Milvus를 설치할 수 있습니다. 자세한 내용은 Milvus 오프라인 설치를 참조하세요.
Milvus에서 생성된 로그는 어디에서 찾을 수 있나요?
Milvus 로그는 기본적으로 stout(표준 출력) 및 stderr(표준 오류)로 인쇄되지만, 프로덕션 환경에서 로그를 영구 볼륨으로 리디렉션하는 것을 적극 권장합니다. 이렇게 하려면 milvus.yaml에서 log.file.rootPath 을 업데이트하세요. 또한 milvus-helm 차트와 함께 Milvus를 배포하는 경우, --set log.persistence.enabled=true 을 통해 로그 지속성을 먼저 활성화해야 합니다.
구성을 변경하지 않은 경우, kubectl 로그 <팟-네임> 또는 docker 로그 CONTAINER를 사용하는 것도 로그를 찾는 데 도움이 될 수 있습니다.
세그먼트에 데이터를 삽입하기 전에 세그먼트에 대한 인덱스를 생성할 수 있나요?
예, 가능합니다. 하지만 각 세그먼트를 색인하기 전에 데이터를 일괄적으로 삽입하는 것이 좋으며, 각 데이터는 256MB를 넘지 않아야 합니다.
여러 Milvus 인스턴스 간에 etcd 인스턴스를 공유할 수 있나요?
예, 여러 Milvus 인스턴스 간에 etcd 인스턴스를 공유할 수 있습니다. 이렇게 하려면 시작하기 전에 각 Milvus 인스턴스의 구성 파일에서 etcd.rootPath 을 각 인스턴스마다 별도의 값으로 변경해야 합니다.
여러 Milvus 인스턴스 간에 Pulsar 인스턴스를 공유할 수 있나요?
예. 여러 Milvus 인스턴스 간에 Pulsar 인스턴스를 공유할 수 있습니다. 공유하려면 다음과 같이 하세요.
- Pulsar 인스턴스에서 멀티 테넌시가 활성화된 경우, 각 Milvus 인스턴스에 대해 별도의 테넌트 또는 네임스페이스를 할당하는 것을 고려하세요. 이렇게 하려면 시작하기 전에 Milvus 인스턴스의 구성 파일에서
pulsar.tenant또는pulsar.namespace을 각각 고유한 값으로 변경해야 합니다. - Pulsar 인스턴스에서 멀티 테넌시를 활성화하지 않으려는 경우, 시작하기 전에 Milvus 인스턴스의 구성 파일에서
msgChannel.chanNamePrefix.cluster을 각각 고유한 값으로 변경하는 것을 고려하세요.
여러 Milvus 인스턴스 간에 MinIO 인스턴스를 공유할 수 있나요?
예, 여러 Milvus 인스턴스 간에 MinIO 인스턴스를 공유할 수 있습니다. 이렇게 하려면 시작하기 전에 각 Milvus 인스턴스의 구성 파일에서 minio.rootPath 을 각 Milvus 인스턴스마다 고유한 값으로 변경해야 합니다.
pymilvus.exceptions.ConnectionConfigException: <ConnectionConfigException: (code=1, message=Illegal uri: [example.db], expected form 'https://user:pwd@example.com:12345')> 오류 메시지는 어떻게 처리하나요?
오류 메시지 Illegal uri [example.db] 는 이 연결 유형을 지원하지 않는 이전 버전의 PyMilvus를 사용하여 Milvus Lite에 연결하려고 한다는 것을 나타냅니다. 이 문제를 해결하려면 PyMilvus 설치를 Milvus Lite 연결 지원이 포함된 버전 2.4.2 이상으로 업그레이드하세요.
다음 명령을 사용하여 PyMilvus를 업그레이드할 수 있습니다:
pip install pymilvus>=2.4.2
검색/쿼리에서 설정한 limit 보다 적은 수의 결과가 표시되는 이유는 무엇인가요?
지정한 limit 보다 적은 수의 결과가 표시되는 데에는 몇 가지 이유가 있습니다:
제한된 데이터: 컬렉션에 요청한 제한을 충족할 만큼 충분한 엔티티가 없을 수 있습니다. 컬렉션의 총 엔티티 수가 한도보다 적으면 당연히 더 적은 수의 결과를 받게 됩니다.
중복된 기본 키: Milvus는 검색 중에 중복된 기본 키를 발견하면 특정 엔티티에 우선순위를 둡니다. 이 동작은 검색 유형에 따라 달라집니다:
쿼리(정확히 일치): Milvus는 일치하는 PK가 있는 최신 엔티티를 선택합니다. ANN 검색: Milvus는 엔티티가 동일한 PK를 공유하더라도 유사성 점수가 가장 높은 엔티티를 선택합니다. 컬렉션에 중복된 기본 키가 많은 경우 이 우선 순위 지정으로 인해 제한보다 적은 수의 고유한 결과가 나올 수 있습니다.
불충분한 일치: 검색 필터링 표현식이 너무 엄격하여 유사성 임계값을 충족하는 엔티티 수가 적을 수 있습니다. 검색에 설정된 조건이 너무 제한적이면 일치하는 엔티티가 충분하지 않아 예상보다 적은 수의 결과가 나옵니다.
MilvusClient("milvus_demo.db") gives an error: ModuleNotFoundError: No module named 'milvus_lite'. 이 오류의 원인은 무엇이며 어떻게 해결할 수 있나요?
이 오류는 Windows 플랫폼에서 Milvus Lite를 사용하려고 할 때 발생합니다. Milvus Lite는 주로 Linux 환경을 위해 설계되었으며 Windows에 대한 기본 지원이 없을 수 있습니다.
해결책은 Linux 환경을 활용하는 것입니다:
- Linux 기반 운영 체제 또는 가상 머신을 사용하여 Milvus Lite를 실행합니다.
- 이 접근 방식은 라이브러리의 종속성 및 기능과의 호환성을 보장합니다.
Milvus에서 "길이가 최대 길이를 초과함" 오류란 무엇이며 어떻게 이해하고 해결할 수 있나요?
Milvus의 "길이가 최대 길이를 초과함" 오류는 데이터 요소의 크기가 컬렉션 또는 필드에 허용되는 최대 크기를 초과할 때 발생합니다. 다음은 몇 가지 예와 설명입니다:
JSON 필드 오류:
<MilvusException: (code=1100, message=the length (398324) of json field (metadata) exceeds max length (65536): expected=valid length json string, actual=length exceeds max length: invalid parameter)>문자열 길이 오류:
<ParamError: (code=1, message=invalid input, length of string exceeds max length. length: 74238, max length: 60535)>VarChar 필드 오류:
<MilvusException: (code=1100, message=the length (60540) of 0th VarChar paragraph exceeds max length (0)%!(EXTRA int64=60535): invalid parameter)>
이러한 오류를 이해하고 해결하려면 다음과 같이 하세요:
- Python에서
len(str)은 바이트 단위의 크기가 아니라 문자 수를 나타냅니다. - VARCHAR 및 JSON과 같은 문자열 기반 데이터 유형의 경우
len(bytes(str, encoding='utf-8'))을 사용하여 실제 크기를 바이트 단위로 확인하며, 이는 Milvus가 "최대 길이"에 사용하는 것입니다.
Python의 예제:
# Python Example: result of len() str cannot be used as "max-length" in Milvus
>>> s = "你好，世界！"
>>> len(s) # Number of characters of s.
6
>>> len(bytes(s, "utf-8")) # Size in bytes of s, max-length in Milvus.
18
질문이 더 있으신가요?
그럴 수 있습니다:
