DROP PAYLOAD TRANSFORM

Permanently deletes a payload transform definition. The target table and any DLQ table are not affected.

Syntax

DROP PAYLOAD TRANSFORM [ IF EXISTS ] transformName

Parameters

ParameterDescription
transformNameName of the payload transform to drop
IF EXISTSSuppress error if the transform does not exist

Examples

Drop a payload transform
DROP PAYLOAD TRANSFORM binance_depth;
Drop only if exists (no error if missing)
DROP PAYLOAD TRANSFORM IF EXISTS binance_depth;

Behavior

AspectDescription
Target tableNot affected - existing data remains
DLQ tableNot affected - existing error rows remain
Active requestsIn-flight /ingest requests may still complete

Permissions

Enterprise

In QuestDB Enterprise deployments with RBAC enabled, the user must hold the DROP PAYLOAD TRANSFORM grant.

GRANT DROP PAYLOAD TRANSFORM TO ingest_admin;