CREATE RECIPIENT

Dotyczy:zaznaczono jako tak Databricks SQL zaznaczono jako tak Databricks Runtime 10.4 LTS i nowsze zaznaczono jako tak tylko katalog Unity

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

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

Permissions

Aby utworzyć adresata, musisz być administratorem magazynu metadanych lub mieć CREATE RECIPIENT uprawnienia do magazynu metadanych. Po utworzeniu tylko właściciel odbiorcy może nim zarządzać (zobacz ALTER RECIPIENT i DROP RECIPIENT).

Składnia

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

Parametry

  • 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

    Opcjonalny globalny unikatowy identyfikator magazynu metadanych wykazu aparatu Unity należący do adresata openSharing, któremu chcesz udostępniać dane. Jest to dane wyjściowe funkcji current_metastore wykonywanej przez adresata openSharing.

    Za pomocą tej opcji ustawia typ uwierzytelniania na DATABRICKS, w przeciwnym razie typ uwierzytelniania jest ustawiony na TOKEN, wymagając wysłania linku aktywacji do adresata w celu uzyskania dostępu do daty udostępnionej.

  • 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 adresata mogą służyć do udostępniania różnych partycji tabeli różnym adresatom przy użyciu tego samego obiektu udostępniania. Zobacz Zarządzanie właściwościami adresatów i Używanie właściwości adresata do filtrowania partycji.

    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
  • Last updated on