Drop a keyspace (Java)

Drops a keyspace from a database and deletes all data in that keyspace.

Result

Drops the specified keyspace.

Does not return anything.

Parameters

Use the dropKeyspace method, which belongs to the com.datastax.astra.client.admin.DatabaseAdmin class.

Method signature
void dropKeyspace(String keyspace)
void dropKeyspace(
  String keyspace,
  DropKeyspaceOptions options
)
Name Type Summary

keyspace

String

The name of the keyspace to drop.

options

DropKeyspaceOptions

Optional. The options for this operation. See Methods of DropKeyspaceOptions for more details.

Methods of DropKeyspaceOptions
Method Parameters Summary

ifExists()

boolean

Optional. Whether the command should silently succeed even if a keyspace with the given name does not exist.

Default: true

Examples

The following examples demonstrate how to drop a keyspace.

import com.datastax.astra.client.DataAPIClient;
import com.datastax.astra.client.DataAPIClients;
import com.datastax.astra.client.admin.DatabaseAdmin;
import com.datastax.astra.client.databases.Database;

public class Example {

  public static void main(String[] args) {
    // Get a database
    DataAPIClient client = DataAPIClients.clientHCD("USERNAME", "PASSWORD");
    Database database = client.getDatabase("API_ENDPOINT", "KEYSPACE_NAME");

    // Get an admin object
    DatabaseAdmin admin = database.getDatabaseAdmin();

    // Drop a keyspace
    admin.dropKeyspace("KEYSPACE_NAME");
  }
}

Client reference

For more information, see the client reference.

Was this helpful?

Give Feedback

How can we improve the documentation?

© Copyright IBM Corporation 2026 | Privacy policy | Terms of use Manage Privacy Choices

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries. Kubernetes is the registered trademark of the Linux Foundation.

General Inquiries: Contact IBM