DROP RECIPIENT

Preview

Delta Sharing is in Public Preview. To participate in the preview, you must enable the External Data Sharing feature group in the Databricks Account Console. See Enable the External Data Sharing feature group for your account.

Delta Sharing is subject to applicable terms. Enabling the External Data Sharing feature group represents acceptance of those terms.

Drops a recipient. An exception is thrown if the recipient does not exist in the system.

Since: Databricks Runtime 10.3

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;