ConnectConfig
MilvusClientV2 インスタンスの作成時に使用される接続設定は、ConnectConfig builder に保持されます。builder パターンを使用して、認証、TLS、タイムアウト、keepalive 設定を含むすべての接続パラメータを構成します。
ConnectConfig.builder()
.uri(String uri)
.token(String token)
.username(String username)
.password(String password)
.dbName(String dbName)
.connectTimeoutMs(long connectTimeoutMs)
.keepAliveTimeMs(long keepAliveTimeMs)
.keepAliveTimeoutMs(long keepAliveTimeoutMs)
.keepAliveWithoutCalls(boolean keepAliveWithoutCalls)
.rpcDeadlineMs(long rpcDeadlineMs)
.secure(Boolean secure)
.enablePrecheck(boolean enablePrecheck)
.idleTimeoutMs(long idleTimeoutMs)
.clientKeyPath(String clientKeyPath)
.clientPemPath(String clientPemPath)
.caPemPath(String caPemPath)
.serverPemPath(String serverPemPath)
.serverName(String serverName)
.proxyAddress(String proxyAddress)
.option(Map<String, String> option)
.build()
BUILDER メソッド:
-
uri(String uri)-[必須]
サーバーエンドポイント URI です。ローカルの Milvus インスタンスには
http://host:portを、Zilliz Cloud には HTTPS URL を受け付けます。 -
token(String token)-認証用の API key または
"username:password"文字列です。Zilliz Cloud の API key に使用するか、username/password 認証の省略記法として使用します。デフォルト:null。 -
username(String username)-認証用の username です。
password()と一緒に使用します。token()が設定されている場合は無視されます。デフォルト:null。 -
password(String password)-認証用の password です。
username()と一緒に使用します。デフォルト:null。 -
dbName(String dbName)-接続後に使用するデフォルトのデータベース名です。デフォルト:
null(サーバーのデフォルトを使用)。 -
connectTimeoutMs(long connectTimeoutMs)-接続中に gRPC channel が READY 状態になるまで待機するタイムアウト時間(ミリ秒)です。デフォルト:
10000。 -
keepAliveTimeMs(long keepAliveTimeMs)-サーバーに送信される keepalive ping の間隔(ミリ秒)です。デフォルト:
10000。 -
keepAliveTimeoutMs(long keepAliveTimeoutMs)-keepalive ping の応答確認を待機してから接続を閉じるまでのタイムアウト時間(ミリ秒)です。デフォルト:
5000。 -
keepAliveWithoutCalls(boolean keepAliveWithoutCalls)-trueの場合、アクティブな RPC がないときでも keepalive ping が送信されます。デフォルト:true。 -
rpcDeadlineMs(long rpcDeadlineMs)-1 回の RPC 呼び出しに許可される最大時間(ミリ秒)です。値が
0の場合、deadline は無効になります。デフォルト:0。 -
secure(Boolean secure)-TLS 暗号化を有効にします。URI が
httpsで始まる場合、この設定に関係なく TLS は常に有効になります。デフォルト:false。 -
enablePrecheck(boolean enablePrecheck)-trueの場合、client を返す前に接続性チェックを実行します。デフォルト:false。 -
idleTimeoutMs(long idleTimeoutMs)-アイドル状態の接続が閉じられるまでの時間(ミリ秒)です。デフォルト:
86400000(24 時間)。 -
clientKeyPath(String clientKeyPath)-相互 TLS(mTLS)用の client 秘密鍵ファイルへのパスです。デフォルト:
null。 -
clientPemPath(String clientPemPath)-相互 TLS(mTLS)用の client 証明書ファイルへのパスです。デフォルト:
null。 -
caPemPath(String caPemPath)-TLS 検証用の CA 証明書ファイルへのパスです。デフォルト:
null。 -
serverPemPath(String serverPemPath)-一方向 TLS 用のサーバー証明書ファイルへのパスです。デフォルト:
null。 -
serverName(String serverName)-TLS 証明書検証用のサーバー名オーバーライドです。デフォルト:
null。 -
proxyAddress(String proxyAddress)-gRPC 接続用の HTTP proxy アドレスです。デフォルト:
null。 -
option(Map<String, String> option)-接続時に
ClientInfo.reservedフィールド内でサーバーに転送される任意のキーと値のペアです。クライアント側メタデータや、サーバーが理解できる feature flag を渡すのに役立ちます。デフォルト値は空の map です。
Example
import io.milvus.v2.client.ConnectConfig;
import io.milvus.v2.client.MilvusClientV2;
// ローカルの Milvus インスタンスに接続
ConnectConfig config = ConnectConfig.builder()
.uri("YOUR_CLUSTER_ENDPOINT")
.build();
// API key を使用して Zilliz Cloud に接続
// ConnectConfig config = ConnectConfig.builder()
// .uri("https://your-instance.zilliz.com")
// .token("your-api-key")
// .build();
MilvusClientV2 client = new MilvusClientV2(config);