接続エンドポイント
Zilliz Cloud は、それぞれ異なる責務を持つ 3 つのエンドポイントを公開しています。
コントロールプレーン API エンドポイント | プロジェクトエンドポイント（オンデマンド） | リアルタイムサーブエンドポイント | |
|---|---|---|---|
URL パターン |
|
|
|
責務 | リソースライフサイクル：クラスター、ボリューム、ジョブ、およびその他すべてのコントロールプレーンアクティビティ | データインポート、バッチ検索 | フルコレクション API（DDL + DML + DQL） |
データ運用 | なし（データインポートを除く） | バルクインサートとインポート；CU 単位で課金される検索 | 低レイテンシーの検索およびクエリを伴う挿入、アップサート、削除 |
使用するタイミング | インフラストラクチャのプロビジョニングと自動化 | バッチ処理、探索、検証、実験 | 本番サーブ、常時低レイテンシークエリ |
リアルタイムサーブクラスターへの接続
Zilliz Cloud は、Free、Serverless、Dedicated の 3 種類のサーブクラスターを提供しています。以下の例に従って接続を設定する必要があります。
from pymilvus import MilvusClient
# connect to a dedicated cluster
client = MilvusClient(
uri="https://{cluster-id}.{region}.vectordb.zillizcloud.com:19530",
token="YOUR_API_KEY"
)
# connect to a free / serverless cluster
client = MilvusClient(
uri="https://{cluster-id}.serverless.{region}.vectordb.zillizcloud.com",
token="YOUR_API_KEY"
)
有効な API キー（適切な権限を持つもの）または username:password 形式のクラスター認証情報を、認証トークンとして使用できます。
オンデマンドクラスターへの接続
Zilliz Cloud はセッションオブジェクトを提供しており、これを使用してオンデマンドクラスターをデータベースにアタッチし、そのデータベースで検索を実行できます。
from pymilvus import MilvusClient
client = MilvusClient(
uri="https://{project-id}.{region}.api.zillizcloud.com",
cluster="inxx-xxxxxxxxxxxxxxx",
token="YOUR_API_KEY"
)
session = client.session(cluster_id="inxx-xxxxxxxxxxxxxx")
# Then, use session to conduct DQL operations, such as query, get, search, and hybrid_search.
オンデマンドコンピュートエンドポイントに接続する際は、オンデマンドクラスターのクラスターIDも設定する必要があります。これにより、そのクラスター内のコンピュートリソースを使用して検索やクエリを実行できます。
プロジェクトエンドポイントに接続する際は、十分な権限を持つ有効なAPIキーを認証トークンとして使用する必要があります。
Zilliz Cloud コントロールプレーン API エンドポイントへの接続
クラスターやボリュームの作成、またはバックアップ、リストア、マイグレーションなどのコントロールプレーンリソースの管理が必要な場合は、プラットフォームエンドポイントを使用します。
たとえば、利用可能なクラウドプロバイダーを次のように一覧表示できます。
export BASE_URL="https://api.cloud.zilliz.com"
export TOKEN="YOUR_API_KEY"
curl --request GET \
--url "${BASE_URL}/v2/clouds" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json"
詳細については、RESTful API リファレンス を参照してください。