alterAlias()
この操作は、ある collection の alias を別の collection に再割り当てします。
public void alterAlias(AlterAliasReq request)
リクエスト構文
alterAlias(AlterAliasReq.builder()
.alias(String alias)
.databaseName(String databaseName)
.collectionName(String collectionName)
.build()
)
BUILDER メソッド:
-
alias(String alias)collection の alias です。なお、この alias は事前に存在している必要があります。
📘注collection alias とは何ですか?
collection alias は、collection の追加名です。Collection alias は、コードを変更することなくアプリケーションを新しい collection に切り替えたい場合に便利です。
Zilliz Cloud では、collection alias はグローバルに一意な識別子です。1 つの alias は、厳密に 1 つの collection にのみ割り当てられます。逆に、1 つの collection は複数の alias を持つことができます。
以下は、ある collection の alias を別の collection に再割り当てする例です。
collection_1とcollection_2の 2 つの collection があるとします。また、bobという名前の collection alias があり、これは元々collection_1に割り当てられていました。-
collection_1の alias = ["bob"] -
collection_2の alias = []
collection_2とbobをパラメータとしてalterAlias関数を呼び出した後:-
collection_1の alias = [] -
collection_2の alias = ["bob"]
-
-
databaseName(String databaseName)対象の collection が属するデータベースの名前です。
-
collectionName(String collectionName)alias を再割り当てする対象 collection の名前です。
戻り値:
void
例外:
-
MilvusClientExceptions
この操作中に何らかのエラーが発生した場合、この例外が送出されます。
例
import io.milvus.v2.client.ConnectConfig;
import io.milvus.v2.client.MilvusClientV2;
import io.milvus.v2.service.utility.request.AlterAliasReq;
// 1. Set up a client
ConnectConfig connectConfig = ConnectConfig.builder()
.uri("YOUR_CLUSTER_ENDPOINT")
.token("YOUR_CLUSTER_TOKEN")
.build();
MilvusClientV2 client = new MilvusClientV2(connectConfig);
// 2. Alter the alias for collection "test"
AlterAliasReq alterAliasReq = AlterAliasReq.builder()
.collectionName("test")
.alias("test_alias2")
.build();
client.alterAlias(alterAliasReq);