Share via

SET RECIPIENT

  • Article

Applies to: check marked yes Databricks SQL check marked yes Databricks Runtime 15.1 and later

Sets the CURRENT_RECIPIENT to the specified recipient in the current session to allow the provider to mock CURRENT_RECIPIENT properties. This enables providers to query views that contain the CURRENT_RECIPIENT function.

Syntax

SET RECIPIENT recipient_name

Parameters

  • recipient_name

    The name of the recipient to set as the current recipient.

Examples

— Creates new recipient
> CREATE RECIPIENT nasdaq PROPERTIES (‘country’ = ‘US’);

> CREATE TABLE my_table (country STRING, name STRING);
> INSERT INTO my_table VALUES (‘US’, ‘John’), (‘UK’, ‘Mary’);

> CREATE VIEW my_view AS
    SELECT * FROM my_table
    WHERE country = CURRENT_RECIPIENT('country');

— Sets current recipient
> SET RECIPIENT nasdaq;

> SELECT * FROM my_view;
  US         John