Dela via

CREATE RECIPIENT

  • Artikel

gäller för:kryssmarkerad ja Databricks SQL kryssmarkerad ja Databricks Runtime 10.4 LTS och senare kryssmarkerad ja Unity Catalog

Skapar en deltadelningsmottagare med det angivna namnet och genererar en aktiveringslänk. Om det redan finns en mottagare med samma namn genereras ett undantag.

Om du vill skapa och hantera en mottagare måste du vara metaarkivadministratör eller ha CREATE RECIPIENT behörighet för metaarkivet.

Använd DESCRIBE RECIPIENT för att hämta aktiveringslänken.

Syntax

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

Parameters

  • OM INTE FINNS

    Skapar en mottagare med det angivna namnet om den inte finns. Om det redan finns en mottagare med samma namn händer ingenting.

  • recipient_name

    Namnet på mottagaren som ska skapas.

  • sharing_identifier

    Ett valfritt globalt unikt identifier av ett metaarkiv för Unity Catalog som ägs av mottagaren av Delta Sharing som du skulle vilja dela data med. Det här är utdata från den current_metastore funktion som körs av deltadelningsmottagaren.

    Med det här alternativet anges autentiseringstypen till DATABRICKS, annars är autentiseringstypen set till TOKEN, vilket kräver att du skickar en aktiveringslänk till mottagaren för att de ska få åtkomst till delat datum.

  • kommentar

    En valfri STRING literal. Beskrivningen för mottagaren.

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

    Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 12.2 LTS och senare.

    Anger en anpassad egenskap för en mottagare.

    Egenskaper för mottagare kan användas för att dela olika table-partitioner med olika recipients med samma delningsobjekt. Se Hantera mottagaregenskaper och Använd mottagaregenskaper för att göra partition filtrering.

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

property_value
{ string_literal }

Exempel

-- 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