Database for On-Demand Search

Plan availability

This feature is available only with the Enterprise plan or higher.

A database for on-demand search is a project-level database managed by Zilliz Cloud. It is not tied to a serving cluster. Use this page to create, view, and drop databases through a project endpoint.

📘Notes

This page is for project-level databases used by on-demand search. For databases hosted by serving clusters, see Database in Serving Clusters. For a comparison of database models, see Database Explained.

Before you begin

Ensure that:

• You have Project Admin access. For details about the roles and permissions, see Manage Platform Users.

• You have the project endpoint, for example https://{project-id}.{region}.api.zillizcloud.com.

• You have an API key with access to the project.

You can create up to 100 databases for on-demand search in each project.

Supported operations

Operation	Supported
Create/drop database	Yes
Create/drop collection	Yes
Load/release collection	No need
Search/query	Yes
Import	Yes
Insert/upsert/delete	No

All collections, including managed collections and external collections, in an on-demand database do not support dropping indexes.

Create database

This database is a project-level resource shared by on-demand compute in the project.

bash

curl --request POST \
  --url "YOUR_PROJECT_ENDPOINT/v2/vectordb/databases/create" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "dbName": "my_database"
  }'

You can also create a database from the Zilliz Cloud console:

1

Navigate to your project.

2

Click On-demand.

3

Click Databases.

4

Click Create Database.

5

Enter a database name.

6

Click Create.

View databases

bash

curl --request POST \
  --url "YOUR_PROJECT_ENDPOINT/v2/vectordb/databases/list" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{}'

To view databases in the Zilliz Cloud console, navigate to your project, click On-demand, and then click Databases.

Drop database

🚧Danger

Once you drop a database, it is removed immediately and cannot be recovered. This action cannot be undone.

Before dropping a database, drop all collections in the database first.

bash

curl --request POST \
  --url "YOUR_PROJECT_ENDPOINT/v2/vectordb/databases/drop" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "dbName": "my_database"
  }'

To drop a database from the Zilliz Cloud console, navigate to your project, click On-demand, click Databases, and drop the target database.

Next steps

• Database Explained

• Database in Serving Clusters