서비스에 Milvus 연결 중

다음 명령어 중 하나를 실행하여 연결하십시오 Milvus:

시작하기 전에

다음 항목이 설치되어 있거나 사용 가능한지 확인하십시오.

  • Python 및 Pymilvus 패키지. 자세한 내용은 다음을 참조하세요.에 대한PyMilvus.
  • Milvus 인스턴스의 호스트 이름 및 포트입니다. 인프라 관리자에서 Milvus hostport 정보를 얻을 수 있습니다( Milvus 서비스를 클릭하여 세부 정보 페이지를 열고 GRPC 호스트의 hostport 정보에 유의하세요).
  • 사용자에게 역할을 할당하거나 서비스 ID ~에서인프라 관리자. 사용자 역할에 대한 자세한 내용은 역할 및 권한 관리하기를 참조하세요.

프로시저

버전부터 2.2.0watsonx.data, 와 ibmlhtoken 를 사용자 이름으로 ibmlhapikey 사용하는 인증은 더 이상 권장되지 않습니다. 이러한 형식은 출시 2.3.0 과정에서 단계적으로 폐지됩니다. 향후 버전과의 호환성을 보장하려면 새 형식을 사용하세요:ibmlhapikey_<username>ibmlhtoken_<username>.

API 키 또는 IAM 토큰을 사용하여 Milvus 서비스에 연결할 수 있습니다.

  1. watsonx.data Milvus 서비스를 프로비저닝합니다. 자세한 내용은 Milvus 서비스 추가하기를 참조하세요.

  2. Python SDK PyMilvus 를 사용하여 다음 명령어 중 하나를 실행하여 Milvus 연결하여 gRPC 경로를 설정합니다:

    • 다음 명령 중 하나를 사용하여 GRPC 호출을 통해 Milvus 에 연결합니다

      print(fmt.format("start connecting to Milvus"))
      connections.connect(host="<host>", port="<port>", secure=True, user="ibmlhapikey_<username>", password="<api-key>")
      has = utility.has_collection("hello_milvus")
      print(f"Does collection hello_milvus exist in Milvus: {has}")
      

      or

      from pymilvus import MilvusClient, DataType
      
      client = MilvusClient(
         host=<host>,
         port=<port>,
         secure=True,
         user="ibmlhapikey_<username>",
         password="<api-key>"
      )
      

      API 키로 IBM 를 <api-key> 대체하십시오. API 키를 얻는 방법에 대한 정보는 API 키 IBM 얻기를 참조하십시오.

    • 다음 명령 중 하나를 사용하여 IAM 토큰을 사용하여 Milvus 에 연결하십시오

      connections.connect(host="<host>", port="<port>", secure=True, user="ibmlhtoken_<username>", password="<token>")
      

      or

      from pymilvus import MilvusClient, DataType
      
      milvus_uri = "https://<ibmlhtoken_<username>>:<token>@<host>:<port>"
      client = MilvusClient(
          uri=milvus_uri,
          secure=True
      )
      

      IAM 토큰으로 <token> 대체하십시오. 토큰 획득에 대한 정보는 액세스 관리(IAM)IBM 토큰 획득을 참조하십시오.

    • 다음 명령 중 하나를 사용하여 URI(Uniform Resource Identifier)를 사용하여 Milvus 에 연결하십시오

      print(fmt.format("start connecting to Milvus"))
      connections.connect( alias="default", uri="https://<host>:<grpc-port>", user = "ibmlhtoken_<username>", password = "<token>" )
      has = utility.has_collection("hello_milvus")
      print(f"Does collection hello_milvus exist in Milvus: {has}")
      

      or

      from pymilvus import MilvusClient, DataType
      
      milvus_uri = "https://<ibmlhapikey_<username>>:<api-key>@<host>:<port>"
      client = MilvusClient(
         uri=milvus_uri,
         secure=True
      )
      

      IAM 토큰으로 <token> 대체하십시오. 토큰 획득에 대한 정보는 액세스 관리(IAM)IBM 토큰 획득을 참조하십시오.

  3. REST 경로를 사용하여 Milvus 에 연결하고 API 호출을 하려면 다음 명령을 실행합니다:

    curl --request GET \
         --url "https://<REST-host>:<REST-port>/api/v1/vector/collections" \
         --header "Authorization: Basic $(echo -n '<user>:<password>' | base64)" \
         --header "Content-Type: application/json"
    

    자세한 내용은 RESTful API 참조를 참조하세요.

    프록시 경로를 통해 API를 사용하는 것이 좋습니다. REST 경로를 통한 API는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 수 있습니다.

  4. 프록시 경로를 사용하여 Milvus 에 연결하고 API 호출을 하려면 다음 명령을 실행합니다:

    curl --request POST \
    --url "https://<proxy-host>:<port>/v2/vectordb/collections/list" \
    --header "Authorization: Basic $(echo -n 'user:password' | base64)" \
    --header "Content-Type: application/json" \
    -d '{
        "dbName": "default"
    }'
    

    예를 들어, 다음과 같습니다.

    curl --request POST \
    --url "https://e633a638-420b-499c-9291-288e425a2d25.cdc406pd09pasng7elgg.lakehouse.dev.appdomain.cloud:32699/v2/vectordb/collections/list" \
    --header 'accept: application/json' \
    --header "Authorization: Basic $(echo -n 'ibmlhapikey_<username>:<value of api key>' | base64)" \
    --header 'Content-Type: application/json'
    -d '{
        "dbName": "default"
    }'
    

버전 watsonx.data 기준 2.2, API 버전 사용을 v2/ 권장합니다. 해당 API 버전은 향후 릴리스에서 사용 v1/ 중단되고 제거될 수 있습니다.

버전 v2/Milvus API에서는 서비스에 Milvus 대해 사용자 및 역할 범주의 watsonx.data API가 지원되지 않습니다. 자세한 내용은 API를 Milvus 참조하십시오.

다음에 수행할 작업

Milvus 서비스와 연결을 설정한 후 다음 작업을 수행할 수 있습니다:

  • 데이터 관리

  • 데이터베이스 관리: Milvus 데이터베이스를 생성하고 특정 사용자에게 권한을 할당하여 관리할 수 있습니다. Milvus 클러스터는 최대 64개의 데이터베이스를 지원합니다. 자세한 내용은 다음을 참조하세요.데이터베이스 관리.

  • 컬렉션 관리: 원하는 SDK를 사용하여 컬렉션을 만들고 관리할 수 있습니다. Milvus 클러스터는 최대 65,536개의 컬렉션을 지원합니다. 자세한 내용은 다음을 참조하세요.컬렉션 관리.

  • 파티션 관리: 컬렉션에서 파티션을 만들고 관리할 수 있습니다. Milvus 클러스터는 최대 4095개의 파티션을 지원합니다. 자세한 내용은 다음을 참조하세요.파티션 관리.

  • 인덱스 관리: 컬렉션의 벡터 필드에 인덱스를 만들고 관리할 수 있습니다. 자세한 내용은 인덱스 관리를 참조하세요.

  • 검색 및 쿼리: Milvus 에서 데이터를 검색하고 쿼리하는 방법에 대한 정보는 검색, 쿼리 및 가져오기를 참조하세요.

관련 API

관련 API에 대한 정보는 다음을 참조하십시오