DROP RECIPIENT

  • Article

Applies to: check marked yes Databricks SQL check marked yes Databricks Runtime 10.4 LTS and above check marked yes Unity Catalog only

Drops a recipient. An exception is thrown if the recipient does not exist in the system. To drop a recipient you must be its owner.

Syntax

DROP RECIPIENT [ IF EXISTS ] recipient_name

Parameters

  • IF EXISTS

    If specified, no exception is thrown when the recipient does not exist.

  • recipient_name

    The name of an existing recipient in the system. If the name does not exist, an exception is thrown.

Examples

-- Create `other_corp` recipient
> CREATE RECIPIENT other_corp COMMENT 'OtherCorp.com';

-- Retrieve the activation link
> DESCRIBE RECIPIENT other_corp;
  name       created_at                   created_by                 comment       activation_link   active_token_id                      active_token_expiration_time rotated_token_id rotated_token_expiration_time
  ---------- ---------------------------- -------------------------- ------------- ----------------- ------------------------------------ ---------------------------- ---------------- -----------------------------
  other_corp 2022-01-01T00:00:00.000+0000 alwaysworks@databricks.com OtherCorp.com https://send/this 0160c81f-5262-40bb-9b03-3ee12e6d98d7 9999-12-31T23:59:59.999+0000 NULL              NULL

-- Drop the recipient
> DROP RECIPIENT other_corp;

-- Drop the recipient using IF EXISTS.
> DROP RECIPIENT IF EXISTS other_corp;