SDK のインストール

Zilliz Cloud は、マネージド Milvus ベクトルデータベースをサービスとして提供しています。クラスター接続を容易にする 6 つの SDK オプションとして、Python、Java、Go、Node.js、C++、Rust があります。

Notes

• Zilliz Cloud は、バージョンの互換性を確保するためにクラスターを継続的にアップグレードします。詳細については、Manage Organization Settings ページを参照してください。SDK のバージョンの不一致によって接続の問題が発生した場合は、表示されるプロンプトに従って互換性のある SDK バージョンに戻してください。メンテナンスが完了したらお知らせしますので、その後は問題なく SDK をアップグレードできます。

• 以下のすべての SDK には、安定版とベータ版の両方が用意されています。安定版は通常のクラスター向けで、ベータ版はベータクラスターに対応します。クラスターをベータ版にアップグレードした場合は、SDK もベータ版にアップグレードしてください。

SDK の互換性

次の表に、各 Milvus バージョンに対応する SDK バージョンを示します。

Milvus バージョン	Python SDK	Node.js SDK	Java SDK	Go SDK	C++	Rust SDK
3.0.x	3.0.3	3.0.6	3.0.12	3.0.0	3.0.4	3.0.3
2.6.x	2.6.17	2.6.17	2.6.24	2.6.5	2.6.6	2.6.1
2.5.x	2.5.18	2.5.13	2.5.15	2.5.6	--	--

PyMilvus のインストール：Python SDK

PyMilvus は Milvus の Python SDK です。GitHub のソースコード にアクセスしてください。

Notes

インストールする前に、Python のバージョンが 3.8 を超えていることを確認してください。

bash

# Install or update PyMilvus to the latest v3.0.x
pip install --upgrade pymilvus==3.0.3

# Install the Model library for embedding operations (optional)
pip install pymilvus[model]

# Verify the installed version
python -c "from pymilvus import __version__; print(__version__)"

Node.js SDK のインストール

Milvus の Node.js SDK では、npm または yarn を使用します。GitHub のソースコード にアクセスしてください。

Notes

インストールする前に、Node.js のバージョンが 18 以上であることを確認してください。

bash

npm install @zilliz/milvus2-sdk-node
# Alternatively,
yarn add @zilliz/milvus2-sdk-node

# Upgrade to the latest version
npm update @zilliz/milvus2-sdk-node
# Alternatively,
yarn upgrade @zilliz/milvus2-sdk-node

# Verify installation
npm list | grep @zilliz/milvus2-sdk-node
# or
yarn list | grep @zilliz/milvus2-sdk-node

この SDK は、CommonJS モジュールまたは ES6 モジュールとして使用できます。通常、npm init プロジェクトでは CommonJS を使用します。npm init es6 プロジェクトでは ES6 が推奨されます。

javascript

// Import the SDK as a CommonJS module
const { MilvusClient } = require("@zilliz/milvus2-sdk-node")

// Import the SDK as an ES6 module
import { MilvusClient } from "@zilliz/milvus2-sdk-node"

Java SDK のインストール

SDK を取得するには、Apache Maven または Gradle/Grails を使用します。GitHub のソースコード にアクセスしてください。

• Apache Maven の場合は、pom.xml の依存関係に以下を追加します。

  xml

  <!-- Install the Java SDK compatible with Milvus v3.0.x -->
  <dependency>
      <groupId>io.milvus</groupId>
      <artifactId>milvus-sdk-java</artifactId>
      <version>3.0.12</version>
  </dependency>
  <!-- Optional: to use BulkWriter, also add -->
  <dependency>
      <groupId>io.milvus</groupId>
      <artifactId>milvus-sdk-java-bulkwriter</artifactId>
      <version>3.0.12</version>
  </dependency>

• Gradle/Grails, の場合は、次を実行します。

  bash

  # Install the Java SDK compatible with Milvus v3.0.x
  implementation 'io.milvus:milvus-sdk-java:3.0.12'
  # Optional: to use BulkWriter, also add
  implementation 'io.milvus:milvus-sdk-java-bulkwriter:3.0.12' 

Go SDK のインストール

Go SDK は go get で入手できます。GitHub のソースコード を参照してください。

bash

# Install the Go SDK compatible with Milvus v3.0.x
go get -u github.com/milvus-io/milvus/client/v3

C++ SDK のインストール

C++ SDK は次の方法で入手できます。GitHub のソースコード を参照してください。

shell

# Install the C++ SDK (Milvus 3.0.x, release v3.0.4) from source
git clone https://github.com/milvus-io/milvus-sdk-cpp.git
cd milvus-sdk-cpp
git checkout v3.0.4
bash scripts/install_deps.sh
make

# install the sdk
make install       # install to /usr/local

shell

# Install the C++ SDK (Milvus 3.0.x, release v3.0.4) with Conan
conan install . --build=missing -s build_type=Release
cmake --preset conan-release
cmake --build build/Release

shell

# Alternative: consume the published C++ SDK package via Conan
# Add the Milvus Conan remote first (one-time)
conan remote add milvus-artifactor \
  https://milvus01.jfrog.io/artifactory/api/conan/default-conan-local2 \
  --force --allowed-packages "milvus-sdk-cpp/*"
conan install --requires="milvus-sdk-cpp/3.0.4@milvus/dev" --build=never

または、GitHub のリリースページ から、お使いのプラットフォーム向けにビルド済みのバイナリパッケージをダウンロードできます（アセット名は libmilvus-3.0.4-<arch>-<OS>.deb、.rpm、.tar.gz）。

Rust SDK のインストール

Milvus の Rust SDK では、Cargo を使用します。ソースコードは GitHub で参照できます。

shell

# Add the Rust SDK to your Cargo.toml
[dependencies]
milvus-sdk-rust = "3.0.3"

C# SDK のインストール

bash

# Install the C# SDK compatible with Milvus v3.0.x
dotnet add package Milvus.Client.V2