Dela via

CREATE RECIPIENT

gäller för:kontrollera markerat ja Databricks SQL kontrollera markerat ja Databricks Runtime 10.4 LTS och senare kontrollera markerat ja Endast 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 [, ...] ) ]

Parametrar

  • OM INTE EXISTERAR

    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

    En valfri globalt unik identifierare för ett Unity Catalog-metaarkiv som ägs av den Delta Sharing-mottagare som du vill 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 inställd på 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 av 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.

    Mottagaregenskaper kan användas för att dela olika tabellpartitioner med olika mottagare med samma delningsobjekt. Se Hantera mottagaregenskaper och Använd mottagaregenskaper för att utföra partitionsfiltrering.

    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