Delen via

GEADRESSEERDE MAKEN

  • Artikel

Van toepassing op:vinkje als ja aan Alleen Databricks SQL vinkje als ja aan Databricks Runtime 10.4 LTS en hoger vinkje als ja aan dan Unity Catalog

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 ]
    [ SET 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 id 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.

    Als u deze optie gebruikt, wordt het verificatietype DATABRICKSingesteld op , anders wordt het verificatietype ingesteld op TOKEN, waarbij u een activeringskoppeling naar de ontvanger moet verzenden om toegang te krijgen tot de gedeelde datum.

  • commentaar

    Een optionele STRING letterlijke. De beschrijving voor de geadresseerde.

  • SET 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.

    Eigenschappen van geadresseerden kunnen worden gebruikt om verschillende tabelpartities met verschillende geadresseerden te delen met hetzelfde shareobject. Zie Eigenschappen van geadresseerden beheren en Eigenschappen van geadresseerden gebruiken om partitiefiltering uit 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