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

データベース

Contact Sales to Enable BYOC

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

データベースとは

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

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

事前準備

データベースを管理するには、Organization OwnerまたはProject Admin権限が必要です。

データベースの作成

データベースはDedicatedクラスターでのみ作成できます。クラスター作成時にデフォルトデータベースが作成されます。

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

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

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

作成したコレクションを1つのデータベースから別のデータベースに移動することもできます。詳細については、Manage Collections (Console)を参照してください。

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

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から切断することなく、1つのデータベースから別のデータベースに切り替えることができます。

📘Notes

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"
}'