メインコンテンツまでスキップ

SDK のインストール

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

📘📘 Notes

  • Zilliz Cloud は、バージョン互換性を確保するためにクラスターを継続的にアップグレードしています。詳細については、Manage Organization Settings ページを参照してください。SDK バージョンの相違により接続の問題が発生した場合は、互換性のある SDK バージョンに戻すための案内に従ってください。メンテナンス後に通知しますので、その後は安心して SDK をアップグレードできます。

  • 以下に示すすべての SDK には、安定版とベータ版の両方が提供されています。安定版は一般的なクラスターを対象とし、ベータ版はベータクラスターに対応します。クラスターをベータ版にアップグレードした場合は、SDK もベータ版にアップグレードしていることを確認してください。

SDK の互換性​

次の表は、各 Milvus バージョンで互換性のある SDK バージョンを示しています。

Milvus バージョンPython SDKNode.js SDKJava SDKGo SDKC++
3.0.x3.0.13.0.53.0.83.0.0-beta3.0.2
2.6.x2.6.172.6.172.6.242.6.52.6.6
2.5.x2.5.182.5.132.5.152.5.6--

PyMilvus のインストール: Python SDK​

PyMilvus は Milvus の Python SDK です。GitHub のソースコードにアクセスできます。

📘📘 Notes

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

bash
# Install pymilvus
python -m pip install pymilvus

# Update PyMilvus to the newest version
python -m pip install --upgrade pymilvus

# Verify installation success
python -m pip list | grep pymilvus

Node.js SDK のインストール​

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

📘📘 Notes

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

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 a ES6 module
import { MilvusClient } from "@zilliz/milvus2-sdk-node"

Java SDK のインストール​

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

  • Apache Maven の場合は、これを pom.xml の dependencies に追加します：

    xml
    <!-- Install Java SDK compatible with Milvus v2.5.x -->
    <dependency>
         <groupId>io.milvus</groupId>
         <artifactId>milvus-sdk-java</artifactId>
         <version>2.6.24</version>
     </dependency>

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

    bash
    # Install Java SDK compatible with Milvus v2.5.x
    compile 'io.milvus:milvus-sdk-java:2.6.24'

クラスターが Milvus v3.0.x (Public Preview) と互換性がある場合は、上記のコマンド内の 2.6.24 を 3.0.8 に変更してください。

Go SDK のインストール​

Go SDK は go get で利用できます。GitHub のソースコードを確認してください。

bash
# Install Go SDK compatible with Milvus v2.5.x
go get -u github.com/milvus-io/milvus-sdk-go/v2@v2.6.5

クラスターが Milvus v3.0.x (Public Preview) と互換性がある場合は、上記のコマンド内の 2.6.5 を 3.0.0-beta に変更してください。

C++ SDK のインストール​

C++ SDK は次のように入手できます。GitHub のソースコードを確認してください。

shell
git clone https://github.com/milvus-io/milvus-sdk-cpp.git
cd milvus-sdk-cpp
bash scripts/install_deps.sh
make

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

クラスターが Milvus v3.0.x (Public Preview) と互換性がある場合は、3.0.2 リリースを使用してください。

Ctrl I