Milvus サービスへの接続
以下のいずれかのコマンドを実行し、 Milvusと接続する:
開始前に
次の項目がインストールされている、または利用可能であることを確認してください。
- Pythonおよび Pymilvus パッケージ。 詳細については、についてPyMilvus。
- Milvus インスタンスのホスト名とポート。 Infrastructure manager から Milvusの
host
、port
。( Milvus サービスをクリックして Details ページを開き、GRPCホストからのhost
、port
。) - ユーザーに役割を割り当てるか、サービスID からインフラストラクチャマネージャー。 ユーザーのロールについては、ロールと権限の管理を参照してください。
手順
APIキーまたはIAMトークンを使用して Milvus サービスに接続することができます。
-
watsonx.dataで Milvus サービスを提供する。 詳細については、 Milvus サービスの追加 を参照してください。
-
Python SDK PyMilvus )を用いて、以下のいずれかのコマンドを実行し、 Milvusと gRPC ルート接続する:
-
GRPCコールを使用して Milvus に接続するには、以下のコマンドのいずれかを使用します
print(fmt.format("start connecting to Milvus")) connections.connect(host="<host>", port="<port>", secure=True, user="ibmlhapikey", password="<api-key>") has = utility.has_collection("hello_milvus") print(f"Does collection hello_milvus exist in Milvus: {has}")
または
from pymilvus import MilvusClient, DataType client = MilvusClient( host=<host>, port=<port>, secure=True, user="ibmlhapikey", password="<api-key>" )
<api-key>
をIBMAPI キーに置き換える。 APIキーの取得については、IBMAPIキーの取得 を参照してください。 -
IAMトークンを使用して Milvus に接続するには、以下のコマンドのいずれかを使用します
connections.connect(host="<host>", port="<port>", secure=True, user="ibmlhtoken", password="<token>")
または
from pymilvus import MilvusClient, DataType milvus_uri = "https://<ibmlhtoken>:<token>@<host>:<port>" client = MilvusClient( uri=milvus_uri, secure=True )
<token>
を IAM トークンに置き換える。 トークンの取得については、IBMAccess Management(IAM)トークンの取得 を参照してください。 -
Uniform Resource Identifier (URI) を使用して Milvus に接続するには、以下のコマンドのいずれかを使用します
print(fmt.format("start connecting to Milvus")) connections.connect( alias="default", uri="https://<host>:<grpc-port>", user = "ibmlhtoken", password = "<token>" ) has = utility.has_collection("hello_milvus") print(f"Does collection hello_milvus exist in Milvus: {has}")
または
from pymilvus import MilvusClient, DataType milvus_uri = "https://<ibmlhapikey>:<api-key>@<host>:<port>" client = MilvusClient( uri=milvus_uri, secure=True )
<token>
を IAM トークンに置き換える。 トークンの取得については、IBMAccess Management(IAM)トークンの取得 を参照してください。
-
-
Milvus REST ルートを使用して REST API を呼び出すには 、RESTful API リファレンス を参照してください。
例えば、すべてのコレクションをリストアップするには、次のコマンドを使用します
curl --request GET \ --url "https://<REST-host>:<REST-port>/v1/vector/collections" \ --header "Authorization: Basic $(echo -n '<user>:<password>' | base64)" \ --header "Content-Type: application/json"
次のタスク
Milvus サービスとの接続確立後、以下の操作を行うことができます:
-
データの管理
- Milvus サービスでは、データの挿入、アップサート、削除が可能です。 詳しくは、挿入、アップサート、削除 を参照。
- Milvusからデータをインポートすることができます。 詳細については、データの準備とインポート を参照してください
-
データベースの管理 Milvusでデータベースを作成し、特定のユーザに管理権限を割り当てることができます。 Milvus クラスタは最大64個のデータベースをサポートします。 詳細については、データベースの管理。
-
コレクションの管理お好みのSDKを使用して、コレクションを作成および管理できます。 Milvus クラスタは最大65,536コレクションをサポートします。 詳細については、コレクションの管理。
-
パーティションの管理コレクションにパーティションを作成し、管理することができます。 Milvus クラスタは最大4095パーティションをサポートします。 詳細については、パーティションの管理。
-
インデックスの管理コレクション内のベクトルフィールドにインデックスを作成および管理できます。 詳細については、「インデックスの管理」を参照してください。
-
検索とクエリ Milvusにおけるデータの検索とクエリについては、 検索、クエリ、取得 を参照してください。
関連API
関連APIについては、こちらをご覧ください