CREATE RECIPIENT

  • Artikel

Gilt für:Häkchen ja Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime 10.4 LTS und höher Häkchen gesetzt ja nur für Unity Catalog

Erstellt einen Delta Sharing-Empfänger mit dem angegebenen Namen und generiert einen Aktivierungslink. Wenn bereits ein Empfänger mit demselben Namen vorhanden ist, wird eine Ausnahme ausgelöst.

Zum Erstellen und Verwalten eines Empfängers müssen Sie Metastore-Administrator sein oder über die CREATE RECIPIENT-Berechtigung für den Metastore verfügen.

Verwenden Sie DESCRIBE RECIPIENT, um den Aktivierungslink abzurufen.

Syntax

CREATE RECIPIENT [ IF NOT EXISTS ] recipient_name
    [ USING ID sharing_identifier ]
    [ COMMENT comment ]
    [ SET PROPERTIES ( property_key [ = ] property_value [, ...] ) ]

Parameter

  • IF NOT EXISTS

    Erstellt einen Empfänger mit dem angegebenen Namen, wenn er nicht vorhanden ist. Wenn bereits ein Empfänger mit demselben Namen vorhanden ist, geschieht nichts.

  • recipient_name

    Der Name des zu erstellenden Empfängers.

  • sharing_identifier

    Ein optionaler globaler eindeutiger Bezeichner eines Unity Catalog-Metastores, der dem Delta Sharing-Empfänger gehört, mit dem Sie Daten gemeinsam nutzen möchten. Dies ist die Ausgabe der current_metastore-Funktion, die vom Delta Sharing-Empfänger ausgeführt wird.

    Mit dieser Option wird der Authentifizierungstyp auf DATABRICKS festgelegt, andernfalls ist der Authentifizierungstyp festgelegt auf TOKEN, sodass Sie einen Aktivierungslink an den Empfänger senden müssen, damit er auf freigegebene Daten zugreifen kann.

  • comment

    Ein optionales STRING-Literal. Die Beschreibung für den Empfänger.

  • SET PROPERTIES ( property_key [ = ] property_value [, ...] )

    Gilt für:Häkchen ja Databricks SQL Häkchen Databricks Runtime 12.2 LTS und höher

    Legt eine benutzerdefinierte Eigenschaft für einen Empfänger fest.

    Empfängereigenschaften können verwendet werden, um verschiedene Tabellenpartitionen für verschiedene Empfänger mit demselben Freigabeobjekt freizugeben. Weitere Informationen finden Sie unter Verwalten von Empfängereigenschaften und Verwenden von Empfängereigenschaften zum Durchführen der Partitionsfilterung.

    property_key
{ identifier [. ...] | string_literal }

property_value
{ string_literal }

Beispiele

-- A recipient created for Databricks to Databricks sharing
> CREATE RECIPIENT other_databricks_org USING ID 'azure:westus:f12dcb34-5678-9d4c-1234-c5ac67f8b90a';
> DESCRIBE RECIPIENT other_databricks_org;
 info_name           info_value
 -------------       ----------
 recipient_name      other_databricks_org
 authentication_type DATABRICKS
 owner               alwaysworks@databricks.com
 created_by          alwaysworks@databricks.com
 create_at           2022-01-01T00:00:00.000+0000
 updated_by          alwayswork@databricks.com
 updated_at          2022-01-05T12:00:00.000+0000
 comment
 cloud               azure
 region              westus
 metastore_id        f12dcb34-5678-9d4c-1234-c5ac67f8b90a

-- A recipient created for sharing outside of Databricks
> CREATE RECIPIENT other_org;
> DESCRIBE RECIPIENT other_org;
 info_name               info_value
 ----------------------- ----------
 recipient_name          other_org
 authentication_type     TOKEN
 owner                   alwaysworks@databricks.com
 created_by              alwaysworks@databricks.com
 create_at               2022-01-01T00:00:00.000+0000
 updated_by              alwayswork@databricks.com
 updated_at              2022-01-05T12:00:00.000+0000
 comment                 This is Other Corp
 active_token_id         0160c81f-5262-40bb-9b03-3ee12e6d98d7
 active_token_expiration 2023-01-05T12:00:00.000+0000
 activation_link         https://send/this