1"use strict";(self.webpackChunkspring_ai_alibaba_website=self.webpackChunkspring_ai_alibaba_website||[]).push([[3073],{476:(e,i,n)=>{n.r(i),n.d(i,{assets:()=>d,contentTitle:()=>c,default:()=>h,frontMatter:()=>l,metadata:()=>r,toc:()=>o});const r=JSON.parse('{"id":"rag/vectordbs/milvus","title":"Milvus","description":"Milvus \u662f\u4e00\u4e2a\u5f00\u6e90\u5411\u91cf\u6570\u636e\u5e93\uff0c\u5728\u6570\u636e\u79d1\u5b66\u548c\u673a\u5668\u5b66\u4e60\u9886\u57df\u83b7\u5f97\u4e86\u5e7f\u6cdb\u5173\u6ce8\u3002\u5176\u7a81\u51fa\u7279\u70b9\u4e4b\u4e00\u662f\u5bf9\u5411\u91cf\u7d22\u5f15\u548c\u67e5\u8be2\u7684\u5f3a\u5927\u652f\u6301\u3002Milvus \u91c7\u7528\u6700\u5148\u8fdb\u7684\u7b97\u6cd5\u6765\u52a0\u901f\u641c\u7d22\u8fc7\u7a0b\uff0c\u4f7f\u5176\u5728\u68c0\u7d22\u76f8\u4f3c\u5411\u91cf\u65b9\u9762\u975e\u5e38\u9ad8\u6548\uff0c\u5373\u4f7f\u5728\u5904\u7406\u5927\u91cf\u6570\u636e\u96c6\u65f6\u4e5f\u662f\u5982\u6b64\u3002","source":"@site/integration/rag/vectordbs/milvus.md","sourceDirName":"rag/vectordbs","slug":"/rag/vectordbs/milvus","permalink":"/integration/rag/vectordbs/milvus","draft":false,"unlisted":false,"editUrl":"https://github.com/spring-ai-alibaba/website/tree/main/integration/rag/vectordbs/milvus.md","tags":[],"version":"current","lastUpdatedBy":"Ken Liu","lastUpdatedAt":1768271906000,"frontMatter":{},"sidebar":"integrationSidebar","previous":{"title":"Elasticsearch","permalink":"/integration/rag/vectordbs/elasticsearch"},"next":{"title":"MongoDB Atlas","permalink":"/integration/rag/vectordbs/mongodb"}}');var s=n(74848),t=n(28453);const l={},c="Milvus",d={},o=[{value:"Prerequisites",id:"prerequisites",level:2},{value:"Dependencies",id:"dependencies",level:2},{value:"Manual Configuration",id:"manual-configuration",level:3},{value:"Metadata filtering",id:"metadata-filtering",level:2},{value:"Using MilvusSearchRequest",id:"using-milvussearchrequest",level:2},{value:"Importance of <code>nativeExpression</code> and <code>searchParamsJson</code> in <code>MilvusSearchRequest</code>",id:"importance-of-nativeexpression-and-searchparamsjson-in-milvussearchrequest",level:2},{value:"Milvus VectorStore properties",id:"milvus-properties",level:2},{value:"Starting Milvus Store",id:"starting-milvus-store",level:2},{value:"Troubleshooting",id:"troubleshooting",level:2},{value:"Accessing the Native Client",id:"accessing-the-native-client",level:2}];function a(e){const i={a:"a",blockquote:"blockquote",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",header:"header",li:"li",p:"p",pre:"pre",strong:"strong",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",ul:"ul",...(0,t.R)(),...e.components};return(0,s.jsxs)(s.Fragment,{children:[(0,s.jsx)(i.header,{children:(0,s.jsx)(i.h1,{id:"milvus",children:"Milvus"})}),"\n",(0,s.jsxs)(i.p,{children:[(0,s.jsx)(i.a,{href:"https://milvus.io/",children:"Milvus"})," \u662f\u4e00\u4e2a\u5f00\u6e90\u5411\u91cf\u6570\u636e\u5e93\uff0c\u5728\u6570\u636e\u79d1\u5b66\u548c\u673a\u5668\u5b66\u4e60\u9886\u57df\u83b7\u5f97\u4e86\u5e7f\u6cdb\u5173\u6ce8\u3002\u5176\u7a81\u51fa\u7279\u70b9\u4e4b\u4e00\u662f\u5bf9\u5411\u91cf\u7d22\u5f15\u548c\u67e5\u8be2\u7684\u5f3a\u5927\u652f\u6301\u3002Milvus \u91c7\u7528\u6700\u5148\u8fdb\u7684\u7b97\u6cd5\u6765\u52a0\u901f\u641c\u7d22\u8fc7\u7a0b\uff0c\u4f7f\u5176\u5728\u68c0\u7d22\u76f8\u4f3c\u5411\u91cf\u65b9\u9762\u975e\u5e38\u9ad8\u6548\uff0c\u5373\u4f7f\u5728\u5904\u7406\u5927\u91cf\u6570\u636e\u96c6\u65f6\u4e5f\u662f\u5982\u6b64\u3002"]}),"\n",(0,s.jsx)(i.h2,{id:"prerequisites",children:"Prerequisites"}),"\n",(0,s.jsxs)(i.ul,{children:["\n",(0,s.jsxs)(i.li,{children:["\u6b63\u5728\u8fd0\u884c\u7684 Milvus \u5b9e\u4f8b\u3002\u4ee5\u4e0b\u9009\u9879\u53ef\u7528\uff1a\n** ",(0,s.jsx)(i.a,{href:"https://milvus.io/docs/install_standalone-docker.md",children:"Milvus Standalone"}),"\uff1aDocker\u3001Operator\u3001Helm\u3001DEB/RPM\u3001Docker Compose\u3002\n** ",(0,s.jsx)(i.a,{href:"https://milvus.io/docs/install_cluster-milvusoperator.md",children:"Milvus Cluster"}),"\uff1aOperator\u3001Helm\u3002"]}),"\n",(0,s.jsxs)(i.li,{children:["\u5982\u679c\u9700\u8981\uff0c\u4e3a ",(0,s.jsx)(i.a,{href:"../embeddings#available-implementations",children:"EmbeddingModel"})," \u63d0\u4f9b\u4e00\u4e2a API key\uff0c\u7528\u4e8e\u751f\u6210 ",(0,s.jsx)(i.co
1de,{children:"MilvusVectorStore"})," \u5b58\u50a8\u7684\u5d4c\u5165\u3002"]}),"\n"]}),"\n",(0,s.jsx)(i.h2,{id:"dependencies",children:"Dependencies"}),"\n",(0,s.jsxs)(i.blockquote,{children:["\n",(0,s.jsxs)(i.p,{children:[(0,s.jsx)(i.strong,{children:"\u6ce8\u610f\uff1a"}),"\nSpring AI auto-configuration\u3001starter modules \u7684 artifact \u540d\u79f0\u53d1\u751f\u4e86\u91cd\u5927\u53d8\u5316\u3002\n\u8bf7\u53c2\u9605 ",(0,s.jsx)(i.a,{href:"https://docs.spring.io/spring-ai/reference/upgrade-notes.html",children:"upgrade notes"})," \u4e86\u89e3\u66f4\u591a\u4fe1\u606f\u3002"]}),"\n"]}),"\n",(0,s.jsx)(i.p,{children:"\u7136\u540e\u5c06 Milvus VectorStore boot starter \u4f9d\u8d56\u9879\u6dfb\u52a0\u5230\u60a8\u7684\u9879\u76ee\uff1a"}),"\n",(0,s.jsx)(i.pre,{children:(0,s.jsx)(i.code,{className:"language-xml",children:"<dependency>\n\t<groupId>org.springframework.ai</groupId>\n\t<artifactId>spring-ai-starter-vector-store-milvus</artifactId>\n</dependency>\n"})}),"\n",(0,s.jsxs)(i.p,{children:["\u6216\u6dfb\u52a0\u5230\u60a8\u7684 Gradle ",(0,s.jsx)(i.code,{children:"build.gradle"})," \u6784\u5efa\u6587\u4ef6\u3002"]}),"\n",(0,s.jsx)(i.pre,{children:(0,s.jsx)(i.code,{className:"language-groovy",children:"dependencies {\n implementation 'org.springframework.ai:spring-ai-starter-vector-store-milvus'\n}\n"})}),"\n",(0,s.jsxs)(i.blockquote,{children:["\n",(0,s.jsxs)(i.p,{children:[(0,s.jsx)(i.strong,{children:"\u63d0\u793a\uff1a"})," \u8bf7\u53c2\u9605 ",(0,s.jsx)(i.a,{href:"https://docs.spring.io/spring-ai/reference/getting-started.html#dependency-management",children:"Dependency Management"})," \u90e8\u5206\uff0c\u5c06 Spring AI BOM \u6dfb\u52a0\u5230\u60a8\u7684\u6784\u5efa\u6587\u4ef6\u4e2d\u3002\n\u8bf7\u53c2\u9605 ",(0,s.jsx)(i.a,{href:"https://docs.spring.io/spring-ai/reference/getting-started.html#artifact-repositories",children:"Artifact Repositories"})," \u90e8\u5206\uff0c\u5c06 Maven Central \u548c/\u6216 Snapshot Repositories \u6dfb\u52a0\u5230\u60a8\u7684\u6784\u5efa\u6587\u4ef6\u4e2d\u3002"]}),"\n"]}),"\n",(0,s.jsxs)(i.p,{children:["\u5411\u91cf\u5b58\u50a8\u5b9e\u73b0\u53ef\u4ee5\u4e3a\u60a8\u521d\u59cb\u5316\u6240\u9700\u7684 schema\uff0c\u4f46\u60a8\u5fc5\u987b\u901a\u8fc7\u5728\u9002\u5f53\u7684\u6784\u9020\u51fd\u6570\u4e2d\u6307\u5b9a ",(0,s.jsx)(i.code,{children:"initializeSchema"})," \u5e03\u5c14\u503c\u6216\u5728 ",(0,s.jsx)(i.code,{children:"application.properties"})," \u6587\u4ef6\u4e2d\u8bbe\u7f6e ",(0,s.jsx)(i.code,{children:"...initialize-schema=true"})," \u6765\u9009\u62e9\u52a0\u5165\u3002"]}),"\n",(0,s.jsxs)(i.blockquote,{children:["\n",(0,s.jsxs)(i.p,{children:[(0,s.jsx)(i.strong,{children:"\u6ce8\u610f\uff1a"})," \u8fd9\u662f\u4e00\u4e2a\u7834\u574f\u6027\u66f4\u6539\uff01\u5728 Spring AI \u7684\u65e9\u671f\u7248\u672c\u4e2d\uff0c\u6b64 schema \u521d\u59cb\u5316\u9ed8\u8ba4\u53d1\u751f\u3002"]}),"\n"]}),"\n",(0,s.jsxs)(i.p,{children:["Vector Store \u8fd8\u9700\u8981\u4e00\u4e2a ",(0,s.jsx)(i.code,{children:"EmbeddingModel"})," \u5b9e\u4f8b\u6765\u8ba1\u7b97\u6587\u6863\u7684\u5d4c\u5165\u3002\n\u60a8\u53ef\u4ee5\u9009\u62e9\u4e00\u4e2a\u53ef\u7528\u7684 ",(0,s.jsx)(i.a,{href:"../embeddings#available-implementations",children:"EmbeddingModel \u5b9e\u73b0"}),"\u3002"]}),"\n",(0,s.jsxs)(i.p,{children:["\u8981\u8fde\u63a5\u548c\u914d\u7f6e ",(0,s.jsx)(i.code,{children:"MilvusVectorStore"}),"\uff0c\u60a8\u9700\u8981\u63d0\u4f9b\u5b9e\u4f8b\u7684\u8bbf\u95ee\u8be6\u7ec6\u4fe1\u606f\u3002\n\u53ef\u4ee5\u901a\u8fc7 Spring Boot \u7684 ",(0,s.jsx)(i.code,{children:"application.yml"})," \u63d0\u4f9b\u7b80\u5355\u914d\u7f6e\uff1a"]}),"\n",(0,s.jsx)(i.pre,{children:(0,s.jsx)(i.code,{className:"language-yaml",children:'spring:\n\tai:\n\t\tvectorstore:\n\t\t\tmilvus:\n\t\t\t\tclient:\n\t\t\t\t\thost: "localhost"\n\t\t\t\t\tport: 19530\n\t\t\t\t\tusername: "root"\n\t\t\t\t\tpassword: "milvus"\n\t\t\t\tdatabaseName: "default"\n\t\t\t\tcollectionName: "vector_store"\n\t\t\t\tembeddingDimension: 1536\n\t\t\t\tindexType: IVF_FLAT\n\t\t\t\tmetricType: COSINE\n'})}),"\n",(0,s.jsxs)(i.blockquote,{children:["\n",(0,s.jsxs)(i.p,{children:[(0,s.jsx)(i.strong,{children:"\u63d0\u793a\uff1a"}
1)," \u67e5\u770b ",(0,s.jsx)(i.a,{href:"#milvus-properties",children:"configuration parameters"})," \u5217\u8868\u4ee5\u4e86\u89e3\u9ed8\u8ba4\u503c\u548c\u914d\u7f6e\u9009\u9879\u3002"]}),"\n"]}),"\n",(0,s.jsx)(i.p,{children:"\u73b0\u5728\u60a8\u53ef\u4ee5\u5728\u5e94\u7528\u7a0b\u5e8f\u4e2d\u81ea\u52a8\u88c5\u914d Milvus Vector Store \u5e76\u4f7f\u7528\u5b83"}),"\n",(0,s.jsx)(i.pre,{children:(0,s.jsx)(i.code,{className:"language-java",children:'@Autowired VectorStore vectorStore;\n\n// ...\n\nList <Document> documents = List.of(\n new Document("Spring AI rocks!! Spring AI rocks!! Spring AI rocks!! Spring AI rocks!! Spring AI rocks!!", Map.of("meta1", "meta1")),\n new Document("The World is Big and Salvation Lurks Around the Corner"),\n new Document("You walk forward facing the past and you turn back toward the future.", Map.of("meta2", "meta2")));\n\n// \u5c06\u6587\u6863\u6dfb\u52a0\u5230 Milvus Vector Store\nvectorStore.add(documents);\n\n// \u68c0\u7d22\u4e0e\u67e5\u8be2\u76f8\u4f3c\u7684\u6587\u6863\nList<Document> results = this.vectorStore.similaritySearch(SearchRequest.builder().query("Spring").topK(5).build());\n'})}),"\n",(0,s.jsx)(i.h3,{id:"manual-configuration",children:"Manual Configuration"}),"\n",(0,s.jsxs)(i.p,{children:["\u4e0d\u4f7f\u7528 Spring Boot auto-configuration\uff0c\u60a8\u53ef\u4ee5\u624b\u52a8\u914d\u7f6e ",(0,s.jsx)(i.code,{children:"MilvusVectorStore"}),"\u3002\n\u8981\u5c06\u4ee5\u4e0b\u4f9d\u8d56\u9879\u6dfb\u52a0\u5230\u60a8\u7684\u9879\u76ee\uff1a"]}),"\n",(0,s.jsx)(i.pre,{children:(0,s.jsx)(i.code,{className:"language-xml",children:"<dependency>\n\t<groupId>org.springframework.ai</groupId>\n\t<artifactId>spring-ai-milvus-store</artifactId>\n</dependency>\n"})}),"\n",(0,s.jsxs)(i.blockquote,{children:["\n",(0,s.jsxs)(i.p,{children:[(0,s.jsx)(i.strong,{children:"\u63d0\u793a\uff1a"})," \u8bf7\u53c2\u9605 ",(0,s.jsx)(i.a,{href:"https://docs.spring.io/spring-ai/reference/getting-started.html#dependency-management",children:"Dependency Management"})," \u90e8\u5206\uff0c\u5c06 Spring AI BOM \u6dfb\u52a0\u5230\u60a8\u7684\u6784\u5efa\u6587\u4ef6\u4e2d\u3002"]}),"\n"]}),"\n",(0,s.jsx)(i.p,{children:"\u8981\u5728\u5e94\u7528\u7a0b\u5e8f\u4e2d\u914d\u7f6e MilvusVectorStore\uff0c\u60a8\u53ef\u4ee5\u4f7f\u7528\u4ee5\u4e0b\u8bbe\u7f6e\uff1a"}),"\n",(0,s.jsx)(i.pre,{children:(0,s.jsx)(i.code,{className:"language-java",children:'\t@Bean\n\tpublic VectorStore vectorStore(MilvusServiceClient milvusClient, EmbeddingModel embeddingModel) {\n\t\treturn MilvusVectorStore.builder(milvusClient, embeddingModel)\n\t\t\t\t.collectionName("test_vector_store")\n\t\t\t\t.databaseName("default")\n\t\t\t\t.indexType(IndexType.IVF_FLAT)\n\t\t\t\t.metricType(MetricType.COSINE)\n\t\t\t\t.batchingStrategy(new TokenCountBatchingStrategy())\n\t\t\t\t.initializeSchema(true)\n\t\t\t\t.build();\n\t}\n\n\t@Bean\n\tpublic MilvusServiceClient milvusClient() {\n\t\treturn new MilvusServiceClient(ConnectParam.newBuilder()\n\t\t\t.withAuthorization("minioadmin", "minioadmin")\n\t\t\t.withUri(milvusContainer.getEndpoint())\n\t\t\t.build());\n\t}\n'})}),"\n",(0,s.jsx)(i.h2,{id:"metadata-filtering",children:"Metadata filtering"}),"\n",(0,s.jsxs)(i.p,{children:["\u60a8\u53ef\u4ee5\u5c06\u901a\u7528\u7684\u3001\u53ef\u79fb\u690d\u7684 ",(0,s.jsx)(i.a,{href:"https://docs.spring.io/spring-ai/reference/api/vectordbs.html#_metadata_filters",children:"metadata filters"})," \u4e0e Milvus \u5b58\u50a8\u4e00\u8d77\u4f7f\u7528\u3002"]}),"\n",(0,s.jsx)(i.p,{children:"\u4f8b\u5982\uff0c\u60a8\u53ef\u4ee5\u4f7f\u7528\u6587\u672c\u8868\u8fbe\u5f0f\u8bed\u8a00\uff1a"}),"\n",(0,s.jsx)(i.pre,{children:(0,s.jsx)(i.code,{className:"language-java",children:"vectorStore.similaritySearch(\n SearchRequest.builder()\n .query(\"The World\")\n .topK(TOP_K)\n .similarityThreshold(SIMILARITY_THRESHOLD)\n .filterExpression(\"author in ['john', 'jill'] && article_type == 'blog'\").build());\n"})}),"\n",(0,s.jsxs)(i.p,{children:["\u6216\u4f7f\u7528 ",(0,s.jsx)(i.code,{children:"Filter.Expression"})," DSL \u4ee5\u7f16\u7a0b\u65b9\u5f0f\uff1a"]}
1),"\n",(0,s.jsx)(i.pre,{children:(0,s.jsx)(i.code,{className:"language-java",children:'FilterExpressionBuilder b = new FilterExpressionBuilder();\n\nvectorStore.similaritySearch(SearchRequest.builder()\n .query("The World")\n .topK(TOP_K)\n .similarityThreshold(SIMILARITY_THRESHOLD)\n .filterExpression(b.and(\n b.in("author","john", "jill"),\n b.eq("article_type", "blog")).build()).build());\n'})}),"\n",(0,s.jsxs)(i.blockquote,{children:["\n",(0,s.jsxs)(i.p,{children:[(0,s.jsx)(i.strong,{children:"\u6ce8\u610f\uff1a"})," \u8fd9\u4e9b\u8fc7\u6ee4\u5668\u8868\u8fbe\u5f0f\u88ab\u8f6c\u6362\u4e3a\u7b49\u6548\u7684 Milvus \u8fc7\u6ee4\u5668\u3002"]}),"\n"]}),"\n",(0,s.jsx)(i.h2,{id:"using-milvussearchrequest",children:"Using MilvusSearchRequest"}),"\n",(0,s.jsx)(i.p,{children:"MilvusSearchRequest \u6269\u5c55\u4e86 SearchRequest\uff0c\u5141\u8bb8\u60a8\u4f7f\u7528 Milvus \u7279\u5b9a\u7684\u641c\u7d22\u53c2\u6570\uff0c\u4f8b\u5982\u539f\u751f\u8868\u8fbe\u5f0f\u548c\u641c\u7d22\u53c2\u6570 JSON\u3002"}),"\n",(0,s.jsx)(i.pre,{children:(0,s.jsx)(i.code,{className:"language-java",children:'MilvusSearchRequest request = MilvusSearchRequest.milvusBuilder()\n .query("sample query")\n .topK(5)\n .similarityThreshold(0.7)\n .nativeExpression("metadata[\\"age\\"] > 30") // \u5982\u679c\u540c\u65f6\u8bbe\u7f6e\u4e86 filterExpression\uff0c\u5219\u8986\u76d6\u5b83\n .filterExpression("age <= 30") // \u5982\u679c\u8bbe\u7f6e\u4e86 nativeExpression\uff0c\u5219\u88ab\u5ffd\u7565\n .searchParamsJson("{\\"nprobe\\":128}")\n .build();\nList results = vectorStore.similaritySearch(request);\n'})}),"\n",(0,s.jsx)(i.p,{children:"\u8fd9\u5728\u4f7f\u7528 Milvus \u7279\u5b9a\u7684\u641c\u7d22\u529f\u80fd\u65f6\u63d0\u4f9b\u4e86\u66f4\u5927\u7684\u7075\u6d3b\u6027\u3002"}),"\n",(0,s.jsxs)(i.h2,{id:"importance-of-nativeexpression-and-searchparamsjson-in-milvussearchrequest",children:["Importance of ",(0,s.jsx)(i.code,{children:"nativeExpression"})," and ",(0,s.jsx)(i.code,{children:"searchParamsJson"})," in ",(0,s.jsx)(i.code,{children:"MilvusSearchRequest"})]}),"\n",(0,s.jsx)(i.p,{children:"\u8fd9\u4e24\u4e2a\u53c2\u6570\u589e\u5f3a\u4e86 Milvus \u641c\u7d22\u7cbe\u5ea6\u5e76\u786e\u4fdd\u6700\u4f73\u67e5\u8be2\u6027\u80fd\uff1a"}),"\n",(0,s.jsxs)(i.p,{children:[(0,s.jsx)(i.em,{children:"nativeExpression"}),"\uff1a\u4f7f\u7528 Milvus \u7684\u539f\u751f\u8fc7\u6ee4\u8868\u8fbe\u5f0f\u542f\u7528\u989d\u5916\u7684\u8fc7\u6ee4\u529f\u80fd\u3002\n",(0,s.jsx)(i.a,{href:"https://milvus.io/docs/boolean.md",children:"Milvus Filtering"})]}),"\n",(0,s.jsx)(i.p,{children:"\u793a\u4f8b\uff1a"}),"\n",(0,s.jsx)(i.pre,{children:(0,s.jsx)(i.code,{className:"language-java",children:"MilvusSearchRequest request = MilvusSearchRequest.milvusBuilder()\n .query(\"sample query\")\n .topK(5)\n .nativeExpression(\"metadata['category'] == 'science'\")\n .build();\n"})}),"\n",(0,s.jsxs)(i.p,{children:[(0,s.jsx)(i.em,{children:"searchParamsJson"}),"\uff1a\u5728\u4f7f\u7528 IVF_FLAT\uff08Milvus \u7684\u9ed8\u8ba4\u7d22\u5f15\uff09\u65f6\uff0c\u5bf9\u4e8e\u8c03\u6574\u641c\u7d22\u884c\u4e3a\u81f3\u5173\u91cd\u8981\u3002\n",(0,s.jsx)(i.a,{href:"https://milvus.io/docs/index.md?tab=floating",children:"Milvus Vector Index"})]}),"\n",(0,s.jsxs)(i.p,{children:["\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c",(0,s.jsx)(i.code,{children:"IVF_FLAT"})," \u9700\u8981\u8bbe\u7f6e ",(0,s.jsx)(i.code,{children:"nprobe"})," \u624d\u80fd\u83b7\u5f97\u51c6\u786e\u7684\u7ed3\u679c\u3002\u5982\u679c\u672a\u6307\u5b9a\uff0c",(0,s.jsx)(i.code,{children:"nprobe"})," \u9ed8\u8ba4\u4e3a ",(0,s.jsx)(i.code,{children:"1"}),"\uff0c\u8fd9\u53ef\u80fd\u5bfc\u81f4\u53ec\u56de\u7387\u4f4e\u751a\u81f3\u96f6\u641c\u7d22\u7ed3\u679c\u3002"]}),"\n",(0,s.jsx)(i.p,{children:"\u793a\u4f8b\uff1a"}),"\n",(0,s.jsx)(i.pre,{children:(0,s.jsx)(i.code,{className:"language-java",children:'MilvusSearchRequest request = MilvusSearchRequest.milvusBuilder()\n .query("sample query")\n .topK(5)\n .searchParamsJson("{\\"nprobe\\":128}")\n .build();\n'})}
1),"\n",(0,s.jsxs)(i.p,{children:["\u4f7f\u7528 ",(0,s.jsx)(i.code,{children:"nativeExpression"})," \u786e\u4fdd\u9ad8\u7ea7\u8fc7\u6ee4\uff0c\u800c ",(0,s.jsx)(i.code,{children:"searchParamsJson"})," \u9632\u6b62\u7531\u4e8e\u9ed8\u8ba4 ",(0,s.jsx)(i.code,{children:"nprobe"})," \u503c\u8fc7\u4f4e\u800c\u5bfc\u81f4\u7684\u65e0\u6548\u641c\u7d22\u3002"]}),"\n",(0,s.jsx)(i.h2,{id:"milvus-properties",children:"Milvus VectorStore properties"}),"\n",(0,s.jsx)(i.p,{children:"\u60a8\u53ef\u4ee5\u5728 Spring Boot \u914d\u7f6e\u4e2d\u4f7f\u7528\u4ee5\u4e0b\u5c5e\u6027\u6765\u81ea\u5b9a\u4e49 Milvus \u5411\u91cf\u5b58\u50a8\u3002"}),"\n",(0,s.jsxs)(i.table,{children:[(0,s.jsx)(i.thead,{children:(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.th,{children:"Property"}),(0,s.jsx)(i.th,{children:"Description"}),(0,s.jsx)(i.th,{children:"Default value"})]})}),(0,s.jsxs)(i.tbody,{children:[(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.database-name"}),(0,s.jsx)(i.td,{children:"\u8981\u4f7f\u7528\u7684 Milvus \u6570\u636e\u5e93\u540d\u79f0\u3002"}),(0,s.jsx)(i.td,{children:"default"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.collection-name"}),(0,s.jsx)(i.td,{children:"\u5b58\u50a8\u5411\u91cf\u7684 Milvus collection \u540d\u79f0"}),(0,s.jsx)(i.td,{children:"vector_store"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.initialize-schema"}),(0,s.jsx)(i.td,{children:"\u662f\u5426\u521d\u59cb\u5316 Milvus \u540e\u7aef"}),(0,s.jsx)(i.td,{children:"false"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.embedding-dimension"}),(0,s.jsx)(i.td,{children:"\u8981\u5b58\u50a8\u5728 Milvus collection \u4e2d\u7684\u5411\u91cf\u7ef4\u5ea6\u3002"}),(0,s.jsx)(i.td,{children:"1536"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.index-type"}),(0,s.jsx)(i.td,{children:"\u8981\u4e3a Milvus collection \u521b\u5efa\u7684\u7d22\u5f15\u7c7b\u578b\u3002"}),(0,s.jsx)(i.td,{children:"IVF_FLAT"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.metric-type"}),(0,s.jsx)(i.td,{children:"\u7528\u4e8e Milvus collection \u7684\u5ea6\u91cf\u7c7b\u578b\u3002"}),(0,s.jsx)(i.td,{children:"COSINE"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.index-parameters"}),(0,s.jsx)(i.td,{children:"\u7528\u4e8e Milvus collection \u7684\u7d22\u5f15\u53c2\u6570\u3002"}),(0,s.jsx)(i.td,{children:(0,s.jsx)(i.code,{children:'{"nlist":1024}'})})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.id-field-name"}),(0,s.jsx)(i.td,{children:"collection \u7684 ID \u5b57\u6bb5\u540d\u79f0"}),(0,s.jsx)(i.td,{children:"doc_id"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.auto-id"}),(0,s.jsx)(i.td,{children:"\u5e03\u5c14\u6807\u5fd7\uff0c\u6307\u793a ID \u5b57\u6bb5\u662f\u5426\u4f7f\u7528 auto-id"}),(0,s.jsx)(i.td,{children:"false"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.content-field-name"}),(0,s.jsx)(i.td,{children:"collection \u7684\u5185\u5bb9\u5b57\u6bb5\u540d\u79f0"}),(0,s.jsx)(i.td,{children:"content"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.metadata-field-name"}),(0,s.jsx)(i.td,{children:"collection \u7684\u5143\u6570\u636e\u5b57\u6bb5\u540d\u79f0"}),(0,s.jsx)(i.td,{children:"metadata"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.embedding-field-name"}),(0,s.jsx)(i.td,{children:"collection \u7684\u5d4c\u5165\u5b57\u6bb5\u540d\u79f0"}),(0,s.jsx)(i.td,{children:"embedding"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.client.host"}),(0,s.jsx)(i.td,{children:"\u4e3b\u673a\u7684\u540d\u79f0\u6216\u5730\u5740\u3002"}),(0,s.jsx)(i.td,{children:"localhost"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.client.port"}),(0,s.jsx)(i.td,{children:"\u8fde\u63a5\u7aef\u53e3\u3002"}),(0,s.jsx)(i.td,{children:"19530"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.client.uri"}),(0,s.jsx)(i.td,{children:"Milvus \u5b9e\u4f8b\u7684 uri"}),(0,s.jsx)(i.td,{children:"-"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.client.token"}),(0,s.jsx)(i.td,{children:"\u7528\u4f5c\u8bc6\u522b\u548c\u8eab\u4efd\u9a8c\u8bc1\u76ee\u7684\u7684\u5bc6\u94a5\u7684\u4ee4\u724c\u3002"}),(0,s.jsx)(i.td,{children:"-"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.client.connect-timeout-ms"}),(0,s.jsx)(i.td,{children:"\u5ba2\u6237\u7aef\u901a\u9053\u7684\u8fde\u
163a5\u8d85\u65f6\u503c\u3002\u8d85\u65f6\u503c\u5fc5\u987b\u5927\u4e8e\u96f6\u3002"}),(0,s.jsx)(i.td,{children:"10000"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.client.keep-alive-time-ms"}),(0,s.jsx)(i.td,{children:"\u5ba2\u6237\u7aef\u901a\u9053\u7684 keep-alive \u65f6\u95f4\u503c\u3002keep-alive \u503c\u5fc5\u987b\u5927\u4e8e\u96f6\u3002"}),(0,s.jsx)(i.td,{children:"55000"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.client.keep-alive-timeout-ms"}),(0,s.jsx)(i.td,{children:"\u5ba2\u6237\u7aef\u901a\u9053\u7684 keep-alive \u8d85\u65f6\u503c\u3002\u8d85\u65f6\u503c\u5fc5\u987b\u5927\u4e8e\u96f6\u3002"}),(0,s.jsx)(i.td,{children:"20000"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.client.rpc-deadline-ms"}),(0,s.jsx)(i.td,{children:"\u60a8\u613f\u610f\u7b49\u5f85\u670d\u52a1\u5668\u56de\u590d\u7684\u622a\u6b62\u65f6\u95f4\u3002\u901a\u8fc7\u8bbe\u7f6e\u622a\u6b62\u65f6\u95f4\uff0c\u5ba2\u6237\u7aef\u5728\u9047\u5230\u7531\u7f51\u7edc\u6ce2\u52a8\u5f15\u8d77\u7684\u5feb\u901f RPC \u5931\u8d25\u65f6\u4f1a\u7b49\u5f85\u3002\u622a\u6b62\u65f6\u95f4\u503c\u5fc5\u987b\u5927\u4e8e\u6216\u7b49\u4e8e\u96f6\u3002"}),(0,s.jsx)(i.td,{children:"0"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.client.client-key-path"}),(0,s.jsx)(i.td,{children:'tls \u53cc\u5411\u8eab\u4efd\u9a8c\u8bc1\u7684 client.key \u8def\u5f84\uff0c\u4ec5\u5728 "secure" \u4e3a true \u65f6\u751f\u6548'}),(0,s.jsx)(i.td,{children:"-"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.client.client-pem-path"}),(0,s.jsx)(i.td,{children:'tls \u53cc\u5411\u8eab\u4efd\u9a8c\u8bc1\u7684 client.pem \u8def\u5f84\uff0c\u4ec5\u5728 "secure" \u4e3a true \u65f6\u751f\u6548'}),(0,s.jsx)(i.td,{children:"-"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.client.ca-pem-path"}),(0,s.jsx)(i.td,{children:'tls \u53cc\u5411\u8eab\u4efd\u9a8c\u8bc1\u7684 ca.pem \u8def\u5f84\uff0c\u4ec5\u5728 "secure" \u4e3a true \u65f6\u751f\u6548'}),(0,s.jsx)(i.td,{children:"-"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.client.server-pem-path"}),(0,s.jsx)(i.td,{children:'tls \u5355\u5411\u8eab\u4efd\u9a8c\u8bc1\u7684 server.pem \u8def\u5f84\uff0c\u4ec5\u5728 "secure" \u4e3a true \u65f6\u751f\u6548\u3002'}),(0,s.jsx)(i.td,{children:"-"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.client.server-name"}),(0,s.jsx)(i.td,{children:'\u8bbe\u7f6e SSL \u4e3b\u673a\u540d\u68c0\u67e5\u7684\u76ee\u6807\u540d\u79f0\u8986\u76d6\uff0c\u4ec5\u5728 "secure" \u4e3a True \u65f6\u751f\u6548\u3002\u6ce8\u610f\uff1a\u6b64\u503c\u4f20\u9012\u7ed9 grpc.ssl_target_name_override'}),(0,s.jsx)(i.td,{children:"-"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.client.secure"}
1),(0,s.jsx)(i.td,{children:"\u4fdd\u62a4\u6b64\u8fde\u63a5\u7684\u8eab\u4efd\u9a8c\u8bc1\uff0c\u8bbe\u7f6e\u4e3a True \u4ee5\u542f\u7528 TLS\u3002"}),(0,s.jsx)(i.td,{children:"false"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.client.idle-timeout-ms"}),(0,s.jsx)(i.td,{children:"\u5ba2\u6237\u7aef\u901a\u9053\u7684\u7a7a\u95f2\u8d85\u65f6\u503c\u3002\u8d85\u65f6\u503c\u5fc5\u987b\u5927\u4e8e\u96f6\u3002"}),(0,s.jsx)(i.td,{children:"24h"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.client.username"}),(0,s.jsx)(i.td,{children:"\u6b64\u8fde\u63a5\u7684\u7528\u6237\u540d\u548c\u5bc6\u7801\u3002"}),(0,s.jsx)(i.td,{children:"root"})]}),(0,s.jsxs)(i.tr,{children:[(0,s.jsx)(i.td,{children:"spring.ai.vectorstore.milvus.client.password"}),(0,s.jsx)(i.td,{children:"\u6b64\u8fde\u63a5\u7684\u5bc6\u7801\u3002"}),(0,s.jsx)(i.td,{children:"milvus"})]})]})]}),"\n",(0,s.jsx)(i.h2,{id:"starting-milvus-store",children:"Starting Milvus Store"}),"\n",(0,s.jsxs)(i.p,{children:["\u5728 ",(0,s.jsx)(i.code,{children:"src/test/resources/"})," \u6587\u4ef6\u5939\u4e2d\u8fd0\u884c\uff1a"]}),"\n",(0,s.jsx)(i.pre,{children:(0,s.jsx)(i.code,{className:"language-bash",children:"docker-compose up\n"})}),"\n",(0,s.jsx)(i.p,{children:"\u8981\u6e05\u7406\u73af\u5883\uff1a"}),"\n",(0,s.jsx)(i.pre,{children:(0,s.jsx)(i.code,{className:"language-bash",children:"docker-compose down; rm -Rf ./volumes\n"})}),"\n",(0,s.jsxs)(i.p,{children:["\u7136\u540e\u5728 ",(0,s.jsx)(i.a,{href:"http://localhost:19530",children:"http://localhost:19530"})," \u8fde\u63a5\u5230\u5411\u91cf\u5b58\u50a8\uff0c\u6216\u7528\u4e8e\u7ba1\u7406 ",(0,s.jsx)(i.a,{href:"http://localhost:9001",children:"http://localhost:9001"}),"\uff08\u7528\u6237\uff1a",(0,s.jsx)(i.code,{children:"minioadmin"}),"\uff0c\u5bc6\u7801\uff1a",(0,s.jsx)(i.code,{children:"minioadmin"}),"\uff09"]}),"\n",(0,s.jsx)(i.h2,{id:"troubleshooting",children:"Troubleshooting"}),"\n",(0,s.jsx)(i.p,{children:"\u5982\u679c Docker \u62b1\u6028\u8d44\u6e90\u95ee\u9898\uff0c\u5219\u6267\u884c\uff1a"}),"\n",(0,s.jsx)(i.pre,{children:(0,s.jsx)(i.code,{className:"language-bash",children:"docker system prune --all --force --volumes\n"})}),"\n",(0,s.jsx)(i.h2,{id:"accessing-the-native-client",children:"Accessing the Native Client"}),"\n",(0,s.jsxs)(i.p,{children:["Milvus Vector Store \u5b9e\u73b0\u901a\u8fc7 ",(0,s.jsx)(i.code,{children:"getNativeClient()"})," \u65b9\u6cd5\u63d0\u4f9b\u5bf9\u5e95\u5c42\u539f\u751f Milvus \u5ba2\u6237\u7aef\uff08",(0,s.jsx)(i.code,{children:"MilvusServiceClient"}),"\uff09\u7684\u8bbf\u95ee\uff1a"]}),"\n",(0,s.jsx)(i.pre,{children:(0,s.jsx)(i.code,{className:"language-java",children:"MilvusVectorStore vectorStore = context.getBean(MilvusVectorStore.class);\nOptional<MilvusServiceClient> nativeClient = vectorStore.getNativeClient();\n\nif (nativeClient.isPresent()) {\n MilvusServiceClient client = nativeClient.get();\n // \u4f7f\u7528\u539f\u751f\u5ba2\u6237\u7aef\u8fdb\u884c Milvus \u7279\u5b9a\u64cd\u4f5c\n}\n"})}),"\n",(0,s.jsxs)(i.p,{children:["\u539f\u751f\u5ba2\u6237\u7aef\u4f7f\u60a8\u53ef\u4ee5\u8bbf\u95ee\u53ef\u80fd\u672a\u901a\u8fc7 ",(0,s.jsx)(i.code,{children:"VectorStore"})," \u63a5\u53e3\u516c\u5f00\u7684 Milvus \u7279\u5b9a\u529f\u80fd\u548c\u64cd\u4f5c\u3002"]})]})}function h(e={}){const{wrapper:i}={...(0,t.R)(),...e.components};return i?(0,s.jsx)(i,{...e,children:(0,s.jsx)(a,{...e})}):a(e)}},28453:(e,i,n)=>{n.d(i,{R:()=>l,x:()=>c});var r=n(96540);const s={},t=r.createContext(s);function l(e){const i=r.useContext(t);return r.useMemo(function(){return"function"==typeof e?e(i):{...i,...e}},[i,e])}function c(e){let i;return i=e.disableParentContext?"function"==typeof e.components?e.components(s):e.components||s:l(e.components),r.createElement(t.Provider,{value:i},e.children)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.