Sdílet prostřednictvím

VYTVOŘIT PŘÍJEMCE

  • Článek

Platí pro: zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 10.4 LTS a vyšší zaškrtnutí označeného ano pouze katalog Unity

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í funkce 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 [, ...] ) ]

Parametry

  • 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ý identifikátor metastoru katalogu Unity vlastněného příjemcem rozdílového 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 DATABRICKShodnotu , jinak je typ ověřování nastavený na TOKEN, který vyžaduje, abyste příjemci odeslali 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 ke sdílení různých oddílů tabulky s různými příjemci pomocí stejného objektu sdílené složky. Viz Správa vlastností příjemce a Použití vlastností příjemce k filtrování oddílů.

    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