[説明] このページは機械翻訳された日本語版です。内容に誤りがございましたら、報告していただけると助かります。

データベース

Zilliz Cloudは、クラスターとコレクションの間にデータベース層を導入し、マルチテナンシーをサポートしながらデータをより効率的に管理および整理する方法を提供します。

データベースとは

Zilliz Cloudでは、データベースはデータを整理および管理するための論理単位として機能します。データセキュリティを強化しマルチテナンシーを実現するために、複数のデータベースを作成して、異なるアプリケーションまたはテナントのデータを論理的に分離できます。たとえば、ユーザーAのデータを保存するデータベースを作成し、ユーザーB用に別のデータベースを作成できます。

リソースはZilliz Cloudで以下の階層的順序で構成されています。

データベースの概念は専用クラスターでのみ利用可能であることに注意してください。サーバーレスおよび無料クラスターにはデータベースがありません。

前提条件

データベースを管理するには、組織オーナーまたはプロジェクト管理者としてのアクセス権が必要です。

データベースを作成

データベースは専用クラスターでのみ作成できます。クラスターを作成すると、デフォルトデータベースが作成されます。

コンソールで手動またはプログラムで、専用クラスターに最大1,024個のデータベースを作成できます。

コンソールでデータベースを作成

以下の図に示すように、コンソールでデータベースを作成できます。

作成したコレクションをあるデータベースから別のデータベースに移動することもできます。詳細については、コレクションを管理（コンソール）を参照してください。

プログラムでデータベースを作成

Milvus 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"
)

Java

import io.milvus.v2.client.MilvusClientV2;
import io.milvus.v2.client.ConnectConfig;
import io.milvus.v2.service.database.request.*;

ConnectConfig config = ConnectConfig.builder()
        .uri("YOUR_CLUSTER_ENDPOINT")
        .token("YOUR_CLUSTER_TOKEN")
        .build();
MilvusClientV2 client = new MilvusClientV2(config);

CreateDatabaseReq createDatabaseReq = CreateDatabaseReq.builder()
        .databaseName("my_database_1")
        .build();
client.createDatabase(createDatabaseReq);

NodeJS

import {MilvusClient} from '@zilliz/milvus2-sdk-node';
const client = new MilvusClient({ 
    address: "YOUR_CLUSTER_ENDPOINT",
    token: 'YOUR_CLUSTER_TOKEN' 
});

await client.createDatabase({
    db_name: "my_database_1"
 });

Go

cli, err := milvusclient.New(ctx, &milvusclient.ClientConfig{
    Address: "YOUR_CLUSTER_ENDPOINT",
    Username: "Milvus",
    Password: "root",
})
if err != nil {
    // handle err
}

err = cli.CreateDatabase(ctx, milvusclient.NewCreateDatabaseOption("my_database_1"))
if err != nil {
    // handle err
}

cURL

export CLUSTER_ENDPOINT="YOUR_CLUSTER_ENDPOINT"
export TOKEN="YOUR_CLUSTER_TOKEN"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/databases/create" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "dbName": "my_database_1"
}'

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

Python

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

Java

Map<String, String> properties = new HashMap<>();
properties.put("database.replica.number", "3");
CreateDatabaseReq createDatabaseReq = CreateDatabaseReq.builder()
        .databaseName("my_database_2")
        .properties(properties)
        .build();
client.createDatabase(createDatabaseReq);

NodeJS

await client.createDatabase({
    db_name: "my_database_2",
    properties: {
        "database.replica.number": 3
    }
});

Go

err := cli.CreateDatabase(ctx, milvusclient.NewCreateDatabaseOption("my_database_2").WithProperty("database.replica.number", 3))
if err != nil {
    // handle err
}

cURL

export CLUSTER_ENDPOINT="YOUR_CLUSTER_ENDPOINT"
export TOKEN="YOUR_CLUSTER_TOKEN"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/databases/create" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "dbName": "my_database_2",
    "properties": {
        "database.replica.number": 3
    }
}'

データベースを表示

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

Python

# すべての既存データベースを一覧表示
client.list_databases()

# 出力
# ['default', 'my_database_1', 'my_database_2']

# データベースの詳細を確認
client.describe_database(
    db_name="default"
)

# 出力
# {"name": "default"}

Java

import io.milvus.v2.service.database.response.*;

ListDatabasesResp listDatabasesResp = client.listDatabases();

DescribeDatabaseResp descDBResp = client.describeDatabase(DescribeDatabaseReq.builder()
        .databaseName("default")
        .build());

NodeJS

await client.describeDatabase({ 
    db_name: 'default'
});

Go

// すべての既存データベースを一覧表示
databases, err := cli.ListDatabase(ctx, milvusclient.NewListDatabaseOption())
if err != nil {
    // handle err
}
log.Println(databases)

db, err := cli.DescribeDatabase(ctx, milvusclient.NewDescribeDatabaseOption("default"))
if err != nil {
    // handle err
}
log.Println(db)

cURL

export CLUSTER_ENDPOINT="YOUR_CLUSTER_ENDPOINT"
export TOKEN="YOUR_CLUSTER_TOKEN"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/databases/describe" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "dbName": "default"
}'

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

各データベースには独自のプロパティがあり、プログラムでデータベースを作成で説明したようにデータベースを作成するときにプロパティを設定するか、既存の任意のデータベースのプロパティを変更または削除できます。

以下の表は、考えられるデータベースプロパティをリストしています。

プロパティ名	タイプ	プロパティの説明
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
    }
)

Java

client.alterDatabaseProperties(AlterDatabasePropertiesReq.builder()
        .databaseName("my_database_1")
        .property("database.max.collections", "10")
        .build());

NodeJS

await milvusClient.alterDatabaseProperties({
  db_name: "my_database_1",
  properties: {"database.max.collections", "10" },
})

Go

err := cli.AlterDatabaseProperties(ctx, milvusclient.NewAlterDatabasePropertiesOption("my_database_1").
    WithProperty("database.max.collections", 1))
if err != nil {
    // handle err
}

cURL

export CLUSTER_ENDPOINT="YOUR_CLUSTER_ENDPOINT"
export TOKEN="YOUR_CLUSTER_TOKEN"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/databases/alter" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "dbName": "my_database",
    "properties": {
        "database.max.collections": 10
    }
}'

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

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

Python

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

Java

client.dropDatabaseProperties(DropDatabasePropertiesReq.builder()
        .databaseName("my_database_1")
        .propertyKeys(Collections.singletonList("database.max.collections"))
        .build());

NodeJS

await milvusClient.dropDatabaseProperties({
  db_name: my_database_1,
  properties: ["database.max.collections"],
});

Go

err := cli.DropDatabaseProperties(ctx, milvusclient.NewDropDatabasePropertiesOption("my_database_1", "database.max.collections"))
if err != nil {
    // handle err
}

cURL

export CLUSTER_ENDPOINT="YOUR_CLUSTER_ENDPOINT"
export TOKEN="YOUR_CLUSTER_TOKEN"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/databases/alter" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "dbName": "my_database",
    "propertyKeys": [
        "database.max.collections"
    ]
}'

データベースを使用

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

📘注意

RESTful APIはこの操作をサポートしていません。

Python

client.use_database(
    db_name="my_database_2"
)

Java

client.useDatabase("my_database_2");

NodeJS

await milvusClient.useDatabase({
  db_name: "my_database_2",
});

Go

err = cli.UseDatabase(ctx, milvusclient.NewUseDatabaseOption("my_database_2"))
if err != nil {
    // handle err
}

cURL

# この操作はサポートされていません。RESTfulでは永続的な接続を提供しないためです。
# 代替として、ターゲットデータベースを使用して必要なリクエストを再発行してください。

データベースを削除

データベースが不要になったら、データベースを削除できます。注意点：

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

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

コンソールでデータベースを削除

以下の図の手順に従い、コンソールでデータベースを削除できます。

プログラムでデータベースを削除

Milvus RESTful APIまたはSDKを使用して、プログラムでデータを削除できます。

Python

client.drop_database(
    db_name="my_database_2"
)

Java

client.dropDatabase(DropDatabaseReq.builder()
        .databaseName("my_database_2")
        .build());

NodeJS

await milvusClient.dropDatabase({
  db_name: "my_database_2",
});

Go

err = cli.DropDatabase(ctx, milvusclient.NewDropDatabaseOption("my_database_2"))
if err != nil {
    // handle err
}

cURL

export CLUSTER_ENDPOINT="YOUR_CLUSTER_ENDPOINT"
export TOKEN="YOUR_CLUSTER_TOKEN"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/databases/drop" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "dbName": "my_database"
}'