Skip to main content

RECIPIENTS

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

INFORMATION_SCHEMA.RECIPIENTS describes recipients.

Information is displayed only for recipients the user has permission to interact with.

This is an extension to the SQL Standard Information Schema.

Definition

The RECIPIENTS relation contains the following columns:

NameData typeNullableDescription
RECIPIENT_NAMESTRINGNoName of the recipient.
RECIPIENT_IDSTRINGNoA GUID of the recipient.
RECIPIENT_OWNERSTRINGNoOwner of the recipient.
AUTHENTICATION_TYPESTRINGNoAuthentication type used with the recipient.
COMMENTSTRINGYesAn optional comment that describes the recipient.
CLOUDSTRINGYesCloud vendor of the recipient (Databricks-to-Databricks only).
REGIONSTRINGYesRegion of the recipient (Databricks-to-Databricks only).
DATA_RECIPIENT_GLOBAL_METASTORE_IDSTRINGYesGlobally unique metastore ID of the recipient (Databricks-to-Databricks only).
CREATEDTIMESTAMPNoTimestamp when the recipient was created.
CREATED_BYSTRINGNoPrincipal who created the recipient.
LAST_ALTEREDTIMESTAMPNoTimestamp when the recipient was last altered in any way.
LAST_ALTERED_BYSTRINGNoPrincipal who last altered the recipient.

Constraints

The following constraints apply to the RECIPIENTS relation:

ClassNameColumn ListDescription
Primary keyRECIPIENTS_PKRECIPIENT_NAMEUnique identifier for the recipient.
Unique keyRECIPIENTS_IDRECIPIENT_IDGUID for the recipient.

Examples

SQL
> SELECT recipient_owner
FROM information_schema.recipients