# Create and Use Databases

Create and select Milvus databases in Node.js, organize collections by database, and configure database properties.

SDK: `@zilliz/milvus2-sdk-node@3.0.10` · Tested with Milvus 3.0.6

Canonical documentation: https://milvus-io.github.io/milvus-sdk-node/operations/database-operations/

## Section links

- [Creating a Database](https://milvus-io.github.io/milvus-sdk-node/operations/database-operations/#creating-a-database)
- [Listing Databases](https://milvus-io.github.io/milvus-sdk-node/operations/database-operations/#listing-databases)
- [Describing a Database](https://milvus-io.github.io/milvus-sdk-node/operations/database-operations/#describing-a-database)
- [Altering Database Properties](https://milvus-io.github.io/milvus-sdk-node/operations/database-operations/#altering-database-properties)
- [Dropping Database Properties](https://milvus-io.github.io/milvus-sdk-node/operations/database-operations/#dropping-database-properties)
- [Dropping a Database](https://milvus-io.github.io/milvus-sdk-node/operations/database-operations/#dropping-a-database)
- [Multi-Database Usage Patterns](https://milvus-io.github.io/milvus-sdk-node/operations/database-operations/#multi-database-usage-patterns)
- [Switching Between Databases](https://milvus-io.github.io/milvus-sdk-node/operations/database-operations/#switching-between-databases)
- [Working with Multiple Databases](https://milvus-io.github.io/milvus-sdk-node/operations/database-operations/#working-with-multiple-databases)
- [Database Isolation](https://milvus-io.github.io/milvus-sdk-node/operations/database-operations/#database-isolation)
- [Best Practices](https://milvus-io.github.io/milvus-sdk-node/operations/database-operations/#best-practices)
- [Next Steps](https://milvus-io.github.io/milvus-sdk-node/operations/database-operations/#next-steps)

Milvus supports multiple databases, allowing you to organize collections into logical groups. This guide covers all database operations.

## Creating a Database

Create a new database:

```javascript
await client.createDatabase({
  db_name: 'my_database',
});
```

Create a database with properties:

```javascript
await client.createDatabase({
  db_name: 'my_database',
  properties: {
    owner: 'analytics-team',
    environment: 'production',
  },
});
```

## Listing Databases

List all databases:

```javascript
const result = await client.listDatabases();

console.log('Databases:', result.db_names);
// Output: ['default', 'my_database']
```

## Describing a Database

Get detailed information about a database:

```javascript
const result = await client.describeDatabase({
  db_name: 'my_database',
});

console.log('Database info:', result);
```

## Altering Database Properties

Modify database properties:

```javascript
await client.alterDatabaseProperties({
  db_name: 'my_database',
  properties: {
    owner: 'search-team',
    environment: 'staging',
  },
});
```

## Dropping Database Properties

Remove specific properties from a database:

```javascript
await client.dropDatabaseProperties({
  db_name: 'my_database',
  properties: ['environment'],
});
```

## Dropping a Database

Delete a database (all collections in the database will be deleted):

```javascript
await client.dropDatabase({
  db_name: 'my_database',
});
```

## Multi-Database Usage Patterns

### Switching Between Databases

When creating a client, specify the database:

```javascript
const client = new MilvusClient({
  address: 'localhost:19530',
  database: 'my_database', // Set default database
});
```

### Working with Multiple Databases

Create separate clients for different databases:

```javascript
await client.createDatabase({ db_name: 'database1' });
await client.createDatabase({ db_name: 'database2' });

const db1Client = new MilvusClient({
  address: 'localhost:19530',
  database: 'database1',
});

const db2Client = new MilvusClient({
  address: 'localhost:19530',
  database: 'database2',
});

console.log('database1:', (await db1Client.listCollections()).data);
console.log('database2:', (await db2Client.listCollections()).data);
await db1Client.closeConnection();
await db2Client.closeConnection();
```

### Database Isolation

Each database is isolated:

- Collections in different databases are completely separate
- Operations on one database don’t affect others
- Users and roles can have different permissions per database

## Best Practices

1. **Use databases for logical separation**: Organize collections by application, environment, or team
2. **Default database**: The `default` database is created automatically
3. **Database naming**: Use descriptive names that reflect the purpose
4. **Permissions**: Configure user permissions at the database level for security

## Next Steps

- Learn about [Collection Management](https://milvus-io.github.io/milvus-sdk-node/management/collection-management/)
- Explore [User & Role Management](https://milvus-io.github.io/milvus-sdk-node/management/user-role-management/)
