Drop a collection (TypeScript)
Deletes a collection from a database and erases all data stored in the collection.
|
Ready to write code? See the examples for this method to get started. If you are new to the Data API, check out the quickstart. |
Result
Deletes the specified collection from the database and erases all data stored in the collection.
Returns a promise that resolves once the operation completes.
Parameters
Use the dropCollection method, which belongs to the Db class.
Method signature
async dropCollection(
name: string,
options?: {
keyspace?: string,
timeout?: number | TimeoutDescriptor,
}
): void| Name | Type | Summary |
|---|---|---|
|
|
The name of the collection to drop. |
|
Optional.
The options for this operation. See Properties of |
| Name | Type | Summary |
|---|---|---|
|
Optional if you specified a working keyspace when you created the Default: The working keyspace set when you created the |
|
|
|
Optional. The timeout(s) to apply to this method.
You can specify For more information about the |
Examples
The following examples demonstrate how to drop a collection.
import {
DataAPIClient,
UsernamePasswordTokenProvider,
} from "@datastax/astra-db-ts";
// Get a database
const client = new DataAPIClient({ environment: "hcd" });
const database = client.db("API_ENDPOINT", {
token: new UsernamePasswordTokenProvider("USERNAME", "PASSWORD"),
keyspace: "KEYSPACE_NAME",
});
// Drop a collection
(async function () {
await database.dropCollection("COLLECTION_NAME");
})();Client reference
For more information, see the client reference.
