Drop a database (C#)
|
Terminating a database permanently deletes all of its data, including automatic backups. You cannot undo this action. |
Deletes a database and erases all data stored in it.
|
You need an application token with permission to create and configure databases, such as the Organization Administrator role. For more information, see Get endpoint and token. |
Result
Deletes the specified database and erases all data stored in the database.
Does not return anything.
Parameters
Use the DropDatabaseAsync method, which belongs to the AstraDatabasesAdmin class.
You can also use DropDatabase, which is the synchronous version of the method.
Method signature
public Task DropDatabaseAsync(
string dbGuid, DropDatabaseOptions options = null
);| Name | Type | Summary |
|---|---|---|
|
|
The ID of the database to delete. |
|
Optional.
Options for this operation.
For more information and examples for general options such as timeout, see Customize API interaction.
For options specific to this method, see Method-specific properties of the |
| Name | Type | Summary |
|---|---|---|
|
|
Optional. Whether to wait for the database to be fully deleted before returning. If false, the method returns immediately after issuing the deletion request. Default: true |
Examples
The following examples demonstrate how to drop a database.
using DataStax.AstraDB.DataApi;
namespace Examples;
public class Program
{
static async Task Main()
{
var client = new DataAPIClient("APPLICATION_TOKEN");
var admin = client.GetAstraDatabasesAdmin();
await admin.DropDatabaseAsync("DATABASE_ID");
}
}Client reference
For more information, see the client reference.
