Version: 1.0 (Latest)

defradb_client_collection_delete

defradb client collection delete

Delete collections

Synopsis

Delete one or more collections by name.

A single name, or a comma-separated list of names, may be provided. All named collections are removed atomically in a single operation. This can be used to delete collections that reference each other via relations, since deleting them one at a time would leave a dangling reference and be rolled back.

By default, every version of each named collection is deleted (active head and all earlier versions). Pass --active-only to delete only the latest (head) version and keep earlier versions intact.

The named collections must not contain any documents. Delete all documents first before deleting the collection.

defradb client collection delete --collection-name <collectionNames> [flags]

Examples

delete every version of a single collection:  
  defradb client collection delete --collection-name Users

delete every version of multiple collections in one call (this can be used to delete collections that reference each other via relations):  
  defradb client collection delete --collection-name Users,Books

delete only the active head version, keeping earlier versions:  
  defradb client collection delete --active-only --collection-name Users

Options

      --active-only               Delete only the active head version of each named collection (default deletes every version)
      --collection-name strings   Collection name
  -h, --help                      help for delete

Options inherited from parent commands

      --audience string             Audience to set on minted auth tokens. Defaults to the host of --url
  -i, --identity string             Hex formatted private key used to authenticate with ACP
      --log-format string           Log format to use. Options are text or json (default "text")
      --log-level string            Log level to use. Options are debug, info, error, fatal (default "info")
      --log-output string           Log output path. Options are stderr or stdout. (default "stderr")
      --log-overrides string        Logger config overrides. Format <name>,<key>=<val>,...;<name>,...
      --log-source                  Include source location in logs
      --log-stacktrace              Include stacktrace in error and fatal logs
      --no-log-color                Disable colored log output
      --rootdir string              Directory for persistent data (default: $HOME/.defradb)
      --source-hub-address string   The SourceHub address authorized by the client to make SourceHub transactions on behalf of the actor
      --tx uint                     Transaction ID
      --url string                  URL of HTTP endpoint to listen on or connect to (default "127.0.0.1:9181")