メインコンテンツまでスキップ
バージョン: User Guides (BYOC)

SDKのインストール

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

📘Notes

  • Zilliz Cloudは常にクラスターをアップグレードし、バージョン互換性を確保しています。詳細については、組織設定の管理ページをご覧ください。SDKのバージョン不一致により接続に問題が発生した場合は、表示されるプロンプトに従って互換性のあるSDKバージョンに戻してください。メンテナンス完了後には通知が届きますので、その後は安心してSDKをアップグレードできます。

  • 以下のすべてのSDKには、安定版（stable version）とベータ版（beta version）の両方が提供されています。安定版は通常のクラスター向けであり、ベータ版はベータクラスターに対応しています。クラスターをベータ版にアップグレードした場合は、SDKも必ずベータ版にアップグレードしてください。

SDKの互換性​

次の表は、各Milvusバージョンに対応するSDKバージョンの一覧です。

Milvus Version

Python SDK

Node.js SDK

Java SDK

Go SDK

2.6.x

2.6.9

2.6.10

2.6.14

2.6.2

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を超えていることをインストール前にご確認ください。

# Install pymilvus compatible with Milvus v2.5.x
python -m pip install pymilvus==2.5.18

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

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

クラスターが Milvus v2.6.x (パブリックプレビュー) と互換性がある場合は、上記のコマンド内の 2.5.18 を 2.6.9 に変更してください。

Install Node.js SDK​

Milvus の Node.js SDK は、npm または yarn を使用してインストールします。GitHub 上のソースコードをご確認ください。

📘Notes

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

# Install Node.js SDK compatible with Milvus v2.5.x
npm install @zilliz/milvus2-sdk-node@2.5.13
# Alternatively,
yarn add @zilliz/milvus2-sdk-node@2.5.13

# 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 を使用することを推奨します。

// 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"

クラスターが Milvus v2.6.x (パブリックプレビュー) と互換性がある場合は、上記のコマンド内の 2.5.13 を 2.6.10 に変更してください。

Install Java SDK​

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

  • Apache Maven の場合、pom.xml の dependencies に以下を追加します:

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

  • Gradle/Grails の場合、次を実行します:

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

クラスターが Milvus v2.6.x (パブリックプレビュー) と互換性がある場合は、上記のコマンド内の 2.5.15 を 2.6.14 に変更してください。

Install Go SDK​

Go SDK は go get で利用可能です。GitHub 上のソースコードをご確認ください。

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

クラスターが Milvus v2.6.x (パブリックプレビュー) と互換性がある場合は、上記のコマンド内の 2.5.6 を 2.6.1 に変更してください。