メインコンテンツまでスキップ

Serving クラスターのデータベース

Serving クラスターのデータベースは、Dedicated Serving クラスターでホストされるコレクションの論理コンテナです。このページでは、Serving クラスターのエンドポイントを通じて、データベースの作成、表示、設定、使用、削除を行います。

📘Notes

この機能は、Enterprise プラン以上でのみ利用できます。

📘Notes

このページは、Serving クラスターのデータベースを対象としています。オンデマンドコンピューティングでクエリされるプロジェクトレベルのデータベースについては、オンデマンド検索用のデータベース を参照してください。データベースモデルの比較については、データベースの解説 を参照してください。

事前準備​

以下を満たしていることを確認してください。

  • Dedicated Serving クラスターを作成済みであること。

  • Serving クラスターのエンドポイント(例: https://{cluster-id}.{region}.vectordb.zillizcloud.com:19530)があること。

  • 認証トークンがあること。これは、ターゲットクラスターへのアクセス権を持つ API キー、または username:password 形式のクラスター認証情報です。

  • データベースを管理するための Organization Owner または Project Admin アクセス権があること。

Dedicated クラスターが作成されると、デフォルトのデータベースが自動的に作成されます。Dedicated クラスター内には最大 1,024 個のデータベースを作成できます。

データベースを作成する​

Zilliz Cloud RESTful API または SDK を使用すると、データベースをプログラムで作成できます。

python
from pymilvus import MilvusClient

client = MilvusClient(
uri="YOUR_CLUSTER_ENDPOINT",
token="YOUR_CLUSTER_TOKEN"
)

client.create_database(
db_name="my_database_1"
)

データベースの作成時にプロパティを設定することもできます。次の例では、データベースのレプリカ数を設定します。

python
client.create_database(
db_name="my_database_2",
properties={
"database.replica.number": 3
}
)

データベースを表示する​

Zilliz Cloud RESTful API または SDK を使用すると、既存のすべてのデータベースを一覧表示し、その詳細を確認できます。

python
# List all existing databases
client.list_databases()

# Output
# ['default', 'my_database_1', 'my_database_2']

# Check database details
client.describe_database(
db_name="default"
)

# Output
# {"name": "default"}

データベースプロパティを管理する​

Each データベース has its own properties, you can set the properties of a データベース when you create the データベース as described in Create データベース or you can alter and drop the properties of any existing database.

Serving クラスターのデータベースでは、以下のデータベースプロパティを設定できます。

プロパティ説明
database.replica.numberデータベースのレプリカ数です。
database.max.collectionsデータベースで許可されるコレクションの最大数です。
database.force.deny.writingデータベースの書き込み操作を拒否するかどうかです。
database.force.deny.readingデータベースの読み取り操作を拒否するかどうかです。

データベースプロパティを変更する​

既存のデータベースのプロパティは、次のように変更できます。次の例では、データベース内に作成できるコレクション数を制限します。

python
client.alter_database_properties(
db_name="my_database_1",
properties={
"database.max.collections": 10
}
)

データベースプロパティを削除する​

また、次のようにプロパティを削除して、データベースプロパティをリセットすることもできます。次の例では、データベース内に作成できるコレクション数の制限を解除します。

python
client.drop_database_properties(
db_name="my_database_1",
property_keys=[
"database.max.collections"
]
)

データベースを使用する​

Zilliz Cloud から切断せずに、あるデータベースから別のデータベースに切り替えることができます。

📘Notes

RESTful API は、永続接続でのデータベースの切り替えをサポートしていません。RESTful API リクエストでは、操作が dbName をサポートしている場合、各リクエスト本文でターゲットデータベースを指定します。

python
client.use_database(
db_name="my_database_2"
)

データベースを削除する​

データベースが不要になったら、データベースを削除できます。次の点に注意してください。

  • デフォルトのデータベースは削除できません。

  • データベースを削除する前に、データベース内のすべてのコレクションを先に削除する必要があります。

Zilliz Cloud RESTful API または SDK を使用すると、データベースをプログラムで削除できます。

python
client.drop_database(
db_name="my_database_2"
)

よくある質問​

データベースの権限はどのように管理しますか?​

Zilliz Cloud では、ロールベースアクセス制御(RBAC)を使用して権限を管理します。特定の権限を持つロールを作成してユーザーに割り当てることで、さまざまなデータベースへのアクセスを制御できます。詳細は、RBAC ドキュメント を参照してください。

データベースにクォータ制限はありますか?​

はい。Zilliz Cloud では、コレクションの最大数など、データベースにクォータ制限を設定できます。制限の包括的な一覧については、Zilliz Cloud の制限事項ドキュメント を参照してください。

次のステップ​