Sdílet prostřednictvím

CREATE RECIPIENT

  • Článek

platí pro:zaškrtněteDatabricks SQL zaškrtněte políčko Ano Databricks Runtime 10.4 LTS a vyšší zaškrtněte Unity jenom Catalog

Vytvoří příjemce rozdílového sdílení se zadaným jménem a vygeneruje aktivační odkaz. Pokud již existuje příjemce se stejným názvem, vyvolá se výjimka.

Pokud chcete vytvořit a spravovat příjemce, musíte být správcem metastoru nebo mít CREATE RECIPIENT oprávnění k metastoru.

Pomocí DESCRIBE RECIPIENT načtěte aktivační odkaz.

Syntaxe

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

Parameters

  • POKUD NEEXISTUJE

    Vytvoří příjemce se zadaným jménem, pokud neexistuje. Pokud už příjemce se stejným jménem existuje, nic se nestane.

  • recipient_name

    Jméno příjemce, který se má vytvořit.

  • sharing_identifier

    Volitelný globální jedinečný identifier metastoru Unity Catalog, který vlastní příjemce Delta sdílení, se kterým chcete sdílet data. Toto je výstup funkce current_metastore spuštěné příjemcem rozdílového sdílení.

    Pomocí této možnosti nastavíte typ ověřování na DATABRICKS, jinak je typ ověřování set na TOKEN, který vyžaduje, abyste příjemci poslali aktivační odkaz, aby získal přístup ke sdílenému datu.

  • komentář

    Volitelný STRING literál. Popis příjemce.

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

    Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 12.2 LTS a vyšší.

    Nastaví vlastní vlastnost příjemce.

    Vlastnosti příjemce lze použít pro sdílení různých oddílů table s různými recipients pomocí stejného sdíleného objektu. Viz Správa vlastností příjemce a Použití vlastností příjemce k filtrovánípartition .

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

property_value
{ string_literal }

Příklady

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