Delen via

CREATE RECIPIENT

  • Artikel

Van toepassing op:gemarkeerd met ja Databricks SQL gemarkeerd met ja Databricks Runtime 10.4 LTS en hoger gemarkeerd met ja Unity Catalog only

Hiermee maakt u een ontvanger voor Delen van Delta met de opgegeven naam en genereert u een activeringskoppeling. Als er al een geadresseerde met dezelfde naam bestaat, wordt er een uitzondering gegenereerd.

Als u een ontvanger wilt maken en beheren, moet u een metastore-beheerder zijn of de CREATE RECIPIENT bevoegdheid hebben voor de metastore.

Gebruik DESCRIBE RECIPIENT om de activeringskoppeling op te halen.

Syntaxis

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

Parameters

  • ALS DEZE NIET BESTAAT

    Hiermee maakt u een geadresseerde met de opgegeven naam als deze niet bestaat. Als er al een geadresseerde met dezelfde naam bestaat, gebeurt er niets.

  • recipient_name

    De naam van de geadresseerde die moet worden gemaakt.

  • sharing_identifier

    Een optionele globale unieke identifier van een Unity-Catalog metastore die eigendom is van de ontvanger van Delta Sharing met wie u gegevens wilt delen. Dit is de uitvoer van de current_metastore-functie die wordt uitgevoerd door de ontvanger van Delta Sharing.

    Met deze optie stelt u het verificatietype in op DATABRICKS, anders wordt het verificatietype set op TOKEN, waardoor u een activeringskoppeling naar de ontvanger moet verzenden om toegang te krijgen tot gedeelde datum.

  • commentaar

    Een optionele STRING letterlijke. De beschrijving voor de geadresseerde.

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

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 12.2 LTS en hoger.

    Hiermee stelt u een aangepaste eigenschap in op een geadresseerde.

    De eigenschappen van geadresseerden kunnen worden gebruikt om verschillende table-partities met verschillende recipients te delen via hetzelfde deelobject. Zie Eigenschappen van geadresseerden beheren en Eigenschappen van geadresseerden gebruiken om partition filterenuit te voeren.

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

property_value
{ string_literal }

Voorbeelden

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