Skip to content

milvus-io/milvus-sdk-java

Folders and files

NameName
Last commit message
Last commit date

Latest commit

bd8b543 · Feb 14, 2025
Dec 10, 2024
Aug 8, 2024
Feb 5, 2025
Feb 8, 2025
Feb 14, 2025
Jan 23, 2025
Feb 5, 2025
Dec 10, 2024
Jan 9, 2025
Nov 5, 2021
Dec 5, 2019
Dec 10, 2024
Oct 8, 2019
Jul 8, 2022
Jan 9, 2025
Feb 8, 2025
Jan 9, 2025

Repository files navigation

Milvus Java SDK

Maven Central

Java SDK for Milvus. To contribute to this project, please read our contribution guidelines first.

Getting started

Prerequisites

-   Java 8 or higher
-   Apache Maven or Gradle

The following table shows compatibilities between Milvus and Java SDK.

Milvus version Java SDK version
2.0 2.0.4
2.1 2.1.0-beta4
2.2.0 ~ 2.2.8 2.2.0 ~ 2.2.5
>= 2.2.9 2.2.7 ~ 2.2.15
2.3.x 2.3.11
2.4.x 2.4.10
2.5.x 2.5.4

Install Java SDK

You can use Apache Maven or Gradle add Milvus SDK to your project.

  • Apache Maven

     <dependency>
         <groupId>io.milvus</groupId>
         <artifactId>milvus-sdk-java</artifactId>
         <version>2.5.4</version>
     </dependency>
  • Gradle/Groovy

    implementation 'io.milvus:milvus-sdk-java:2.5.4'
  • Gradle/Kotlin

    implementation("io.milvus:milvus-sdk-java:2.5.4")

From v2.5.2, milvus Java SDK is split into two packages: milvus-sdk-java and milvus-sdk-java-bulkwriter, because BulkWriter requires quite a lot of dependencies. If you don't need BulkWriter tool, you can ignore the milvus-sdk-java-bulkwriter package. To use BulkWriter, import milvus-sdk-java-bulkwriter to your project.

  • Apache Maven
```xml
 <dependency>
     <groupId>io.milvus</groupId>
     <artifactId>milvus-sdk-java-bulkwriter</artifactId>
     <version>2.5.4</version>
 </dependency>
```
  • Gradle/Groovy

    implementation 'io.milvus:milvus-sdk-java-bulkwriter:2.5.4'
  • Gradle/Kotlin

    implementation("io.milvus:milvus-sdk-java-bulkwriter:2.5.4")

Examples

Please refer to examples folder for Java SDK examples.

Documentation

Troubleshooting

  • If you encounter the following error when running your application:

    Exception in thread "main" java.lang.NoClassDefFoundError: org/slf4j/LoggerFactory
    

    This is because SLF4J jar files need to be added into your application's classpath. SLF4J is required by Java SDK for logging purpose.

    To fix this issue, you can use Apache Maven or Gradle to download the required jar files.

    • Apache Maven

       <dependency>
           <groupId>org.slf4j</groupId>
           <artifactId>slf4j-api</artifactId>
           <version>1.7.30</version>
       </dependency>
    • Gradle/Groovy

      compile group: 'org.slf4j', name: 'slf4j-api', version: '1.7.30'
    • Gradle/Kotlin

      implementation("org.slf4j:slf4j-api:1.7.30")