Udostępnij za pośrednictwem

CREATE RECIPIENT

  • Artykuł

Dotyczy:zaznaczone jako tak Databricks SQL zaznaczone jako tak Databricks Runtime 10.4 LTS i nowszych zaznaczone jako tak tylko Unity Catalog

Tworzy adresata udostępniania różnicowego o określonej nazwie i generuje link aktywacji. Jeśli adresat o tej samej nazwie już istnieje, zgłaszany jest wyjątek.

Aby utworzyć adresata i zarządzać nim, musisz być administratorem magazynu metadanych lub mieć CREATE RECIPIENT uprawnienia do magazynu metadanych.

Użyj DESCRIBE RECIPIENT, aby pobrać link aktywacji.

Składnia

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

Parameters

  • JEŚLI NIE ISTNIEJE

    Tworzy adresata o podanej nazwie, jeśli nie istnieje. Jeśli adresat o tej samej nazwie już istnieje, nic się nie stanie.

  • recipient_name

    Nazwa adresata do utworzenia.

  • sharing_identifier

    Opcjonalna globalna unikatowa identifier magazynu metadanych Unity Catalog należąca do odbiorcy Delta Sharing, któremu chcesz udostępniać dane. Jest to dane wyjściowe funkcji current_metastore wykonywanej przez adresata usługi Delta Sharing.

    Użycie tej opcji ustawia typ uwierzytelniania na DATABRICKS, w przeciwnym razie typ uwierzytelniania jest ustawiany na set do TOKEN, co wymaga wysłania linku aktywacyjnego do adresata, aby uzyskali dostęp do udostępnionych danych.

  • komentarz

    Opcjonalny STRING literał. Opis odbiorcy.

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

    Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 12.2 LTS i nowsze.

    Ustawia właściwość niestandardową dla adresata.

    Właściwości odbiornika mogą służyć do udostępniania różnych partycji table z różnymi recipients przy użyciu tego samego obiektu współdzielenia. Zobacz Zarządzanie właściwościami adresata i Używanie właściwości adresata do partition filtrowania.

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

property_value
{ string_literal }

Przykłady

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