DROP VERTEX TABLE

Enterprise command reference.

Command Snapshot

Field	Value
Category	Platform Extensions
Mutates Data	Yes/Depends
Scope	Cluster / Object
Privilege Model	Requires administrative or feature-specific governance/cluster privileges.

Purpose

Defines, changes, or removes schema and metadata objects.

Syntax

DROP VERTEX TABLE [IF EXISTS] schema.table

Operational Notes

• Use schema-qualified identifiers in automation and automation pipelines.
• Validate behavior in staging for cluster-impacting or governance-impacting changes.
• Confirm runtime effects through system tables and metrics before and after execution.

When to Use

• Use for graph, memory, governance, and licensing lifecycle management.
• Use when feature-specific metadata and policy controls are required.

When Not to Use

• Avoid enabling strict enforcement modes before validation and staged verification.

Common Errors and Troubleshooting

Symptom	Likely Cause	Action
Permission denied / unauthorized	Missing privilege on object or cluster scope	Re-run with required grants or elevated admin role.
Analysis/parse error	Syntax variant or object shape mismatch	Compare with canonical syntax and object definition.
Runtime failure under load	Resource limits, breaker pressure, or node state transitions	Check sys.jobs, sys.operations, sys.checks, and retry after mitigation.

Cross-References

• SQL Command Catalog
• SQL Commands Index
• SQL Reference Overview

Detailed Reference

Removes graph vertex registration for a table.

SQL Statement

DROP VERTEX TABLE [IF EXISTS] schema.table

Parameters

• schema.table: Registered vertex table.

Privileges

Requires DDL privilege on graph metadata.

Example

DROP VERTEX TABLE IF EXISTS doc.users;

Notes

• This removes graph metadata binding, not the underlying relational table.
• Use regular DROP TABLE separately if you also need to delete table storage.

Related

• DROP TABLE
• CREATE VERTEX TABLE